recall_context

Outil MCP public

recall_context

Objectif

Lire un pack de contexte multi-mémoires délimité avec des éléments structurés et un texte de contexte respectant un budget de jetons ; ne modifie rien.

Quand l'utiliser

• Restaurer le contexte de projet, de tâche et d'agent nécessaire pour poursuivre le travail à travers les sessions.
• Assembler plusieurs mémoires associées pour la construction de prompts dans le respect d'un budget explicite d'éléments et de jetons.
• À utiliser au début d'une session ou d'une tâche lorsqu'un résultat unique et rapide est insuffisant.

Quand NE PAS l'utiliser

• Ne l'utilisez pas pour une recherche rapide et tolérante unique ; utilisez recall.
• Ne l'utilisez pas lorsque seule une correspondance stricte et ciblée doit être acceptée ; utilisez search_memory.
• Ne demandez pas un dump illimité de l'historique ; max_items et max_tokens sont des limites de sécurité et de qualité du contexte.
• L'API REST accepte un ensemble de champs plus large que l'outil MCP public ; consultez /docs/api/memory pour les filtres de périmètre, bucket, équipe et provenance.

Périmètre requis

• memory:read est requis ; les limites de périmètre, bucket, équipe et agent sont toujours appliquées par le serveur.

Paramètres

Schéma de retour

Le profil MCP public renvoie du texte, et non un objet structuré. Il débute par un titre '### XMemo Context' et une ligne 'Items: <n>', ajoute une ligne 'Budget: ...' lorsque des résultats ont été éliminés ou raccourcis, puis une ligne par élément sous la forme littérale 'Reference: <id> | Type: <type> | Location: <path>', et enfin une étiquette 'Context:' suivie du corps de contexte délimité. Lorsqu'aucun élément ne correspond, il indique 'No matching XMemo memory was found.' Traitez la référence comme un identifiant opaque. Les profils non publics peuvent renvoyer le pack structuré (version, retrieval_plan, budget, items, context_text).

Exemples

recall_context({
  query: "recent decisions on the memory-os project",
  max_items: 6,
  max_tokens: 1200
})

Erreurs

• 401/403 : la requête ne dispose pas de memory:read ou de la capacité de lecture de mémoire temporaire le cas échéant.
• 422 : max_items, max_tokens ou une limite explicite est hors des limites de budget/candidats prises en charge.
• Échec de validation : la requête ou l'un des filtres facultatifs est malformé.

Outils associés

• recall — Choisir la voie légère au mieux (best-effort) pour une réponse rapide.
• search_memory — Choisir la correspondance stricte lorsque des résultats approximatifs sont dangereux.
• remember — Persister un nouveau contexte durable après approbation par la politique de capture.