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 observe

Los campos exactos que recibe y devuelve cada operación observe.*.

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 rellenan 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 usa la org de la instalación en todas las ops salvo 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 aceptan y se nombran en ignored_args.

observe.crystallize

Marca las observaciones pendientes de una sesión como listas para su extracción a memorias (solo encola).

POST /v1/observe.crystallize · MCP loom_observe_crystallize · rol writer · idempotente

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 obligatorio 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.
max_observations int 500 Se marcan como listas, como máximo, tantas observaciones pendientes de la sesión, empezando por las más antiguas.
Campo de salida Tipo Significado
enqueued int Cuántas observaciones se marcaron como crystallize:ready para el worker de extracción; 0 cuando la sesión no tenía ninguna pendiente.
session_id str La sesión o conversación a la que pertenece la fila; '-' si ninguna.

observe.record

Registra una observación de herramienta (entrada, salida, archivos, error) en el plano episódico; sin llamada a un LLM.

POST /v1/observe.record · MCP loom_observe_record · rol writer · idempotente

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 obligatorio 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.
run_id str '-' La ejecución del agente (ámbito de la tarea) a la que pertenece la llamada; '-' si ninguna.
tool_name str obligatorio Nombre de la herramienta que se ejecutó; determina el kind de la observación por coincidencia de subcadena.
tool_input dict[str, Any] \| list[Any] \| str \| int \| float \| bool \| None None JSON arbitrario reenviado por el hook; se convierte en cadena y se trunca, nunca se ejecuta.
tool_output dict[str, Any] \| list[Any] \| str \| int \| float \| bool \| None None Lo que devolvió la herramienta; se convierte en cadena y se corta a 800 caracteres en la narrativa.
file_paths list[str] (calculado) Se combina con las rutas detectadas en la entrada o la narrativa.
error str \| None None Presente solo si la llamada falló; reclasifica el kind de la observación como error.
tags list[str] (calculado) Etiquetas adicionales que se añaden tras las propias del servidor (observation, el kind, los nombres base de los archivos); en total se conservan como máximo 32.
observation_date str '' Fecha ISO YYYY-MM-DD registrada como valid_at; vacío = se deja NULL.
action_type str '' La clase de acción propia del cliente (file_read, command_run, …), añadida como etiqueta action:<type>.
metadata dict[str, Any] (calculado) Contexto del cliente (project, repo, event); se acepta, no se almacena.
observed_at str '' El momento en que se ejecutó la herramienta, de modo que una captura enviada más tarde quede fechada cuando ocurrió.
Campo de salida Tipo Significado
memory_key str Clave de la fila episódica, obs:<session_id>:<hash prefix>; un hook que se dispara de nuevo para la misma llamada obtiene la misma clave.
memory_id str Siempre vacío: el id de la fila lo asigna la tabla y no se vuelve a leer.
kind str Uno de estos valores: file_edit / command_run / error / web_fetch / file_read / tool_use.
tags list[str] Las etiquetas almacenadas en la fila (como máximo 32).
file_paths list[str] Rutas de archivo almacenadas en la fila: las enviadas más las encontradas en la entrada y la narrativa; vacío para una llamada autorreferencial.
content_sha256 str Hash del valor de la observación almacenada (kind, herramienta, narrativa, rutas, error).
tool_name str Lo que contiene la fila, en el registro como out_tool_name / out_has_error / out_narrative_chars — una observación con una narrativa de 40 caracteres es un nombre de herramienta, no una observación.
has_error bool True cuando error no estaba vacío (siempre False para una llamada autorreferencial).
narrative_chars int Longitud de la narrativa almacenada en caracteres (como máximo 2000).
skipped_reason str Por qué la fila se almacenó sin contenido: "self_referential" (la herramienta era el propio loom o una herramienta meta del harness), "blacklisted" (el contenido coincidió con un patrón de la lista negra); "" en otro caso.