search

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.

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

Outil MCP public

search_memory

Objectif

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.

Quand l'utiliser

Une question nécessite une correspondance ciblée stricte plutôt qu'une approximation tolérante.
L'appelant peut appliquer un filtre path_filter ou memory_type pour restreindre les candidats à la mémoire du projet.
Un flux de travail a besoin d'une recherche basée sur des identifiants et des chemins après avoir stocké une mémoire durable.

Quand NE PAS l'utiliser

Ne l'utilisez pas lorsque des correspondances exploratoires légères sont préférées ; utilisez recall.
Ne l'utilisez pas pour assembler un pack de contexte multi-mémoires délimité par des jetons pour un prompt ; utilisez recall_context.
Ne l'utilisez pas pour rechercher dans les bases de connaissances publiées ; utilisez search_knowledge.
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 ; le serveur filtre toujours les mémoires selon le propriétaire, l'équipe et le périmètre authentifiés.

Paramètres

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

Schéma de retour

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.

Exemples

Recherche stricte délimitée au projet

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

Erreurs

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.

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

Source : Surface des outils MCP