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.
Öffentliches MCP-Tool
search_knowledge
Zweck
Autorisierte Wissensdatenbankinhalte entweder über eine bewertete Abfrage auf veröffentlichten aktuellen Revisionen oder über ein exaktes Element mit begrenzter Inhalts-Paginierung lesen.
Wann zu verwenden
- In einer autorisierten Wissensdatenbank nach Themen suchen, wenn aktuelle veröffentlichte Inhalte nach lexikalischer, semantischer, hybrider oder RRF-Bewertung gewichtet werden sollen.
- Ein exaktes Knowledge-Element und dessen aktuelle Revision oder eine spezifisch adressierte unveränderliche Revision lesen.
- Ein begrenztes Inhaltsfenster mit offset und limit_chars nutzen, wenn eine Revision das Kontextbudget des Aufrufers übersteigt.
Wann NICHT zu verwenden
- Verwenden Sie es nicht für den normalen XMemo-Speicherabruf; nutzen Sie recall, search_memory oder recall_context für den regulären Speicher.
- Verwenden Sie es nicht zum Erstellen, Veröffentlichen, Aktualisieren oder Archivieren von Wissensdatenbanken oder Einträgen; dies sind separate REST-Operationen.
- Kombinieren Sie query nicht mit knowledge_item_id oder knowledge_revision_id; wählen Sie pro Aufruf entweder die Suchanfrage oder den adressierten Lesevorgang.
- Behandeln Sie eine adressierte historische Revision nicht als Ergebnis der aktuellen Abfragesuche; die Abfragesuche folgt stets der current_revision_id veröffentlichter Elemente.
Erforderlicher Scope
- knowledge:read ist erforderlich; das Tool ist strikt lesend und erzeugt kein Knowledge-Audit-Ereignis.
- TOOL_CATALOG stuft search_knowledge als erweiterte Oberfläche mit min_tier=free und hidden_but_callable=true ein; es ist nicht Teil der minimalen Marketplace-Tool-Liste.
- Der Server löst den authentifizierten Eigentümer- oder Teamkontext auf und akzeptiert keine vom Aufrufer übergebenen Eigentümer- oder Bereichsfilter.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
query | string · Standard: empty | Natürlichsprachliche Abfrage für bewertete Suche; erforderlich im Abfragemodus und schließt adressierte Bezeichner aus. |
knowledge_base_id | string · Standard: empty | Optionale exakte Wissensdatenbank-ID zur Eingrenzung der Suche oder Validierung eines adressierten Elements. |
knowledge_item_id | string · Standard: empty | Exakte autorisierte Element-ID für den adressierten Lesevorgang. |
knowledge_revision_id | string · Standard: empty | Optionale exakte unveränderliche Revisions-ID für das adressierte Element; erfordert knowledge_item_id. |
offset | integer · Standard: 0 | Nullbasierter Zeichen-Offset für adressierte Inhalte. |
limit_chars | integer · Standard: 4000 | Inhaltsfenster für adressiertes Lesen von 1 bis 10000 Zeichen an der MCP-Grenze. |
max_results | integer · Standard: 10 | Maximale Anzahl von Suchergebnissen (1 bis 50). |
mode | string · Standard: hybrid | Bewertungsmodus der Abfrage: hybrid, lexical, semantic oder rrf. Unbekannte Werte werden vom MCP-Handler auf hybrid normalisiert. |
alpha | number · Standard: 0.5 | Lexikalisches Gewicht im Hybridmodus, begrenzt von 0.0 bis 1.0; das semantische Gewicht beträgt 1 - alpha. |
Rückgabeschema
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.
Beispiele
search_knowledge({
query: "deployment runbook",
knowledge_base_id: "<knowledge-base-id>",
mode: "hybrid",
alpha: 0.5,
max_results: 10
})search_knowledge({
knowledge_item_id: "<knowledge-item-id>",
knowledge_revision_id: "<immutable-revision-id>",
offset: 0,
limit_chars: 4000
})Fehler
- 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.
Zugehörige Tools
- recall_context — Ein begrenztes Kontextpaket aus normalen XMemo-Erinnerungen statt aus Wissensdatenbankinhalten erstellen.
- search_memory — Strikte gezielte Suche auf der regulären Speicheroberfläche anwenden.
- remember — Einen explizit angeforderten dauerhaften Speicherfakt speichern, keine Wissensrevision.
Quelle: Wissensdatenbanken