> 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="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FhhOfMB6fKN1zohYjTJzq%2Fclipboard.png?alt=media&amp;token=0de8cf18-cb58-42bb-84b2-0603ddb793ee" alt="Agent 内置工具设置中的知识库搜索和知识库管理能力"><figcaption><p>検索は閲覧用、管理は資料変更用です。既定では最小権限から始めます。</p></figcaption></figure>
{% endstep %}

{% step %}

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

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

{% step %}

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

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

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

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FIdUbdTffaPFsqQbMbg05%2Fclipboard.png?alt=media&amp;token=bccbea1c-dfcd-402c-b418-bd3b419e6516" alt="说明 Agent 内置工具、知识库、技能和 MCP 各自用途的选择关系图"><figcaption><p>資料の参照にはナレッジベース、繰り返し使う手法にはスキル、外部システムへのアクセスにはMCPを使います。権限を広げて曖昧なタスクを埋め合わせてはいけません。</p></figcaption></figure>

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

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

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

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

## Agentの設定はどのように連動するか

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FxhYbDEol5dz2ABjHqfVf%2Fclipboard.png?alt=media&amp;token=f14ffe34-c421-4135-92db-e431ce8512d6" alt="模型分工、可用能力和安全边界共同作用于 Agent 任务与交付结果的架构图"><figcaption><p>モデルが理解と生成を担い、ナレッジベースが証拠を提供し、権限がAgentの実行可能範囲を決めます。</p></figcaption></figure>

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

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

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

### FAQの更新

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

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

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

## 設定説明

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

## ユーザー事例

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

完成基準は、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="/docs/jp/knowledge-base/chat.md">会話で使用する</a></td></tr><tr><td><strong>データ、プライバシー、保守</strong></td><td>権限、クラウドサービス、バックアップの境界を理解する。</td><td><a href="/docs/jp/knowledge-base/data.md">データ、プライバシーとメンテナンス</a></td></tr><tr><td><strong>ナレッジベースの活用事例</strong></td><td>アフターサービスと調査のワークフローを参照する。</td><td><a href="/docs/jp/knowledge-base/cases.md">ナレッジベース活用事例</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.