recall_context

Tatsächlich verbrauchtes Budget prüfen

Die Antwort gibt used_items und used_tokens an, wodurch eine tatsächlich prägnante Antwort von einer gekürzten unterschieden werden kann.

recall_context({ query: "recent decisions", max_items: 6, max_tokens: 1200 })

Öffentliches MCP-Tool

recall_context

Zweck

Ein begrenztes Kontextpaket aus relevanten gespeicherten Erinnerungen zusammenstellen, um ein Tokenbudget einzuhalten und gleichzeitig aktuellen Arbeitskontext bereitzustellen.

Wann zu verwenden

Ein Agent beginnt eine Aufgabe und benötigt die nützlichsten Hintergrundinformationen innerhalb eines expliziten Token- oder Elementbudgets.
Sie möchten die tatsächlich verbrauchten Tokens und Elemente im Antworttext einsehen.
Die Sitzung erfordert eine verlässliche Kontextzusammenstellung für Arbeitsbereiche, Projekte oder Agentenübergaben.

Wann NICHT zu verwenden

Verwenden Sie es nicht für eine schnelle unbudgetierte Textsuche; nutzen Sie recall für einfache Best-Effort-Prüfungen.
Verwenden Sie es nicht für die direkte Dokumentenrecherche in Knowledge Bases; nutzen Sie search_knowledge für formale Handbücher und Spezifikationen.
Verwenden Sie es nicht, wenn Sie strukturierte Speicherdaten bearbeiten oder löschen möchten; nutzen Sie remember oder forget.
Verwenden Sie es nicht für Finanzunterlagen oder Aufgabenlisten; nutzen Sie ledger bzw. todos.

Erforderlicher Scope

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

Parameter

Name	Typ	Beschreibung
`query`	string · erforderlich	Thema, Aufgabe oder Fragestellung, die zur Zusammenstellung des relevanten Kontexts verwendet wird.
`max_items`	integer · Standard: 8	Maximale Anzahl von Erinnerungselementen, die in das Kontextpaket aufgenommen werden (1 bis 20).
`max_tokens`	integer · Standard: 1500	Ungefähres Token-Budget für den formatierten Kontextkörper (100 bis 8000).

Rückgabeschema

Das öffentliche MCP-Profil gibt Text anstelle eines strukturierten Objekts zurück. Es beginnt mit der Überschrift '### XMemo Context' und einer Zeile 'Items: <n>', gefolgt von einer Zeile 'Budget: ...', wenn Treffer entfernt oder gekürzt wurden, anschließend einer Zeile pro Element in der Form 'Reference: <id> | Type: <type> | Location: <path>' und schließt mit der Beschriftung 'Context:' und dem begrenzten Kontextkörper ab. Wenn keine passenden Erinnerungen vorliegen, lautet die Ausgabe 'No matching XMemo memory was found.' Behandeln Sie die Referenz als opaken Bezeichner. Nicht-öffentliche Profile können das strukturierte Paket zurückgeben (version, retrieval_plan, budget, items, context_text).

Beispiele

Kontext vor einer Aufgabe wiederherstellen

recall_context({
  query: "recent decisions on the memory-os project",
  max_items: 6,
  max_tokens: 1200
})

Fehler

401/403: Das MCP-Token fehlt oder enthält nicht memory:read.
Validierungsfehler: Die Suchanfrage ist leer oder max_items/max_tokens liegen außerhalb der zulässigen Grenzen.
Sicherheitsablehnung: Eine ungültige Abfragestruktur wird abgelehnt.

recall — Wenige relevante Treffer abrufen, wenn kein Tokenbudget erforderlich ist.
search_memory — Gezielte Abfragen auf bestimmte Pfadfilter anwenden.
remember — Neue Erkenntnisse nach Abschluss der Aufgabe speichern.

Quelle: SDK-Workflow-Hilfsprogramme