> 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/create-agent.md).

# 创建 Agent 与模型分工

创建入口：左侧导航【工作】→【添加智能体】。

新建向导分为【基础信息】、【设定人格】、【技能】和【知识库】四步。名称与主模型是创建所需的基础项，其他内容可以之后补充。

<figure><img src="/files/7vjLQxwittFjxrlp9q75" alt="创建 Agent 的四步向导、主模型和用途说明"><figcaption><p>创建向导先完成名称和主模型，技能与知识库可按用途添加。</p></figcaption></figure>

## 四步怎么填写

{% stepper %}
{% step %}

### 1. 基础信息

名称写成岗位或任务类型，例如“合同检查”“内容策划”。描述只用于帮助识别用途。主模型负责主要推理和执行；不确定时使用已经验证可用的默认模型。
{% endstep %}

{% step %}

### 2. 设定人格

写清角色、目标、边界和输出方式。与其堆砌形容词，不如给出可执行规则：先列风险，再引用原文，最后给出修改建议；遇到资料不足时明确标记，不要猜测。
{% endstep %}

{% step %}

### 3. 选择技能

只选择与这个 Agent 长期工作方式有关的技能。技能可以在【设置】→【技能】安装，也可以之后让 Agent 帮你查找和安装。
{% endstep %}

{% step %}

### 4. 绑定知识库

只绑定 Agent 确实需要检索的知识库。未绑定知识库时，知识库搜索和管理工具不会出现在该 Agent 的工具列表中。
{% endstep %}
{% endstepper %}

<figure><img src="/files/kAA6zmK3mVlgCVFIqlvL" alt="Agent 编辑窗口中的主模型、Plan 模型和 Small 模型设置"><figcaption><p>先选好主模型；只有任务确实需要规划分工或轻量处理时，再配置 Plan 模型和 Small 模型。</p></figcaption></figure>

## 创建后继续配置

在 Agent 列表打开菜单并选择编辑，可以调整以下内容：

* 【基础】：主模型、Plan 模型、Small 模型、权限模式和心跳检测；
* 【提示词】：角色说明、处理规则和行为边界；
* 【内置工具】：文件、搜索、图片、通知、定时任务、记忆、子智能体和工作流等；
* 【知识库】：限制 Agent 可以访问的知识库；
* 【MCP】：绑定已经连接的 MCP 服务器；
* 【技能】：选择已安装技能；
* 【高级】：为确实需要的工具设置环境变量。

{% hint style="info" %}
当前编辑窗口会自动保存修改。关闭窗口前若仍有待保存内容，应用会先完成保存；保存失败时窗口会保持打开并显示错误。
{% endhint %}

## 推荐起点

| 配置项      | 产品默认值       | 建议起点              | 作用             | 适用场景       | 注意事项               |
| -------- | ----------- | ----------------- | -------------- | ---------- | ------------------ |
| 主模型      | 使用创建时选择的模型  | 选择一个已验证能稳定调用工具的模型 | 主要推理和执行        | 所有 Agent   | 不写死某个模型名称，按服务可用性选择 |
| Plan 模型  | 与主模型相同      | 先保持与主模型一致         | 任务拆解和决策        | 复杂多步骤工作    | 模型越多，排错变量越多        |
| Small 模型 | 与主模型相同      | 先保持与主模型一致         | 简单判断和格式化       | 高频轻量步骤     | 确认服务商支持对应调用方式      |
| 权限模式     | 【逐次确认】      | 涉及真实文件时保持【逐次确认】   | 决定工具是否需要批准     | 文件、终端和网络任务 | 【完全访问】可能删除文件或访问网络  |
| 心跳检测     | 开启，间隔 30 分钟 | 没有持续任务时可关闭        | 让 Agent 定期检查工作 | 监控、持续协作    | 不是日报调度；固定时间用定时任务   |

## 用户案例：合同检查 Agent

创建“合同检查”Agent，主模型选择已经验证的模型，在提示词中要求按“风险条款、原文位置、影响、建议”输出，绑定公司制度知识库，权限保持【逐次确认】。每份合同新建一个任务并选择对应文件目录，避免不同客户资料混在同一上下文中。

<details>

<summary>为什么创建时没有看到 MCP 和权限的完整设置？</summary>

创建向导只保留常用步骤。创建完成后打开 Agent 编辑窗口，可在【基础】【内置工具】【知识库】【MCP】【技能】和【高级】中继续配置。

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