> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/knowledge-base/agent.md).

# Agent と一緒に使う

ナレッジベースを Agent に紐づけると、Agent は複数ステップのタスクで承認済み資料を検索・参照できます。資料の更新が明確に必要な場合は、ナレッジベース管理も有効化できます。

{% hint style="info" %}
通常の対話は一問一答に適しており、Agent は継続的な調査、比較、ファイル生成、ステップごとの確認に適しています。Agent は設定で紐づけられたナレッジベースのみにアクセスします。
{% endhint %}

## 通常の対話と Agent の違い

| 通常の対話                   | Agent                        |
| ----------------------- | ---------------------------- |
| 各メッセージの前に一時的にナレッジベースを選択 | Agent 設定で長期的に紐づける            |
| 即時のQ\&Aや短い比較に適する        | 複数ステップの調査とファイル納品に適する         |
| 主に検索で見つかった断片を使って回答する    | 資料を検索でき、権限に基づいてナレッジベースを管理できる |
| 現在の会話が資料の範囲を決定する        | Agent の設定がアクセス可能範囲を決定する      |

## 読み取り専用ナレッジベース Agent を設定する

{% stepper %}
{% step %}

### 1. まずナレッジベースを合格レベルまで検収する

対象資料が準備済みであることを確認し、実際の質問で検索テストを完了する。Agent は欠落した本文や誤った分割を補えない。
{% endstep %}

{% step %}

### 2. Agent の編集画面を開く

【作業】に入り、対象 Agent を選択し、メニューで【エージェントを編集】を開く。
{% endstep %}

{% step %}

### 3. 必要最小限のナレッジベースを紐づける

【ナレッジベース】タブを開き、【ナレッジベースを追加】をクリックする。このタスクに必要な庫だけを紐づけ、部署間やバージョン間の資料が干渉しないようにする。
{% endstep %}

{% step %}

### 4. ナレッジベース検索を有効化する

【内蔵ツール】を開き、【ナレッジベース検索】を有効にする。読み取り専用の調査、Q\&A、要約、比較なら通常ここまでで十分。

<figure><img src="/files/f4378bfc55b82c0d620a9e811458b52acba3a568" alt="Agent 内置工具设置中的知识库搜索和知识库管理能力"><figcaption><p>検索は参照用、管理は資料変更用。デフォルトでは最小権限から始める。</p></figcaption></figure>
{% endstep %}

{% step %}

### 5. 境界が明確なタスクでテストする

Agent にまず出典を列挙させ、その後で結論を出させる。資料が裏付けない内容は明記させ、常識で補完することを許可しない。
{% endstep %}

{% step %}

### 6. 出典と成果物を検収する

各結論がどのナレッジベースに由来するか、ファイル内の事実と提案が分けられているか、証拠のない部分に印が付いているかを確認する。
{% endstep %}
{% endstepper %}

## 内蔵ツール、ナレッジベース、スキル、MCP の選び方

<figure><img src="/files/b6beb2514fff587db11871f8a59ffdfe859c1947" alt="说明 Agent 内置工具、知识库、技能和 MCP 各自用途的选择关系图"><figcaption><p>資料の参照にはナレッジベース、繰り返し方法にはスキル、外部システムへのアクセスには MCP を使う。権限を拡大して曖昧なタスクを補うべきではない。</p></figcaption></figure>

## ナレッジベースの検索と管理

| 機能        | できること                     | 適用タスク         | デフォルト推奨                |
| --------- | ------------------------- | ------------- | ---------------------- |
| ナレッジベース検索 | 紐づけ済みナレッジベースを検索・一覧表示・参照する | Q\&A、調査、要約、比較 | 有効のまま維持                |
| ナレッジベース管理 | ナレッジベース文書の追加、削除、更新        | 承認済み資料の保守     | デフォルトでは無効、必要時のみ一時的に有効化 |

{% hint style="warning" %}
ナレッジベースを紐づけても、別のナレッジベースが複製されるわけではありません。資料を更新または再インデックスした後、Agent の次回検索では更新後の内容が使われます。
{% endhint %}

{% hint style="danger" %}
【ナレッジベース管理】を有効にすると、追加・削除・更新によって資料または索引が変更されます。承認前に、対象ナレッジベース、具体的な項目、同名衝突時の扱い、ロールバック方法を確認してください。
{% endhint %}

## Agent の設定はどのように相互作用するか

