Las páginas sin traducir se abren en inglés y se indican como inglés.
Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.
Operaciones de procedure
Los campos exactos que recibe y devuelve cada operación procedure.*.
Cada op es POST /v1/<op> sobre HTTP y la herramienta MCP loom_<op>. Los campos de identidad (org, namespace, agent, user_id, session_id) se completan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token en un servidor de un solo usuario, se completa con la org de la instalación en todas las ops excepto code.* y tracker.* (que conservan la de su plano), y en algunas ops también su espacio de nombres y su agente; consulta identidades y espacios de nombres. El índice de operaciones explica el rol, el tipo y el listado all de MCP. Los campos de entrada desconocidos se atienden y se nombran en ignored_args.
procedure.add
Registra una memoria procedimental: una receta de tipo "cómo hacer X" con campos estructurados (name, situation, steps).
POST /v1/procedure.add · MCP loom_procedure_add · rol writer · escritura
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | El espacio de nombres que la op lee o escribe. |
agent |
str |
'-' |
El agente que escribe o lee; '-' o '*' significa cualquier agente cuando la op lo permite. |
user_id |
str |
'-' |
El usuario final al que pertenece la fila; '-' si no hay ninguno. |
session_id |
str |
'-' |
La sesión o conversación a la que pertenece la fila; '-' si no hay ninguna. |
name |
str |
obligatorio | Nombre del procedimiento; la clave de la memoria es procedure_<slug of name>, por lo que el mismo nombre la reescribe. |
situation |
str |
obligatorio | Cuándo se aplica el procedimiento (su precondición); este texto determina procedure.match. |
steps |
list[str] |
obligatorio | Al menos dos: un único paso es una lección, no un procedimiento (el minero aplica la misma regla). |
tags |
list[str] |
(calculado) | Etiquetas del llamador almacenadas en el procedimiento; la fila también recibe la etiqueta procedure. |
metadata |
dict[str, Any] |
(calculado) | Metadatos estructurados opcionales (precondiciones como clave-valor, salidas esperadas, ...). |
graph |
dict[str, Any] \| None |
None |
Grafo ejecutable opcional (nodos = pasos / memoria / consolidación / decisión, aristas = dep / dataflow / branch). |
| Campo de salida | Tipo | Significado |
|---|---|---|
memory_key |
str |
Clave de la fila del procedimiento (procedure_<slug>). |
memory_id |
str |
Id de la versión de memoria escrita. |
version |
int |
Número de versión de la fila escrita. |
procedure.evolve
Consolida las trazas de ejecución acumuladas de un procedimiento en un grafo mejorado: clasifica el camino probado según los recorridos EXITOSOS, marca como callejones sin salida los pasos que ninguna ejecución usó, y marca los pasos y transiciones que se encuentran…
POST /v1/procedure.evolve · MCP loom_procedure_evolve · rol writer · escritura · no figura en el toolset all de MCP
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | El espacio de nombres que la op lee o escribe. |
agent |
str |
'-' |
El agente que escribe o lee; '-' o '*' significa cualquier agente donde la op lo permita. |
user_id |
str |
'-' |
El usuario final al que pertenece la fila; '-' si ninguno. |
session_id |
str |
'-' |
La sesión o conversación a la que pertenece la fila; '-' si ninguna. |
memory_key |
str |
obligatorio | Clave del procedimiento que se va a evolucionar (procedure_<slug>). |
min_runs |
int |
3 |
Número mínimo de ejecuciones incorporadas antes de que la poda actúe sobre la evidencia. |
gate_mode |
Literal['sprt', 'margin'] |
'sprt' |
Puerta de aceptación para una revisión pendiente. |
gate_min_runs |
int |
3 |
Ejecuciones necesarias sobre la revisión en prueba antes de cualquier veredicto. |
gate_margin |
float |
0.05 |
modo margin: la caída de la tasa de éxito que provoca una reversión. |
gate_min_drop |
float |
0.15 |
modo sprt: la caída por la que vale la pena revertir, las tasas de error, y el número de ejecuciones a partir del cual decide la estimación puntual. |
gate_alpha |
float |
0.05 |
modo sprt: tasa de error de falsa reversión; un valor menor requiere más evidencia antes de revertir. |
gate_beta |
float |
0.2 |
modo sprt: tasa de error de caída no detectada; un valor menor requiere más evidencia antes de aceptar. |
gate_max_runs |
int |
50 |
modo sprt: ejecuciones sobre la revisión a partir de las cuales decide la estimación puntual. |
strike_limit |
int \| None |
None |
Ejecuciones fallidas consecutivas que ponen el procedimiento en cuarentena; None = LOOM_PROCEDURE_STRIKE_LIMIT (3), 0 = nunca. |
gate_cost_tolerance |
float |
0.25 |
Desempate por costo en una revisión aceptada: se revierte cuando sus ejecuciones exitosas cuestan más que esta fracción por encima de las de la revisión anterior (el primero entre duración, pasos y tokens que ambas informen); ambos lados necesitan gate_cost_min_samples éxitos con costo… |
gate_cost_min_samples |
int \| None |
None |
Ejecuciones exitosas con costo que necesita cada lado para la comprobación de costo; None = gate_min_runs. |
| Campo de salida | Tipo | Significado |
|---|---|---|
memory_key |
str |
Clave del procedimiento evolucionado. |
version |
int |
Versión de la fila del procedimiento que escribió esta llamada. |
revision |
int |
La revisión de topología del procedimiento tras esta llamada (una reversión abre una nueva). |
changed |
bool |
True cuando esta llamada cambió las marcas del grafo o el estado de cuarentena. |
template |
bool |
True cuando el procedimiento es ahora una plantilla reutilizable (estable, casi siempre exitoso y no en cuarentena). |
folded_runs |
int |
Filas del registro incorporadas al grafo por esta llamada. |
gate |
Literal['none', 'undecided', 'accept', 'revert'] |
Puerta de aceptación sobre una revisión pendiente: none (nada pendiente), undecided (aún no hay suficientes ejecuciones), accept, revert. |
gate_mode |
str |
El modo de puerta utilizado (sprt o margin); "" cuando no había ninguna revisión pendiente. |
gate_llr |
float |
sprt: razón de log-verosimilitud acumulada (un valor positivo favorece "la revisión empeoró las cosas"); el veredicto se emite cuando cruza un límite. |
gate_before |
dict[str, int] |
{total, ok} de la revisión anterior |
gate_after |
dict[str, int] |
{total, ok} de la revisión en prueba |
gate_cost_before |
dict[str, float] |
Costo mediano de las ejecuciones exitosas por lado, y por qué una revisión que pasó la puerta de éxito se revirtió de todos modos ("cost"). |
gate_cost_after |
dict[str, float] |
Costo mediano de las ejecuciones exitosas sobre la revisión en prueba. |
gate_reason |
str |
success o cost en una reversión; "" en otro caso. |
dead_end_steps |
list[str] |
Textos de pasos que ninguna ejecución incorporada recorrió (degradados desde los steps lineales). |
fail_prone_steps |
list[str] |
Contraste de resultados: pasos / transiciones desproporcionadamente presentes en ejecuciones fallidas (proporción de fallos >= tasa base de fallos del procedimiento + margen, con suficientes ejecuciones). |
fail_prone_transitions |
list[str] |
Transiciones desproporcionadamente presentes en ejecuciones fallidas, como ids de nodo src -> dst. |
run_stats |
dict[str, int] |
El {total, ok} incorporado del procedimiento tras esta llamada. |
strikes |
int |
Ejecuciones fallidas consecutivas al final del registro de trazas, y si el procedimiento está eliminado por exceder el límite. |
quarantined |
bool |
True cuando el procedimiento está eliminado por exceder el límite (véase strike_limit). |
retention |
dict[str, float] |
Retención de éxito sobre el registro de trazas: pares de ejecuciones consecutivas cuya primera tuvo éxito, cuántas de las segundas lo tuvieron, y la tasa. |
procedure.fork
Copia un procedimiento desde un espacio de nombres que el llamador puede leer al espacio de nombres de la solicitud, con su evidencia reiniciada.
POST /v1/procedure.fork · MCP loom_procedure_fork · rol writer · escritura · auditada · no figura en el toolset all de MCP
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | destino (el espacio de nombres de la solicitud; la operación exige WRITER) |
agent |
str |
'-' |
El agente que escribe o lee; '-' o '*' significa cualquier agente donde la operación lo permita. |
user_id |
str |
'-' |
El usuario final al que pertenece la fila; '-' si no hay ninguno. |
session_id |
str |
'-' |
La sesión o conversación a la que pertenece la fila; '-' si no hay ninguna. |
from_namespace |
str |
obligatorio | Espacio de nombres desde el que se copia; el llamador necesita acceso de lectura a él. |
from_org |
str |
'' |
por defecto es org |
memory_key |
str |
obligatorio | Clave del procedimiento que se copia en from_namespace. |
new_name |
str |
'' |
Cambia el nombre al copiarlo (la clave de la memoria se deriva del nombre). |
reason |
str |
'' |
Motivo por el que se adoptó el procedimiento; se conserva en forked_from. |
| Campo de salida | Tipo | Significado |
|---|---|---|
memory_key |
str |
Clave del nuevo procedimiento en el espacio de nombres de destino. |
version |
int |
Versión de la fila escrita. |
name |
str |
Nombre del nuevo procedimiento (new_name o el del origen). |
steps |
list[str] |
Los pasos copiados. |
forked_from |
dict[str, Any] |
Linaje: org de origen, espacio de nombres, clave, revisión, digest, indicador de plantilla, estadísticas de ejecución, quién lo bifurcó, por qué y cuándo. |
procedure.list
Enumera los procedimientos registrados en el espacio de nombres (opcionalmente filtrados por prefijo de memory_key o por etiquetas).
POST /v1/procedure.list · MCP loom_procedure_list · rol viewer · lectura · no aparece en el conjunto de herramientas MCP all
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | El espacio de nombres que la op lee o escribe. |
agent |
str |
'*' |
El agente que escribe o lee; '-' o '*' significa cualquier agente cuando la op lo permite. |
user_id |
str |
'-' |
El usuario final al que pertenece la fila; '-' si no hay ninguno. |
session_id |
str |
'-' |
La sesión o conversación a la que pertenece la fila; '-' si no hay ninguna. |
prefix |
str |
'' |
Solo los procedimientos cuya clave empieza por procedure_ + este valor; "" lista todos. |
tags |
list[str] |
(calculado) | Solo los procedimientos que tienen al menos una de estas etiquetas; vacío = sin filtro de etiquetas. |
limit |
int |
50 |
Se leen como máximo este número de filas de procedimientos (el servidor lo limita a 500). |
| Campo de salida | Tipo | Significado |
|---|---|---|
procedures |
list[_ProcedureSummary] |
Los procedimientos del espacio de nombres (nombre, situación, etiquetas, clave, hora de creación). |
procedure.locate
¿Dónde estoy en este procedimiento y qué viene a continuación?
POST /v1/procedure.locate · MCP loom_procedure_locate · rol viewer · lectura · no figura en el conjunto de herramientas MCP all
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | El espacio de nombres que la op lee o escribe. |
agent |
str |
'*' |
El agente que escribe o lee; '-' o '*' significa cualquier agente cuando la op lo permite. |
user_id |
str |
'-' |
El usuario final al que pertenece la fila; '-' si no hay ninguno. |
session_id |
str |
'-' |
La sesión o conversación a la que pertenece la fila; '-' si no hay ninguna. |
memory_key |
str |
obligatorio | Clave del procedimiento que el agente está siguiendo (procedure_<slug>). |
at |
str |
'' |
Dónde está el agente: un id de nodo o el nombre de la herramienta de su llamada más reciente. |
recent_path |
list[str] |
(calculado) | Los ids de nodo o nombres de herramienta recientes del agente en esta ejecución, del más antiguo al más reciente; alimenta revisits y looping. |
hops |
int |
2 |
Cuántos pasos por delante se muestran. 2 basta para la siguiente decisión; más implica más tokens. |
include_notes |
bool |
True |
Adjunta notas de fallo recientes del registro para las transiciones por delante. |
max_notes |
int |
5 |
Como máximo esta cantidad de notas de fallo; 0 no adjunta ninguna. |
| Campo de salida | Tipo | Significado |
|---|---|---|
memory_key |
str |
Clave del procedimiento leído. |
name |
str |
El nombre del procedimiento. |
status |
Literal['template', 'exercised', 'authored', 'candidate', 'quarantined'] |
template, exercised, authored, candidate o quarantined. |
matched |
bool |
True cuando at (o el último elemento de recent_path) nombra un nodo del grafo. |
active |
dict[str, Any] \| None |
El nodo en el que está el agente; None cuando no hay coincidencia. |
hops |
list[list[dict[str, Any]]] |
hops[0] = un paso por delante, hops[1] = dos por delante, ... (se omiten los callejones sin salida). |
entry_nodes |
list[str] |
Cuando no hay coincidencia: ids de nodo sin ninguna arista entrante, donde empieza el procedimiento. |
dominant_next |
list[str] |
Ids de los siguientes nodos a lo largo del camino probado desde el nodo activo. |
revisits |
dict[str, int] |
Ventana de trayectoria: visitas por nodo en esta ejecución, si el nodo activo se está revisitando y las salidas no tomadas desde él. |
looping |
bool |
True cuando el nodo activo ya aparece antes en recent_path. |
exits |
list[str] |
Cuando hay bucle: ids de nodo alcanzables desde el nodo activo que aún no se han visitado en esta ejecución; vacío en caso contrario. |
failure_notes |
list[dict[str, Any]] |
Notas que los agentes dejaron en ejecuciones fallidas que terminaron en una transición por delante. |
rendered |
str |
Texto determinista de todo lo anterior, listo para incluir en un prompt. |
run_stats |
dict[str, int] |
El {total, ok} consolidado del procedimiento. |
for_agent |
dict[str, int] |
{total, ok} del agente que llama; vacío para *, - o si no hay ejecuciones. |
procedure.match
Encuentra procedimientos cuyo campo situation es semánticamente el más cercano a la situación descrita por quien llama.
POST /v1/procedure.match · MCP loom_procedure_match · rol viewer · lectura
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | El espacio de nombres que la op lee o escribe. |
agent |
str |
'*' |
fan-out por defecto: procedimientos de cualquier agente dentro del alcance |
user_id |
str |
'-' |
El usuario final al que pertenece la fila; '-' si ninguno. |
session_id |
str |
'-' |
La sesión o conversación a la que pertenece la fila; '-' si ninguna. |
situation |
str |
obligatorio | El estado en el que se encuentra el agente; se compara con la situación almacenada de cada procedimiento. |
top_k |
int |
5 |
Se buscan como máximo este número de candidatos (1–50); los filtros pueden devolver menos. |
tags |
list[str] |
(calculado) | Solo procedimientos que lleven al menos una de estas etiquetas; vacío = sin filtro de etiquetas. |
namespace_scope |
Literal['this', 'all_mine'] |
'all_mine' |
all_mine también busca en los espacios de nombres propios de quien llama (hasta el límite de fan-out); this solo en namespace. |
templates_only |
bool |
False |
Si es true, solo devuelve procedimientos promovidos a plantillas reutilizables (topologías de flujo de trabajo probadas y bien ejercitadas). |
include_candidates |
bool |
True |
Los candidatos son procedimientos que aún no se han ejercitado Y que ningún humano ha redactado. |
include_quarantined |
bool |
False |
Un procedimiento en cuarentena (sus últimas strike_limit ejecuciones fallaron todas) se descarta salvo que se solicite; se devuelve al final, con etiqueta. |
recent_tools |
list[str] |
(calculado) | Las herramientas que el agente ha llamado recientemente en esta tarea. |
tool_boost |
float |
0.2 |
Peso de tool_overlap en el score fusionado; 0 ignora recent_tools. |
utility_weight |
float \| None |
None |
Peso del término de utilidad derivado del registro en la puntuación fusionada: score = similarity + tool_boost*overlap + weight * ((ok+1)/(total+2) - 0.5). |
goal |
str \| None |
None |
El objetivo que persigue el agente, distinto del estado en el que se encuentra. |
| Campo de salida | Tipo | Significado |
|---|---|---|
matches |
list[_ProcedureMatch] |
Procedimientos coincidentes, ordenados por nivel de estado (candidatos y en cuarentena al final) y luego por score. |
matched |
int |
La tasa de aciertos en el registro: cuántos coincidieron, el procedimiento principal y su puntuación (out_matched / out_procedure_key / out_score). |
procedure_key |
str |
Clave de memoria de la mejor coincidencia; "" cuando nada coincidió. |
score |
float |
Puntuación fusionada de la mejor coincidencia; 0 cuando nada coincidió. |
procedure.record_run
Informa de una ejecución de un procedimiento para que loom pueda aprender qué ruta funciona realmente.
POST /v1/procedure.record_run · MCP loom_procedure_record_run · rol writer · escritura · no figura en el conjunto de herramientas MCP all
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | El espacio de nombres que la op lee o escribe. |
agent |
str |
'-' |
El agente que escribe o lee; '-' o '*' significa cualquier agente donde la op lo permita. |
user_id |
str |
'-' |
El usuario final al que pertenece la fila; '-' para ninguno. |
session_id |
str |
'-' |
La sesión o conversación a la que pertenece la fila; '-' para ninguna. |
memory_key |
str |
obligatorio | Clave del procedimiento que se ejecutó (procedure_<slug>). |
path |
list[str] |
(calculado) | Ids de nodo ordenados que el agente visitó realmente en esta ejecución. |
ok |
bool |
True |
Indica si la ejecución tuvo éxito. |
note |
str |
'' |
Nota de texto libre sobre la ejecución (por qué falló, …); procedure.locate muestra las notas de las ejecuciones fallidas. |
ts |
str |
'' |
No se almacena: el registro marca cada ejecución con la hora del servidor. |
steps_taken |
int \| None |
None |
Lo que costó la ejecución. |
duration_ms |
int |
0 |
Cuánto duró la ejecución, en milisegundos; 0 = desconocido. |
tokens |
int |
0 |
Tokens que gastó la ejecución; 0 = desconocido. |
| Campo de salida | Tipo | Significado |
|---|---|---|
memory_key |
str |
Clave del procedimiento en el que se registró la ejecución. |
version |
int |
Siempre 0: la ejecución va al registro y la fila del procedimiento no se reescribe. |
run_stats |
dict[str, int] |
{total, ok, unfolded} incluyendo esta ejecución; unfolded cuenta las ejecuciones del registro que procedure.evolve aún no ha incorporado. |
procedure.revise
Propone una topología editada para un procedimiento: tú eres el refinador.
POST /v1/procedure.revise · MCP loom_procedure_revise · rol writer · escritura · auditada · no figura en el toolset all de MCP
| Campo de entrada | Tipo | Valor por defecto | Significado |
|---|---|---|---|
org |
str |
obligatorio | El tenant (primer elemento de la tupla de identidad). |
namespace |
str |
obligatorio | El espacio de nombres que la op lee o escribe. |
agent |
str |
'-' |
El agente que escribe o lee; '-' o '*' significa cualquier agente donde la op lo permita. |
user_id |
str |
'-' |
El usuario final al que pertenece la fila; '-' si no hay ninguno. |
session_id |
str |
'-' |
La sesión o conversación a la que pertenece la fila; '-' si no hay ninguna. |
memory_key |
str |
obligatorio | Clave del procedimiento que se va a revisar (procedure_<slug>). |
graph |
dict[str, Any] |
obligatorio | La topología propuesta (grafo completo; los nodos conservan sus ids cuando no cambian, de modo que sus estadísticas se mantienen). |
reason |
str |
'' |
Por qué: qué mostraron las ejecuciones fallidas y qué cambia esta edición. |
force |
bool |
False |
Propone de todos modos una topología que el gate ya rechazó. |
| Campo de salida | Tipo | Significado |
|---|---|---|
memory_key |
str |
Clave del procedimiento revisado. |
version |
int |
Versión de la fila del procedimiento que escribió esta llamada. |
revision |
int |
El nuevo número de revisión; las ejecuciones registradas a partir de ahora se cuentan contra ella. |
prior_revision |
int |
La revisión que reemplaza (se restaura si el gate revierte). |
digest |
str |
Hash de la topología propuesta; el gate lo usa para reconocer una ya rechazada. |
steps |
list[str] |
La lista lineal de pasos derivada del nuevo grafo. |