ReferenzMCP-Toolsrecall

Tool Reference

recall

Rufen Sie relevanten dauerhaften Kontext ab, wenn ein Agent eine gezielte Antwort benötigt. Recall durchsucht standardmäßig alle Ihre Erinnerungen; auf der vollständigen MCP-Tool-Oberfläche übergeben Sie bucket, um nur einen Bucket zu durchsuchen.

Ein leeres Ergebnis von einem Fehler unterscheiden

Ein leeres Ergebnis ist eine gültige Rückmeldung ohne Treffer. Fehlende oder unzureichende Anmeldedaten schlagen stattdessen mit 401 oder 403 fehl.

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

Öffentliches MCP-Tool

recall

Zweck

Einen schlanken, fehlertoleranten Best-Effort-Abruf ausführen und die wenigen relevantesten gespeicherten Erinnerungen vor dem Antworten zurückgeben.

Wann zu verwenden

  • Der Agent muss eine Frage beantworten und sollte prüfen, ob nützliche Erinnerungen, Präferenzen oder Entscheidungen vorliegen.
  • Der Aufruf soll schnell und fehlertolerant sein; leere Ergebnisse bedeuten einfach, dass keine Erinnerung passt.
  • Sie möchten eine lesbare Rangliste der relevantesten Textausschnitte statt eines großen Kontextpakets.

Wann NICHT zu verwenden

  • Verwenden Sie es nicht, wenn Sie ein abgegrenztes Kontextpaket mit strikter Token-/Elementbudgetierung benötigen; nutzen Sie stattdessen recall_context.
  • Verwenden Sie es nicht für eine strikte Projektfilterung oder das Auffinden exakter Speicher-IDs; nutzen Sie search_memory.
  • Verwenden Sie es nicht zum Durchsuchen versionierter Wissensdatenbanken; nutzen Sie search_knowledge für freigegebene Dokumentinhalte.
  • Verwenden Sie es nicht, um Schreibvorgänge oder Bereinigungen zu autorisieren; recall ist strikt lesend und führt keine Statusänderungen durch.

Erforderlicher Scope

  • memory:read ist für die öffentliche MCP-Abrufoberfläche erforderlich.

Parameter

NameTypBeschreibung
querystring · erforderlichNatürlichsprachliche Suchanfrage oder Frage zur Suche nach relevanten Erinnerungen.
limitinteger · Standard: 5Maximale Anzahl zurückzugebender Erinnerungen, begrenzt von 1 bis 10.

Rückgabeschema

Eine bewertete Textantwort, die jede Speicherreferenz, den Ort, den Inhalt und die verfügbare Herkunftsgrenze enthält. Leere Ergebnisse stellen eine gültige Antwort ohne Treffer dar, kein Autorisierungssignal.

Beispiele

Schneller Best-Effort-Abruf
recall({
  query: "current MCP authentication decision",
  limit: 3
})

Fehler

  • 401/403: Das MCP-Token fehlt oder enthält nicht memory:read.
  • Validierungsfehler: Die Suchanfrage ist leer oder das Limit liegt außerhalb des zulässigen Bereichs.
  • Sicherheitsablehnung: Eine bösartige oder reservierte Abfragestruktur wird blockiert.
  • search_memory — Strikte bereichsbezogene Suche verwenden, wenn der genaue Projektpfad bekannt ist.
  • recall_context — Ein budgetiertes Kontextpaket für eine längere Agentenaufgabe zusammenstellen.
  • remember — Einen neuen dauerhaften Fakt speichern, nachdem ein Wissensdefizit festgestellt wurde.

Quelle: MCP-Tool-Oberfläche