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

<!-- i18n: source=docs/reference/operations/context.md blob=093091d1e021fa46a119227148999d3ff22b0ac2 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/context/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/context/), which is authoritative.

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

# Operaciones de `context`

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

<!-- 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 en un servidor de un solo usuario, se rellena la org de la instalación en todas las ops salvo `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 indican en `ignored_args`.

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

<a id="contextfetch"></a>

## `context.fetch`

Recupera un resultado almacenado por su clave: un fragmento de caracteres (offset/limit) o solo las líneas que coinciden con una regex (pattern, con context_lines).

`POST /v1/context.fetch` · MCP `loom_context_fetch` · 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 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; `'-'` 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. |
| `blob_key` | `str` | obligatorio | La clave que devolvió `context.offload`. |
| `offset` | `int` | `0` | Desplazamiento en caracteres donde empieza el fragmento; con `pattern`, cuántas coincidencias se omiten. |
| `limit` | `int` | `4000` | Como máximo esta cantidad de caracteres de contenido por llamada (1-64000). |
| `pattern` | `str` | `''` | Regex (sintaxis RE2, sin distinguir mayúsculas de minúsculas; sin referencias hacia atrás ni lookaround). |
| `context_lines` | `int` | `0` | Con `pattern`, líneas de contexto que se muestran alrededor de cada coincidencia (0-10); las líneas de contexto se numeran `lineno-` y las coincidencias `lineno:`. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `found` | `bool` | False cuando ningún blob vigente y no caducado tiene esta clave en el espacio de nombres. |
| `blob_key` | `str` | Eco del `blob_key` de entrada. |
| `content` | `str` | El fragmento de caracteres o, con `pattern`, las líneas coincidentes como `lineno: text`. |
| `content_type` | `str` | Tipo de medio almacenado con el blob. |
| `summary` | `str` | El resumen almacenado con el blob. |
| `total_chars` | `int` | Longitud de todo el contenido almacenado, en caracteres. |
| `total_lines` | `int` | Número de líneas de todo el contenido almacenado. |
| `offset` | `int` | Eco del `offset` de entrada. |
| `next_offset` | `int` | -1 cuando el fragmento (o la lista de coincidencias) se ha agotado. |
| `matched_lines` | `int` | Con `pattern`, cuántas líneas de todo el contenido coinciden; 0 en caso contrario. |
| `expires_at` | `datetime \| None` | Momento en que el blob deja de poder recuperarse; None si no se encontró. |

<a id="contextoffload"></a>

## `context.offload`

Aparca un resultado de herramienta grande (log, página, diff, salida de consulta) fuera del contexto del modelo.

`POST /v1/context.offload` · MCP `loom_context_offload` · 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 la tarea) a la que pertenece la llamada; `'-'` si ninguna. |
| `content` | `str` | obligatorio | El texto que se va a aparcar; si supera `LOOM_CONTEXT_OFFLOAD_MAX_BYTES` (bytes UTF-8) devuelve un 413. |
| `blob_key` | `str` | `''` | Vacío = direccionado por contenido (`blob/<sha256 prefix>`): aparcar la misma salida dos veces produce la misma clave y una sola fila almacenada. |
| `content_type` | `str` | `'text/plain'` | Tipo de medio almacenado con el contenido y devuelto por `context.fetch`. |
| `summary` | `str` | `''` | Resumen de una línea proporcionado por quien llama (el nombre de la herramienta y lo que devolvió). |
| `ttl_seconds` | `int` | `604800` | Durante cuánto tiempo se puede recuperar el blob, en segundos (de 1 minuto a 90 días). |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `blob_key` | `str` | La clave con la que recuperar el contenido: la indicada, o `blob/<sha256 prefix>`. |
| `content_bytes` | `int` | Tamaño del contenido almacenado en bytes UTF-8. |
| `content_chars` | `int` | Longitud del contenido almacenado en caracteres. |
| `sha256` | `str` | Resumen SHA-256 del contenido en hexadecimal. |
| `summary` | `str` | El resumen almacenado con el blob: el indicado, o los primeros 200 caracteres del contenido. |
| `expires_at` | `datetime` | Momento en que el blob deja de poder recuperarse. |
| `pointer` | `str` | Listo para sustituir al contenido en la transcripción. |

<a id="contextpack"></a>

## `context.pack`

Las memorias, decisiones y procedimientos de una tarea: llámalo primero en cada tarea, salvo que un hook de Loom ya haya puesto el contexto de Loom en esta sesión.

`POST /v1/context.pack` · MCP `loom_context_pack` · role `viewer` · read

| 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 para el que el pack lee; "-" lee todos los usuarios en las secciones de memorias, perfil, procedimientos y ejecuciones, y las filas archivadas sin usuario en las secciones de stack y memoria de trabajo. |
| `session_id` | `str` | `'-'` | La sesión para la que el pack lee; "-" lee todas las sesiones en la sección de memorias, y las filas archivadas sin sesión en las secciones de stack y memoria de trabajo. |
| `run_id` | `str` | `'-'` | La ejecución del agente (ámbito de tarea) a la que pertenece la llamada; `'-'` para ninguna. |
| `query` | `str` | `''` | Tarea o pregunta opcional usada para seleccionar memorias y documentos relevantes. |
| `situation` | `str` | `''` | Descripción opcional de la situación usada para encontrar procedimientos coincidentes. |
| `procedure_explore_rate` | `float \| None` | `None` | Tasa de exploración para la sección de procedimientos; None = 0 (nunca). |
| `token_budget` | `int` | `2000` | Límite de tamaño de todo el pack renderizado en tokens (unos 4 caracteres cada uno); un pack más largo se recorta y se activa `truncated`. |
| `top_k` | `int` | `5` | Cuántos resultados pide cada sección respaldada por búsqueda (los procedimientos y la capa de conocimiento del stack lo limitan a 5). |
| `read_scope` | `Literal['namespace', 'own_user', 'own_session']` | `'namespace'` | Misma semántica que memory.search.read_scope; se enlaza con el user_id / session_id de esta op. |
| `mode` | `Literal['startup', 'task', 'debug', 'handoff']` | `'task'` | Presupuestos de sección y receta de búsqueda, sin llamada a un LLM en ningún modo: `startup` (recuperación rápida; sin query sirve los pins y las memorias recientes), `task` y `handoff` (equilibrado), `debug` (calidad). |
| `include_knowledge` | `bool` | `False` | Añade una sección `knowledge` con fragmentos de documentos coincidentes; necesita una `query`. |
| `include_conversations` | `bool` | `False` | Añade una sección `conversations` con mensajes pasados coincidentes; necesita una `query`. |
| `include_runs` | `bool` | `False` | El manifiesto de ejecuciones: una línea por cada sesión reciente de esta identidad (fecha, estado y objetivo de la ejecución, llamadas a herramientas por tipo con errores, archivos tocados, resumen), las más recientes primero, `runs_limit` filas. |
| `runs_limit` | `int` | `12` | Cuántas sesiones recientes lista el manifiesto de ejecuciones cuando se activa `include_runs` (1-50). |
| `include_chunks` | `bool` | `False` | Amplía el conjunto del reranker de la búsqueda de memorias con 20 candidatos recientes; no tiene efecto sin un reranker. |
| `section_token_budgets` | `dict[str, int]` | *(calculado)* | Presupuestos de tokens por sección que sustituyen los valores por defecto del modo, indexados por nombre de sección; una sección nunca recibe menos de 80 tokens. |
| `block_order` | `list[str]` | *(calculado)* | Orden de bloques opcional especificado por el llamador. |
| `session_block` | `str` | `''` | El marcador de sesión propio del llamador (`session:<project>`, la nota del hook Stop del plugin). |
| `only_sections` | `list[Literal['working_memory', 'memory_stack', 'profile', 'memories', 'procedures', 'decisions', 'knowledge', 'conversations', 'runs', 'namespace_health', 'namespace_guide', 'mentor']]` | *(calculado)* | Restringe el pack a estas secciones. |
| `include_decisions` | `bool` | `True` | Los resultados de tipo decisión salen del bloque de memorias y se renderizan como su propia sección etiquetada <decisions>, con el registro estructurado (escenario, resultado, resultado real). |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `rendered` | `str` | El pack como un único texto: cada sección no vacía dentro de una etiqueta `<name>`, en el orden de bloques, recortado a `token_budget`. |
| `sections` | `dict[str, str]` | El cuerpo de cada sección por nombre, en el orden de bloques; las secciones que no renderizaron nada están ausentes. |
| `blocks` | `list[ContextBlock]` | Una entrada por sección no vacía: etiqueta, cuerpo, estimación de tokens, citas, número de fuentes y `priority` (su posición en el orden de bloques). |
| `section_meta` | `dict[str, dict[str, Any]]` | Detalles por sección y nombre: número de fuentes, citas, si se recortó, su tamaño, su presupuesto de tokens y su proporción de llenado (por encima de 1.0 significa que se recortó). |
| `section_count` | `int` | Cuántas secciones renderizaron algo. |
| `truncated` | `bool` | True cuando alguna sección, o todo el pack, se recortó a su presupuesto. |
| `token_budget` | `int` | Eco del `token_budget` de entrada. |
| `mode` | `str` | Eco del `mode` de entrada. |
| `tokens_estimate` | `int` | Presión sobre el presupuesto. |
| `fill_ratio` | `float` | `tokens_estimate / token_budget`, con tres decimales. |
| `stable_sections` | `list[str]` | El tramo inicial de `rendered` que no depende de `query` ni de `situation`: los mismos bytes para cada pregunta que haga esta identidad hasta que cambien su memoria de trabajo, su perfil o sus pins. |
| `stable_prefix_chars` | `int` | Longitud en caracteres de ese prefijo de `rendered`; 0 cuando la primera sección depende de la query. |
| `stable_hash` | `str` | SHA-256 del prefijo estable; vacío cuando `stable_prefix_chars` es 0. |
| `procedure_keys` | `list[str]` | Procedimientos que el pack puso delante del agente: el lado "mostrado" del registro que necesita una utilidad. |
| `procedure_keys_withheld` | `list[str]` | Procedimientos que el pack encontró y retuvo deliberadamente: el lado "no mostrado" del mismo registro. |

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