# recall_context

Restaurez le contexte récent de projet et d'agent nécessaire pour poursuivre le travail d'une session à l'autre.

- Canonical: https://docs.xmemo.dev/fr/docs/tools/recall-context
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: 0767dc0a1fcb4e59857a76cce464ac0c81e3dccf483200c4310a35325dccee22
- Edition-Digest: 9ea69cdf57a81d97b38aef7e31ce5839e626751414e6fa275799e6ba603b46f4
- Source-Revision: sha256:0000db16929d847dd06d0f100593276843962eb54fb925e1a5f66997e039974c

## Tool Reference: `recall_context`

### Purpose

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.

### Parameters

- `query` (string, required): Requête en langage naturel pour laquelle le pack de contexte est assemblé.
- `max_items` (integer, optional, default: 8): Nombre maximal de mémoires dans le pack (1-50).
- `max_tokens` (integer, optional, default: 1500): Longueur maximale du contexte généré en jetons (1-12000).

### Returns

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

### Errors

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

### Examples

#### Restaurer le contexte avant une tâche



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

### Related Tools

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

## Vérifier le budget réellement consommé

La réponse indique used_items et used_tokens, ce qui permet de distinguer une réponse réellement concise d'une réponse tronquée.

```ts
recall_context({ query: "recent decisions", max_items: 6, max_tokens: 1200 })
```