search

Eine Suche eingrenzen, die zu viele Treffer liefert

Fügen Sie Bereichs- und Pfadfilter hinzu, bevor Sie das Limit erhöhen; ein höheres Limit bei einer ungefilterten Abfrage liefert mehr Rauschen, nicht mehr relevante Signale.

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

Öffentliches MCP-Tool

search_memory

Zweck

Autorisierte XMemo-Erinnerungen mit strikter zielgerichteter Übereinstimmungssemantik durchsuchen, damit schwache Treffer nicht fälschlicherweise als Antwort gewertet werden.

Wann zu verwenden

Sie suchen nach Erinnerungen innerhalb eines bekannten Pfads oder Projekts (z. B. mit path_filter).
Sie benötigen eine präzisere Filterung nach Speichertyp oder möchten Arbeitsspeicher bevorzugen.
Die ungenaue Best-Effort-Suche von recall liefert zu breite oder unscharfe Ergebnisse.

Wann NICHT zu verwenden

Verwenden Sie es nicht für eine schnelle, fehlertolerante Ähnlichkeitssuche vor jeder Antwort; nutzen Sie recall.
Verwenden Sie es nicht, um ein budgetiertes Kontextpaket für System-Prompts zu packen; nutzen Sie recall_context.
Verwenden Sie es nicht für veröffentlichte Wissensdokumente; nutzen Sie search_knowledge.
Verwenden Sie es nicht zum Modifizieren von Speicherdaten; search ist rein lesend.

Erforderlicher Scope

memory:read ist für die Suchoberfläche erforderlich.

Parameter

Name	Typ	Beschreibung
`query`	string · erforderlich	Suchbegriff oder Anfragedreieck für die gezielte Speichersuche.
`limit`	integer · Standard: 5	Maximale Anzahl von Ergebnissen (1 bis 50).
`path_filter`	string · Standard: %	Optionaler logischer Pfadpräfix zur Beschränkung der Treffer auf ein Projekt oder einen Namensraum.
`memory_type`	string · Standard: %	Optionaler Speichertyp-Filter (z. B. durable, working, event).
`prefer_working`	boolean · Standard: false	Bevorzugt kurzfristigen Arbeitsspeicher gegenüber dauerhaftem Speicher bei gleicher Relevanz.

Rückgabeschema

Eine bewertete Textantwort mit opaken Referenzen, Orten, Inhalten und optionalen Metadaten zu Erklärungen oder Agentengrenzen. Das Ergebnis ist strikt auf autorisierte Speicherbereiche beschränkt.

Beispiele

Strikte bereichsbezogene Suche

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

Fehler

401/403: Das MCP-Token fehlt oder enthält nicht memory:read.
Validierungsfehler: Die Suchanfrage ist leer oder die Parametergrenzen wurden überschritten.
Filterfehler: Ungültiger Speichertyp oder syntaktisch fehlerhafter Pfadfilter.

recall — Schnellere, verzeihende Best-Effort-Erinnerungsabfragen durchführen.
recall_context — Ein strukturiertes Kontextpaket mit Token-Budget erstellen.
forget — Einen gefundenen veralteten Speichereintrag bereinigen oder deaktivieren.

Quelle: MCP-Tool-Oberfläche