# search_knowledge

Durchsuchen Sie veröffentlichte aktuelle Knowledge-Revisionen oder lesen Sie ein exaktes autorisiertes Element und eine unveränderliche Revision mit begrenzter Paginierung.

- Canonical: https://docs.xmemo.dev/de/docs/tools/search-knowledge
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: 0310677a87145c1efaa396cd0aa2c2893ad43e7f2bff4548b876ab6d5b61ac0e
- Edition-Digest: d78c9b8b37c86ccb54f55d36cd3db09b8c7530ed3a264452c6a0b1e2be0e0217
- Source-Revision: sha256:f9db1cd4b6ed36f17d373c2a7c050c7e3ba83004cace01216f0ec51ea5b5b265

## Tool Reference: `search_knowledge`

### Purpose

Autorisierte Wissensdatenbankinhalte entweder über eine bewertete Abfrage auf veröffentlichten aktuellen Revisionen oder über ein exaktes Element mit begrenzter Inhalts-Paginierung lesen.

### Parameters

- `query` (string, optional, default: empty): Natürlichsprachliche Abfrage für bewertete Suche; erforderlich im Abfragemodus und schließt adressierte Bezeichner aus.
- `knowledge_base_id` (string, optional, default: empty): Optionale exakte Wissensdatenbank-ID zur Eingrenzung der Suche oder Validierung eines adressierten Elements.
- `knowledge_item_id` (string, optional, default: empty): Exakte autorisierte Element-ID für den adressierten Lesevorgang.
- `knowledge_revision_id` (string, optional, default: empty): Optionale exakte unveränderliche Revisions-ID für das adressierte Element; erfordert knowledge_item_id.
- `offset` (integer, optional, default: 0): Nullbasierter Zeichen-Offset für adressierte Inhalte.
- `limit_chars` (integer, optional, default: 4000): Inhaltsfenster für adressiertes Lesen von 1 bis 10000 Zeichen an der MCP-Grenze.
- `max_results` (integer, optional, default: 10): Maximale Anzahl von Suchergebnissen (1 bis 50).
- `mode` (string, optional, default: hybrid): Bewertungsmodus der Abfrage: hybrid, lexical, semantic oder rrf. Unbekannte Werte werden vom MCP-Handler auf hybrid normalisiert.
- `alpha` (number, optional, default: 0.5): Lexikalisches Gewicht im Hybridmodus, begrenzt von 0.0 bis 1.0; das semantische Gewicht beträgt 1 - alpha.

### Returns

Die Abfrage gibt JSON-Text mit {"type":"knowledge_search","results":[...]} zurück, wobei jedes Ergebnis die aktuellen Element-/Revisions-IDs, Titel, begrenzten Auszug, Quelle/Zitation, Referenz und Relevanzwerte enthält. Der adressierte Lesevorgang liefert JSON-Text mit type='knowledge', owner/team/scope, Basis-/Element-/Revisions-IDs, Titel, begrenztem Inhalt, Locator, Quelle, Referenz, content_offset, content_limit, content_total_chars und content_truncated. Das Tool gibt keine Audit-Hülle zurück.

### Errors

- knowledge_runtime_disabled: Die Runtime ist deaktiviert und das Tool liefert eine knowledge_unavailable-Hülle; dies ist ein Betriebsstatus, kein Fallback auf unbeschränkten Speicher.
- knowledge_invalid_request: query wurde mit adressierten IDs gemischt, Grenzwerte für offset/limit_chars/max_results wurden überschritten oder die Anfrageform ist ungültig.
- knowledge_query_required oder knowledge_item_required: Weder Abfrage noch adressiertes Element angegeben, oder knowledge_revision_id ohne knowledge_item_id übergeben.
- knowledge_resource_unavailable: Basis, Element oder Revision fehlt, ist unautorisiert, inaktiv oder kein veröffentlichtes Element.
- Autorisierungs- oder Validierungsfehler: Dem Aufrufer fehlt knowledge:read, die Abfrage überschreitet Grenzwerte oder ein Parameter ist fehlerhaft.

### Examples

#### Aktuelles veröffentlichtes Wissen durchsuchen



```typescript
search_knowledge({
  query: "deployment runbook",
  knowledge_base_id: "<knowledge-base-id>",
  mode: "hybrid",
  alpha: 0.5,
  max_results: 10
})
```

#### Eine festgepinnte Revision stückweise lesen



```typescript
search_knowledge({
  knowledge_item_id: "<knowledge-item-id>",
  knowledge_revision_id: "<immutable-revision-id>",
  offset: 0,
  limit_chars: 4000
})
```

### Related Tools

- [recall_context](/docs/tools/recall-context): Ein begrenztes Kontextpaket aus normalen XMemo-Erinnerungen statt aus Wissensdatenbankinhalten erstellen.
- [search_memory](/docs/tools/search): Strikte gezielte Suche auf der regulären Speicheroberfläche anwenden.
- [remember](/docs/tools/remember): Einen explizit angeforderten dauerhaften Speicherfakt speichern, keine Wissensrevision.

## Wählen Sie die Leseform vor dem Aufruf

Verwenden Sie query für eine bewertete Suche oder knowledge_item_id für einen adressierten Lesevorgang. Fügen Sie knowledge_revision_id nur hinzu, wenn die exakte unveränderliche Revision Teil der Anfrage ist.