Comprueba el presupuesto realmente utilizado
La respuesta informa de used_items y used_tokens, lo que permite distinguir una respuesta realmente pequeña de una truncada.
recall_context({ query: "recent decisions", max_items: 6, max_tokens: 1200 })Herramienta MCP pública
recall_context
Propósito
Lee un paquete de contexto acotado de varias memorias, con elementos estructurados y texto limitado por presupuesto de tokens; no modifica nada.
Cuándo usar
- Restaura el contexto del proyecto, la tarea y el agente necesario para continuar el trabajo entre sesiones.
- Reúne varias memorias relacionadas para construir un prompt dentro de un presupuesto explícito de elementos y tokens.
- Úsalo al inicio de una sesión o tarea cuando una única respuesta rápida no sea suficiente.
Cuándo NO usar
- No lo uses para una consulta rápida y flexible; usa recall.
- No lo uses cuando solo deba aceptarse una coincidencia estricta y dirigida; usa search_memory.
- No solicites un volcado de historial sin límites; max_items y max_tokens son límites de seguridad y de calidad de contexto.
- La API REST acepta un conjunto de campos más amplio que la herramienta MCP pública; consulta /docs/api/memory para los filtros de scope, bucket, team y provenance.
Ámbito requerido
- Se requiere memory:read; el servidor sigue aplicando los límites de scope, bucket, equipo y agente.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
query | string · obligatorio | Consulta en lenguaje natural para la que se construye el paquete de contexto. |
max_items | integer · predeterminado: 8 | Número máximo de memorias del paquete (1-50). |
max_tokens | integer · predeterminado: 1500 | Longitud máxima del contexto renderizado en tokens (1-12000). |
Esquema de retorno
El perfil MCP público devuelve texto, no un objeto estructurado. Comienza con el encabezado '### XMemo Context' y una línea 'Items: <n>'; añade una línea 'Budget: ...' cuando se descartan o acortan resultados, después una línea por elemento con la forma literal 'Reference: <id> | Type: <type> | Location: <path>', y finalmente la etiqueta 'Context:' seguida del cuerpo de contexto limitado. Los perfiles no públicos pueden devolver el paquete estructurado (version, retrieval_plan, budget, items, context_text). Trata la referencia como un identificador opaco.
Ejemplos
recall_context({
query: "recent decisions on the memory-os project",
max_items: 6,
max_tokens: 1200
})Errores
- 401/403: falta memory:read o, cuando corresponde, la capacidad de lectura de memoria temporal.
- 422: max_items, max_tokens o un limit explícito está fuera de los límites admitidos de presupuesto/candidatos.
- Error de validación: query o uno de los filtros opcionales tiene un formato incorrecto.
Herramientas relacionadas
- recall — Elige la ruta ligera de mejor esfuerzo para una respuesta rápida.
- search_memory — Elige coincidencias estrictas cuando los resultados débiles sean inseguros.
- remember — Conserva contexto duradero nuevo después de que la política de captura lo apruebe.
Fuente: Superficie de herramientas MCP