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 context
Los campos exactos que recibe y devuelve cada operación context.*.
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 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 indican en ignored_args.
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ó. |
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. |
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 |
| 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. |