# recall

Récupérez le contexte durable pertinent lorsqu'un agent a besoin d'une réponse ciblée. Recall recherche par défaut dans toutes vos mémoires ; sur la surface d'outils MCP complète, passez bucket pour ne rechercher que dans un seul bucket.

- Canonical: https://docs.xmemo.dev/fr/docs/tools/recall
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: a5f520ad1f7164b71407d71502e21638cd59fcf0e2c2b3e0226ca364286b5bb5
- Edition-Digest: 1ad3cf9c28d76eae6c9eb0d0e26b89979520860acb477daefd965443979cc7c0
- Source-Revision: sha256:27b29297ea0ca25f76efcb7223face20624379ddfff4699feaaedd6ba1f0fe42

## Tool Reference: `recall`

### Purpose

Effectuer une recherche légère au mieux (best-effort) et tolérante pour renvoyer les quelques mémoires enregistrées les plus pertinentes avant de répondre.

### Parameters

- `query` (string, required): Question ou sujet en langage naturel à rappeler.
- `limit` (integer, optional, default: 5): Nombre restreint de résultats ; gardez-le délimité pour une recherche rapide.

### Returns

Une réponse textuelle classée contenant chaque référence de mémoire, emplacement, contenu et limite d'attribution disponible. Les résultats vides constituent une réponse valide d'absence de correspondance, et non un signal d'autorisation.

### Errors

- 401/403 : la requête ne dispose pas d'un jeton porteur valide ou manque de memory:read.
- Échec de validation : la syntaxe de la requête, de la limite ou des filtres est invalide.
- Non-concordance de périmètre ou d'équipe : la limite demandée n'est pas visible pour le propriétaire authentifié.

### Examples

#### Rappel rapide au mieux (best-effort)



```typescript
recall({
  query: "current MCP authentication decision",
  limit: 3
})
```

### Related Tools

- [search_memory](/docs/tools/search): Utiliser une correspondance ciblée stricte avec des filtres de projet/équipe.
- [recall_context](/docs/tools/recall-context): Utiliser un pack de contexte multi-mémoires délimité.
- [remember](/docs/tools/remember): Persister un fait ou une décision explicitement durable.

## Distinguer un résultat vide d'un échec

Un résultat vide est une réponse valide d'absence de correspondance. Un identifiant manquant ou insuffisant échoue plutôt avec un code 401 ou 403.

```ts
recall({ query: "a topic that was never saved", limit: 3 })
// -> empty result set, HTTP 200
```