> 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/advanced-basic/agent-workspace/tools-knowledge-skills-mcp.md).

# 内蔵ツール、ナレッジベース、スキル、MCP

この4種類の能力はいずれも Agent を強化できますが、解決する問題は異なります。内蔵ツールは一般的な操作を担当し、ナレッジベースは検索可能な資料を限定し、スキルは作業方法を提供し、MCP は外部ツールとデータを接続します。

### 違いと組み合わせ

<figure><img src="/files/4ce811147c728dd8bed1a876e1b125581b62ae4d" alt="Agent 编辑窗口中的内置工具分类与开关"><figcaption></figcaption></figure>

| 機能      | 解決する問題                          | 例                                 |
| ------- | ------------------------------- | --------------------------------- |
| 内蔵ツール   | Agent が Cherry Studio 内で直接できること | ファイルの読み書き、Web検索、画像生成、メモリ、通知、定時タスク |
| ナレッジベース | Agent はどのようなプライベート資料を検索できるか     | 製品仕様、契約テンプレート、チームマニュアル            |
| スキル     | Agent はどのような手順と基準で作業すべきか        | 週報の形式、コードレビューのチェックリスト、執筆ルール       |
| MCP     | Agent はどの外部ツールとリソースに接続できるか      | データベース、ブラウザ、サードパーティの業務システム        |

設定パス：左側ナビゲーションの【仕事】→ Agent メニューを開く→【編集】→【内蔵ツール】。

### 内蔵ツール

内蔵ツールはコンテキスト、ファイル、マルチメディア、オーケストレーション、検索、ターミナルでグループ化されています。よく使う機能は次のとおりです：

* 【画像生成】：設定済みの描画モデルを使用します；
* 【ナレッジベース検索】と【ナレッジベース管理】：ナレッジベースをバインドした場合のみ表示されます；
* 【Web検索】と【Webスクレイピング】：Cherry Studio に設定済みのネット接続機能を使用します；
* 【メモリ】：タスクをまたいで安定した情報を保存し、検索します；
* 【定時タスク】と【通知】：Agent に予定管理をさせ、チャンネルへ結果を送信します；
* 【Task】と【ワークフロー】：サブエージェントやオーケストレーションで複雑なタスクを処理します；
* 【ファイルを Markdown に変換】：作業ディレクトリまたは現在の会話の添付ファイル内の PDF、Word、PowerPoint、Excel、OpenDocument、RTF、EPUB、CSV を読み取り、構造化された内容を Agent に分割処理させます；
* 会話連携ツール：既存の Agent セッションを検索し、独立したセッションを新規作成し、タスクを送信して追跡可能な完了結果を受け取ります；
* ファイルと Bash ツール：ファイルの読み取り、作成、変更、およびコマンドの実行。

{% hint style="info" %}
【ファイルを Markdown に変換】は元ファイルを書き換えませんし、スキャン版 PDF の OCR も提供しません。スキャン文書は先に【OCR】または文書処理機能を使ってから Agent に渡してください。
{% endhint %}

### ナレッジベースの範囲

【ナレッジベース】で選択されたナレッジベースが、その Agent の検索範囲になります。未選択の場合、ナレッジベースツールは読み込まれません。複数選択した場合でも、Agent はそれらのナレッジベース内でのみ動作し、他の資料庫を自動的には読みません。

### スキル

【スキル】で、インストール済みのスキルを有効にします。スキルの内容は Agent の作業環境に入り、手順と出力を制約するために使われます。新しいスキルが必要な場合は、【仕事】で Agent に直接検索とインストールを任せることができます。手動管理のパスは【設定】→【スキル】です。

### MCP

まず【設定】→【MCP】でサーバーを接続して起動し、その後 Agent 編集画面の【MCP】でバインドします。稼働していないサーバーは有効化できません。接続後、そのサーバーが提供するツールは Agent のツール一覧に入り、引き続き権限モードの制御を受けます。サーバーがリソースやプロンプトも提供している場合は、入力欄の【+】パネルから直接選択して使用できます。

{% hint style="danger" %}
ツールを開放したからといって、承認を飛ばしてよいわけではありません。ファイル書き込み、ターミナル、外部データの変更、課金の可能性がある画像生成については、優先的に【都度確認】を維持してください。信頼できる出所で、リスクが明確なツールだけを、より緩い権限で使いましょう。
{% endhint %}

### 推奨の組み合わせ

| タスクに必要なもの      | 推奨組み合わせ               | いつ追加するか                   | 注意事項               |
| -------------- | --------------------- | ------------------------- | ------------------ |
| ローカルファイルの処理    | ファイルツール + 専用ワークディレクトリ | 固定形式が必要なときはスキルを追加         | まず【都度確認】を維持する      |
| 社内資料に基づいて回答する  | ナレッジベース + ナレッジベース検索   | 安定して呼び出せるようになってからチャンネルへ渡す | まず答えのない問題でテストする    |
| 固定の手順を繰り返し実行する | スキル + 必要な内蔵ツール        | 外部データが必要な場合に MCP を追加      | スキルにアカウント秘密鍵を保存しない |
| 外部システムを呼び出す    | MCP + 最小権限の認証情報       | タスクが安定してから承認を緩和する         | 書き込み、削除、課金操作は確認が必要 |

### ユーザー事例：市場調査 Agent

Agent に製品資料のナレッジベースをバインドし、「調査レポート」スキルを有効化し、信頼できる Web 検索 MCP を接続し、内蔵の Web スクレイピングとファイル書き込みツールを保持します。Agent はまず社内資料から製品範囲を特定し、その後外部情報を検索し、最後にスキルで定義された構成に従って作業ディレクトリへ書き込みます。社内資料、外部ソース、出力形式の役割が明確に分かれるため、後から保守しやすくなります。

<details>

<summary>ナレッジベースをバインドしたのに、なぜ検索結果がないのですか？</summary>

ナレッジベースの処理が完了していて、検索可能な内容が含まれていることを確認し、そのうえで Agent 編集画面でのバインドがまだ残っているか確認してください。ナレッジベースが削除されると、関連するバインドは自動的に削除されます。

</details>

<details>

<summary>スキルを有効にしたらタスクを再開する必要がありますか？</summary>

タスクを閉じる必要はありません。Agent を編集すると、次のメッセージから新しいスキル設定が読み込まれます。生成中の返信は中断されません。

</details>

<details>

<summary>スキルを有効にしたらタスクを再開する必要がありますか？</summary>

タスクを閉じる必要はありません。Agent を編集すると、次のメッセージから新しいスキル設定が読み込まれます。生成中の返信は中断されません。

</details>


---

# 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/advanced-basic/agent-workspace/tools-knowledge-skills-mcp.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.
