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

# 内置工具、知识库、技能与 MCP

这四类能力都能增强 Agent，但解决的问题不同：内置工具负责常见操作，知识库限定可检索资料，技能提供工作方法，MCP 连接外部工具和数据。

### 区别与组合

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

| 能力   | 解决的问题                         | 例子                        |
| ---- | ----------------------------- | ------------------------- |
| 内置工具 | Agent 在 Cherry Studio 内能直接做什么 | 读写文件、网页搜索、生成图片、记忆、通知、定时任务 |
| 知识库  | Agent 可以检索哪些私有资料              | 产品规范、合同模板、团队手册            |
| 技能   | Agent 应按什么流程和标准工作             | 周报格式、代码审查清单、写作规范          |
| MCP  | Agent 可以连接哪些外部工具与资源           | 数据库、浏览器、第三方业务系统           |

配置路径：左侧导航【工作】→ 打开 Agent 菜单→【编辑】→【内置工具】。

### 内置工具

内置工具按上下文、文件、多媒体、编排、搜索和终端分组。常用能力包括：

* 【生成图片】：使用已配置的绘画模型；
* 【知识库搜索】与【知识库管理】：只在绑定知识库后出现；
* 【网页搜索】与【网页抓取】：使用 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 绑定产品资料知识库，启用“研究报告”技能，连接一个可信的网页检索 MCP，并保留内置网页抓取和文件写入工具。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/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.
