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