<figure><img src="/files/fec1ad5c1c30e324d03a4c4a40fba5c35ab5c369" alt="模型分工、可用能力和安全边界共同作用于 Agent 任务与交付结果的架构图"><figcaption><p>モデルが理解と生成を決め、ナレッジベースが証拠を提供し、権限が Agent の実行可能範囲を決めます。</p></figcaption></figure>

## 推奨タスクテンプレート

### 調査してレポートを生成する

> 紐づけ済みナレッジベースから、海外出張の承認と保険に関する規定をすべて洗い出す。まず出典と矛盾点を列挙し、その後で Markdown のチェックリストを生成する。資料で裏付けられない内容は補完しない。

### FAQ を更新する

> 宿泊費精算の既存項目を検索し、最新制度と旧FAQを比較する。まず修正候補リストを示し、承認を得てから関連文書を更新する。

### 複数ナレッジベース比較

> 「製品マニュアル」と「アフターサービス事例」のナレッジベースからそれぞれ証拠を探し、「公式ルール / 実例 / 推奨フレーズ」の3列で整理する。各結論には出典名を残す。

## 設定の説明

| 設定項目         | 推奨の出発点       | いつ追加するか           | リスク管理                    |
| ------------ | ------------ | ----------------- | ------------------------ |
| ナレッジベースを紐づける | 1 つのタスク関連庫   | 明確に複数庫の比較が必要な場合   | プロンプトで各庫の用途を明確に書く        |
| ナレッジベース検索    | 有効にする        | タスクで資料参照が必要な限り    | 出典が紐づけ範囲に由来するか検収する       |
| ナレッジベース管理    | 無効           | 追加、削除、更新が明確に必要な場合 | 項目ごとに承認し、重要資料は先にバックアップする |
| 出力要件         | 事実、推論、提案を分ける | レポートやファイルの生成が必要   | 各事実に出典名を残す               |

## ユーザー事例

小林はアフターサービス Agent に【公式マニュアル】と【審査事例】を紐づけ、ナレッジベース検索のみを有効にした。彼は Agent にデバイス型番ごとに安全警告、公式手順、事例の提案を列挙させ、3つを分けるよう求めた。古い事例の更新が必要だと分かったときだけ、一時的に管理ツールを有効にし、まず修正候補リストを確認してから承認した。

達成基準は、Agent が未紐づけの資料にアクセスしないこと、事例の提案を公式ルールとして書かないこと、すべての書き込み操作に明確な対象と検収結果があること。

## 結果の検収

* 出典は現在の Agent に紐づけられたナレッジベースのみ。
* 検索結果がタスク内の各条件を網羅している。
* 納品物で、資料の事実、Agent の推論、提案が分けられている。
* 管理操作に対象、影響、結果が明記されている。
* 資料更新後に固定検索質問を再実行する。

## よくある質問

<details>

<summary>通常の対話では検索できるのに、なぜ Agent では検索できないのか？</summary>

対象ナレッジベースが現在の Agent に紐づいているか、また【ナレッジベース検索】が有効かを確認する。Agent ごとの紐づけ範囲は相互に継承されない。

</details>

<details>

<summary>ナレッジベース管理を有効にすべきでないのはいつ？</summary>

読み取り専用の調査、チーム共有の規定庫、履歴版を保持する資料庫は、デフォルトでは検索のみを有効にする。更新が必要なときだけ一時的に管理を有効にし、項目ごとに承認する。

</details>

<details>

<summary>Agent が未紐づけのナレッジベースを操作したがったら？</summary>

すべてのナレッジベースに拡大しない。タスクに本当に必要かを確認してから、対象庫を現在の Agent に追加するか、その庫に紐づけ済みの Agent を使う。

</details>

## 続きを読む

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>会話で使う</strong></td><td>出典付きの即時Q&#x26;Aを1回完了する。</td><td><a href="/pages/158ee40a85b9b879ef36382fea8b074795b0a56d">/pages/158ee40a85b9b879ef36382fea8b074795b0a56d</a></td></tr><tr><td><strong>データ、プライバシー、保守</strong></td><td>権限、クラウドサービス、バックアップの境界を理解する。</td><td><a href="/pages/1731dc3d21dfd63a18e7784003c212f3d875d167">/pages/1731dc3d21dfd63a18e7784003c212f3d875d167</a></td></tr><tr><td><strong>ナレッジベースの活用事例</strong></td><td>アフターサービスと調査のワークフローを参照する。</td><td><a href="/pages/ae8764244fa91a441efc76161df2852576aa35f7">/pages/ae8764244fa91a441efc76161df2852576aa35f7</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/jp/knowledge-base/agent.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.