search_knowledge

呼び出す前にread shapeを選ぶ

ranked searchにはqueryを使い、addressed readにはknowledge_item_idを使います。exact immutable revisionを指定する必要がある場合だけknowledge_revision_idを追加します。

公開 MCP ツール

search_knowledge

用途

認可されたKnowledge Base contentを、published current revisionに対するranked queryまたはbounded content pagination付きのexact item/revision readで取得します。

適用シーン

current published contentをlexical、semantic、hybrid、またはRRF evidenceでrankする必要があるとき、認可済みKnowledge Base全体でtopicを検索します。
1つのexact Knowledge itemと、そのcurrent revisionまたは指定されたimmutable revisionを読み取ります。
revisionがcallerのcontext budgetより大きい場合、offsetとlimit_charsでbounded content windowを使います。

非推奨シーン

通常のXMemo memory recallには使わないでください。memory surfaceではrecall、search_memory、またはrecall_contextを使います。
Knowledge Baseやitemのcreate、publish、update、archiveには使わないでください。それらは別のREST/service operationです。
queryをknowledge_item_idまたはknowledge_revision_idと混在させないでください。各callではquery searchかaddressed readのどちらかを選びます。
addressed historical revisionをcurrent query-search resultとして扱わないでください。query searchは各published itemのcurrent_revision_idを意図的に追跡します。

必須スコープ

knowledge:readが必要です。このtoolはstrictly read-onlyで、Knowledge audit eventを発行しません。
TOOL_CATALOGはsearch_knowledgeをmin_tier=free、hidden_but_callable=trueのadvanced surfaceに分類します。minimal public marketplace-app tool listには含まれません。
serverは認証済みownerまたはteam-bound contextを解決し、callerがownerやscope filterを指定することはできません。

パラメーター

名前	型	説明
`query`	string · デフォルト: empty	ranked search用のnatural-language queryです。query modeでは必須で、addressed identifierとは相互排他的です。
`knowledge_base_id`	string · デフォルト: empty	query searchを絞り込むかaddressed itemを検証するための、任意のexact Knowledge Base IDです。
`knowledge_item_id`	string · デフォルト: empty	addressed readに使うexact authorized item IDです。
`knowledge_revision_id`	string · デフォルト: empty	addressed item用の任意のexact immutable revision IDです。knowledge_item_idが必要です。
`offset`	integer · デフォルト: 0	addressed contentのzero-based character offsetです。
`limit_chars`	integer · デフォルト: 4000	MCP boundaryで1から10000文字までのaddressed-read content windowです。
`max_results`	integer · デフォルト: 10	query resultの最大数で、1から50までです。
`mode`	string · デフォルト: hybrid	query scoring modeです。hybrid、lexical、semantic、rrfを使えます。認識できないtextはMCP handlerがhybridにnormalizeします。
`alpha`	number · デフォルト: 0.5	0.0から1.0にclampされるhybrid lexical weightで、semantic weightは1-alphaです。

返却スキーマ

Queryは{"type":"knowledge_search","results":[...]}を含むJSON textを返します。各resultにはcurrent knowledge item/revision IDs、title、bounded excerpt、source/citation、reference、scoresが含まれます。Addressed readはtype='knowledge'のJSON textを返し、owner/team/scope、base/item/revision IDs、title、bounded content、locator、source、reference、content_offset、content_limit、content_total_chars、content_truncatedを含みます。このtoolはaudit envelopeを返しません。

使用例

current published knowledgeを検索する

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

pinned revisionをchunkで読み取る

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

エラー

knowledge_runtime_disabled: runtime switchがoffで、toolはknowledge_unavailable envelopeを返します。これはoperational stateであり、unrestricted memoryへのfallbackではありません。
knowledge_invalid_request: queryをaddressed IDと混在させた、offset/limit_chars/max_resultsが範囲外、またはrequest shapeが無効です。
knowledge_query_requiredまたはknowledge_item_required: queryもaddressed itemも指定されていないか、knowledge_item_idなしでknowledge_revision_idが指定されています。
knowledge_resource_unavailable: addressed base、item、revisionが存在しない、認可されていない、inactive、またはpublished itemではありません。
Authorization or validation failure: callerにknowledge:readがない、queryがinput limitを超える、またはboundary valueが不正です。

recall_context — Knowledge Base contentではなく通常のXMemo memoryからbounded context packを作成します。
search_memory — 通常のmemory surfaceでstrict targeted retrievalを使います。
remember — Knowledge revisionではなく、明示的に依頼されたdurable memory factを保存します。

出典: Knowledge Bases