> 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 は外部ツールとデータを接続します。

## 違いと組み合わせ

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

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

<figure><img src="/files/4ce811147c728dd8bed1a876e1b125581b62ae4d" alt="Agent 编辑窗口中的内置工具分类与开关"><figcaption><p>現在の作業に必要なツールだけを有効にすると、一覧が見やすくなり、権限要求の判断もしやすくなります。</p></figcaption></figure>

## 内蔵ツール

内蔵ツールはコンテキスト、ファイル、マルチメディア、オーケストレーション、検索、端末に分かれています。よく使う機能には次があります。

* 【画像生成】：設定済みの描画モデルを使用する；
* 【ナレッジベース検索】と【ナレッジベース管理】：ナレッジベースを紐付けた場合にのみ表示される；
* 【ウェブ検索】と【ウェブ取得】：Cherry Studio に設定済みのオンライン機能を使用する；
* 【記憶】：タスクをまたいで安定した情報を保存・検索する；
* 【定時タスク】と【通知】：Agent に計画を管理させ、結果をチャンネルへ送信する；
* 【Task】と【ワークフロー】：サブエージェントやオーケストレーションで複雑なタスクを処理する；
* ファイルと Bash ツール：ファイルの読み取り、作成、変更、およびコマンドの実行。

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

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

## スキル

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

## MCP

まず【設定】→【MCP】でサーバーを接続して起動し、その後 Agent 編集画面の【MCP】に戻って紐付けます。起動していないサーバーは有効化できません。接続後、そのサーバーが提供するツールは Agent のツール一覧に入り、引き続き権限モードの制御を受けます。

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

## 推奨組み合わせ

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

## ユーザー事例：マーケティングリサーチ Agent

Agent に製品資料のナレッジベースを紐付け、「研究レポート」スキルを有効化し、信頼できるウェブ検索 MCP を接続し、内蔵のウェブ取得とファイル書き込みツールを残しておきます。Agent はまず内部資料から製品範囲を確定し、次に外部情報を検索し、最後にスキルで定められた構成に従って作業ディレクトリへ書き込みます。内部資料、外部ソース、出力形式の担当範囲が明確になるため、その後の保守がしやすくなります。

<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.
