> Source: https://clickhouse.github.io/loom/es/reference/operations/working_memory/ (Markdown: https://clickhouse.github.io/loom/es/reference/operations/working_memory.md)

<!-- i18n: source=docs/reference/operations/working_memory.md blob=1c42739885ece1caff5a674519dc56e751fc9fcf model=claude-sonnet-5-5 -->
> Esta página es una traducción automática de la [página en inglés](https://clickhouse.github.io/loom/reference/operations/working_memory/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/working_memory/), which is authoritative.

<a id="working_memory-operations"></a>

# Operaciones de `working_memory`

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

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

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](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) también su espacio de nombres y su agente; consulta [identidades y espacios de nombres](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md). El [índice de operaciones](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica el rol, el tipo y el listado `all` de MCP. Los campos de entrada desconocidos se atienden y se nombran en `ignored_args`.

<!-- prettier-ignore-start -->

<a id="working_memoryappend"></a>

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

<a id="working_memorydelete"></a>

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

<a id="working_memoryget"></a>

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

<a id="working_memoryrender"></a>

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

<a id="working_memoryreplace"></a>

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

<a id="working_memoryset"></a>

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

<!-- prettier-ignore-end -->
