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 working_memory

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

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 a un servidor de un solo usuario, se rellena 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.

working_memory.append

Agrega texto a un bloque de memoria de trabajo y lo crea si no existe.

POST /v1/working_memory.append · MCP loom_working_memory_append · 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 operación lee o escribe.
agent str obligatorio El agente que escribe o lee; '-' o '*' significa cualquier agente cuando la operación 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.
run_id str '-' La ejecución del agente (ámbito de tarea) a la que pertenece la llamada; '-' si no hay ninguna.
block_key str 'scratchpad' El bloque al que se agrega; un bloque inexistente se crea con el límite de tamaño por defecto.
addition str obligatorio Texto que se agrega al final del bloque.
separator str '\n' Se coloca entre el texto existente y addition; no se usa cuando el bloque es nuevo.
Campo de salida Tipo Significado
block_key str El bloque que se escribió.
version int Versión de la fila que creó esta escritura (una marca de tiempo en nanosegundos).
char_limit int El límite de tamaño del bloque en caracteres después de la escritura.
value_length int Longitud del contenido del bloque después de la escritura, en caracteres.
fill_ratio float value_length / char_limit, con tres decimales; se rechaza una escritura que superaría 1.0.

working_memory.delete

Elimina un bloque de memoria de trabajo.

POST /v1/working_memory.delete · MCP loom_working_memory_delete · rol writer · idempotente · 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 obligatorio 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.
run_id str '-' La ejecución del agente (ámbito de tarea) a la que pertenece la llamada; '-' si no hay ninguna.
block_key str 'scratchpad' El bloque que se va a eliminar.
Campo de salida Tipo Significado
deleted bool False cuando el ámbito no contenía ningún bloque activo con esta clave.
block_key str Eco del block_key de entrada.

working_memory.get

Obtiene un bloque de memoria de trabajo por su clave.

POST /v1/working_memory.get · MCP loom_working_memory_get · rol viewer · lectura · no aparece en el conjunto de herramientas 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 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 no hay ninguno.
session_id str '-' La sesión o conversación a la que pertenece la fila; '-' si no hay ninguna.
run_id str '-' La ejecución del agente (ámbito de tarea) a la que pertenece la llamada; '-' si no hay ninguna.
block_key str 'scratchpad' El bloque que se lee, dentro del ámbito (agent, user, session, run) del llamador.
Campo de salida Tipo Significado
found bool False cuando el ámbito no contiene ningún bloque vigente con esta clave; el resto toma entonces los valores por defecto.
block_key str Eco de la clave del bloque.
content str El texto del bloque; vacío si no se encuentra.
char_limit int El límite de tamaño del bloque en caracteres; una escritura que lo supere se rechaza con 422.
version int Versión de la fila actual del bloque (una marca de tiempo en nanosegundos); 0 si no se encuentra.
updated_at datetime \| None Cuándo se escribió el bloque por última vez; None si no se encuentra.
fill_ratio float len(content) / char_limit.

working_memory.render

Renderiza bloques de memoria de trabajo como XML o markdown. context.pack ya incluye esta sección; el renderizado directo se usa sobre todo en código de SDK o de orquestación personalizada.

POST /v1/working_memory.render · MCP loom_working_memory_render · 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 operación lee o escribe.
agent str obligatorio 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; '-' para ninguno.
session_id str '-' La sesión o conversación a la que pertenece la fila; '-' para ninguna.
run_id str '-' La ejecución del agente (ámbito de tarea) a la que pertenece la llamada; '-' para ninguna.
block_keys list[str] (calculado) Solo estos bloques (como máximo 20); vacío = todos los bloques vigentes en el ámbito.
format Literal['xml', 'markdown'] 'xml' xml envuelve cada bloque en una etiqueta <working-memory block=...>; markdown lo coloca bajo un encabezado ## <block_key>.
limit int 20 Como máximo este número de bloques, en orden de block_key (1-100).
Campo de salida Tipo Significado
rendered str Los bloques como un único texto en el format elegido; vacío cuando el ámbito no tiene ninguno.
blocks list[WorkingMemoryBlock] Los bloques renderizados con sus límites de tamaño y versiones, en orden de block_key.
block_count int Cuántos bloques se renderizaron.
total_chars int Suma de las longitudes del contenido de los bloques, en caracteres.

working_memory.replace

Reemplaza texto exacto dentro de un bloque de memoria de trabajo.

POST /v1/working_memory.replace · MCP loom_working_memory_replace · rol writer · idempotente · 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 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 tarea) a la que pertenece la llamada; '-' si ninguna.
block_key str 'scratchpad' El bloque que se edita; un bloque inexistente devuelve un 404.
old str obligatorio Texto a buscar; se reemplaza cada aparición, y si el texto no existe se devuelve un 422.
new str '' Texto de reemplazo; si está vacío, elimina las apariciones de old.
Campo de salida Tipo Significado
block_key str El bloque que se escribió.
version int Versión de la fila que creó esta escritura (una marca de tiempo en nanosegundos).
char_limit int El límite de tamaño del bloque en caracteres tras la escritura.
value_length int Longitud del contenido del bloque tras la escritura, en caracteres.
fill_ratio float value_length / char_limit, con tres decimales; se rechaza una escritura que superaría 1.0.

working_memory.set

Sobrescribe un bloque de memoria de trabajo.

POST /v1/working_memory.set · MCP loom_working_memory_set · 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 no hay ninguno.
session_id str '-' La sesión o conversación a la que pertenece la fila; '-' si no hay ninguna.
run_id str '-' La ejecución del agente (ámbito de la tarea) a la que pertenece la llamada; '-' si no hay ninguna.
block_key str 'scratchpad' El bloque que se escribe, dentro del ámbito (agente, usuario, sesión, ejecución) de quien llama.
content str '' El texto nuevo completo del bloque, que reemplaza lo que contenía; si está vacío, se guarda un bloque vacío.
char_limit int 4096 El límite de tamaño del bloque en caracteres; un content más largo se rechaza con 422.
Campo de salida Tipo Significado
block_key str El bloque que se escribió.
version int Versión de la fila que creó esta escritura (una marca de tiempo en nanosegundos).
char_limit int El límite de tamaño del bloque en caracteres después de la escritura.
value_length int Longitud del contenido del bloque después de la escritura, en caracteres.
fill_ratio float value_length / char_limit, con tres decimales; una escritura que superaría 1.0 se rechaza.