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. |