# search

Recherchez dans la mémoire autorisée lorsque la formulation pertinente ou l'enregistrement n'est pas connu à l'avance.

- Canonical: https://docs.xmemo.dev/fr/docs/tools/search
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: e4c087a8f0e12c7c67bbf556d6d2f73b0e61a736a9b8686e77e1b181a14238a7
- Edition-Digest: 175de4d85cbdb6e1e132c30579143ac84aacb458294840985e52d4ec96899181
- Source-Revision: sha256:0f9b76db3972abc862d49a83f61e83eed6529dc4507a3c290949f892dcaa48f9

## Tool Reference: `search_memory`

### Purpose

Rechercher des mémoires XMemo autorisées avec une sémantique de correspondance ciblée stricte, afin que les correspondances faibles ne soient pas silencieusement présentées comme la réponse.

### Parameters

- `query` (string, required): Termes de recherche ciblés en langage naturel.
- `limit` (integer, optional, default: 5): Nombre maximal de résultats à renvoyer (par défaut 10).
- `path_filter` (string, optional, default: %): Préfixe de chemin logique facultatif pour restreindre la recherche.
- `memory_type` (string, optional, default: %): Filtre de catégorie de mémoire facultatif (par exemple durable ou working).
- `prefer_working` (boolean, optional, default: false): Lorsque vrai, pondère les mémoires de travail récentes au-dessus des mémoires durables plus anciennes.

### Returns

Une réponse textuelle classée avec des références opaques, des emplacements, du contenu et des métadonnées facultatives d'explication ou de limite d'agent. Le résultat reste limité aux mémoires autorisées.

### Errors

- 401/403 : le jeton est manquant, expiré ou ne dispose pas de memory:read.
- Échec de validation : la syntaxe de la requête est invalide, la limite est négative ou le filtre memory_type est inconnu.
- Divergence de périmètre : le filtre path_filter demandé se trouve en dehors du périmètre autorisé de l'appelant.

### Examples

#### Recherche stricte délimitée au projet



```typescript
search_memory({
  query: "token identity fallback",
  limit: 5
})
```

### Related Tools

- [recall](/docs/tools/recall): Choisir la recherche légère tolérante lorsqu'une correspondance stricte n'est pas requise.
- [recall_context](/docs/tools/recall-context): Assembler plusieurs mémoires dans un pack délimité par des jetons.
- [forget](/docs/tools/forget): Supprimer de manière contrôlée une mémoire trouvée après examen.

## Affiner une recherche qui renvoie trop de résultats

Combinez un terme de requête ciblé avec un filtre path_filter lorsque vous savez quel projet possède la mémoire.

```ts
search_memory({
  query: "token identity fallback",
  limit: 5
})
```