Saltar a contenido

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.