# search

Durchsuchen Sie den autorisierten Speicher, wenn der genaue Wortlaut oder Datensatz vorab nicht bekannt ist.

- Canonical: https://docs.xmemo.dev/de/docs/tools/search
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: e4c087a8f0e12c7c67bbf556d6d2f73b0e61a736a9b8686e77e1b181a14238a7
- Edition-Digest: 4d02d73e336867e096380e4c72b93660ac16499c2a2ff7f122fe9ba7ae188412
- Source-Revision: sha256:0f9b76db3972abc862d49a83f61e83eed6529dc4507a3c290949f892dcaa48f9

## Tool Reference: `search_memory`

### Purpose

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

### Parameters

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

### Returns

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.

### Errors

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

### Examples

#### Strikte bereichsbezogene Suche



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

### Related Tools

- [recall](/docs/tools/recall): Schnellere, verzeihende Best-Effort-Erinnerungsabfragen durchführen.
- [recall_context](/docs/tools/recall-context): Ein strukturiertes Kontextpaket mit Token-Budget erstellen.
- [forget](/docs/tools/forget): Einen gefundenen veralteten Speichereintrag bereinigen oder deaktivieren.

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

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