# search_knowledge

published current Knowledge revisionを検索するか、1つのexact authorized itemとimmutable revisionをbounded pagination付きで読み取ります。

- Canonical: https://docs.xmemo.dev/ja/docs/tools/search-knowledge
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: 0310677a87145c1efaa396cd0aa2c2893ad43e7f2bff4548b876ab6d5b61ac0e
- Edition-Digest: 9b332cac80258cf59ce3504e64b4b4c97952e6bc43886b6734e7245764abdd5d
- Source-Revision: sha256:f9db1cd4b6ed36f17d373c2a7c050c7e3ba83004cace01216f0ec51ea5b5b265

## Tool Reference: `search_knowledge`

### Purpose

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

### Parameters

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

### Returns

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を返しません。

### Errors

- 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が不正です。

### Examples

#### current published knowledgeを検索する



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

#### pinned revisionをchunkで読み取る



```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): Knowledge Base contentではなく通常のXMemo memoryからbounded context packを作成します。
- [search_memory](/docs/tools/search): 通常のmemory surfaceでstrict targeted retrievalを使います。
- [remember](/docs/tools/remember): Knowledge revisionではなく、明示的に依頼されたdurable memory factを保存します。

## 呼び出す前にread shapeを選ぶ

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