# recall_context

Stellen Sie den aktuellen Projekt- und Agentenkontext wieder her, der für die sitzungsübergreifende Fortsetzung der Arbeit erforderlich ist.

- Canonical: https://docs.xmemo.dev/de/docs/tools/recall-context
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: 0767dc0a1fcb4e59857a76cce464ac0c81e3dccf483200c4310a35325dccee22
- Edition-Digest: dd33a5f6f439c9f483ebe218dfd0e6af023aa6e4a229c01550793b97d1c24f09
- Source-Revision: sha256:0000db16929d847dd06d0f100593276843962eb54fb925e1a5f66997e039974c

## Tool Reference: `recall_context`

### Purpose

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

### Parameters

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

### Returns

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).

### Errors

- 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.

### Examples

#### Kontext vor einer Aufgabe wiederherstellen



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

### Related Tools

- [recall](/docs/tools/recall): Wenige relevante Treffer abrufen, wenn kein Tokenbudget erforderlich ist.
- [search_memory](/docs/tools/search): Gezielte Abfragen auf bestimmte Pfadfilter anwenden.
- [remember](/docs/tools/remember): Neue Erkenntnisse nach Abschluss der Aufgabe speichern.

## 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.

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