> 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/zhong-wen-fan-ti/advanced-basic/agent-workspace/create-agent.md).

# 建立 Agent 同模型分工

建立入口：左側導航【工作】→【新增智能體】。

新建嚮導分為【基本資訊】、【系統提示詞】、【技能】同【知識庫】四步。第一步仲要揀運行模式；運行模式會決定 Agent 可用嘅模型分工、權限模式同部分工具，建立後唔可以切換。

<figure><img src="https://raw.githubusercontent.com/SiinXu/cherry-studio-docs/2446b25878f69e98f33d50623a3c4cf5e836680a/.gitbook/assets/cherry-guide-agent-runtime-picker.png" alt="创建 Agent 时选择 Claude Agent、Pi 或 DeepSeek Harness 运行模式"><figcaption></figcaption></figure>

### 運行模式點揀

| 運行模式               | 主要特點                | 模型配置                 | 權限同限制                                |
| ------------------ | ------------------- | -------------------- | ------------------------------------ |
| 【增強：Claude Agent】  | 能力面完整，適合複雜、多步驟任務    | 主模型、Plan 模型、Small 模型 | 支援全部權限模式同心跳檢測                        |
| 【快速：Pi】            | 回應快、開銷低，適合日常文件同編碼任務 | 只配置主模型               | 唔提供【僅規劃】；新建時預設【智能批准】                 |
| 【DeepSeek Harness】 | 兼容多種模型服務，支援目標驅動執行   | 只配置主模型               | 唔提供【智能批准】同心跳檢測；支援 `/compact`、`/goal` |

{% hint style="warning" %}
運行模式建立後唔可以更改。如果目標、模型兼容性或者權限需求有根本變化，請新建一個 Agent，而唔係繼續修改舊 Agent。
{% endhint %}

### 四步點填寫

{% stepper %}
{% step %}

#### 1. 基本資訊

名稱可以寫成崗位或者任務類型，例如「合約檢查」「內容策劃」。先揀運行模式，再揀頁面列出嘅兼容模型。描述只用嚟幫手識別用途；主模型負責主要推理同執行。
{% endstep %}

{% step %}

#### 2. 編寫系統提示詞

寫清角色、目標、邊界同輸出方式。與其堆砌形容詞，不如俾出可執行規則：先列風險，再引用原文，最後俾出修改建議；遇到資料不足時明確標記，唔好估測。
{% endstep %}

{% step %}

#### 3. 揀選技能

只揀同呢個 Agent 長期工作方式有關嘅技能。技能可以喺【設定】→【技能】安裝，亦可以之後等 Agent 幫你搵同安裝。
{% endstep %}

{% step %}

#### 4. 綁定知識庫

只綁定 Agent 真係需要檢索嘅知識庫。未綁定知識庫時，知識庫搜尋同管理工具唔會出現喺該 Agent 嘅工具列表入面。
{% endstep %}
{% endstepper %}

<figure><img src="https://3562065924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-90e09b4900c4d4ac6751921289d6b83d2945072b%2Fclipboard.png?alt=media" alt="Agent 编辑窗口中的主模型、Plan 模型和 Small 模型设置"><figcaption><p>先揀好主模型；只有任務真係需要規劃分工或者輕量處理時，先再配置 Plan 模型同 Small 模型。</p></figcaption></figure>

### 建立後繼續配置

喺 Agent 列表打開選單並揀編輯，可以調整以下內容：

* 【基本】：查看運行模式，並調整該模式支援嘅模型、權限同心跳設定；
* 【提示詞】：角色說明、處理規則同行為邊界；
* 【內置工具】：文件、搜尋、圖片、通知、定時任務、記憶、子智能體同工作流等；
* 【知識庫】：限制 Agent 可以存取嘅知識庫；
* 【MCP】：綁定已經連接嘅 MCP 伺服器；
* 【技能】：揀選已安裝技能；
* 【高級】：為真係需要嘅工具設定環境變數。

{% hint style="info" %}
而家編輯視窗會自動儲存修改。關閉視窗前如果仲有待儲存內容，應用會先完成儲存；儲存失敗時視窗會保持打開並顯示錯誤。
{% endhint %}

### 推薦起點

| 配置項             | 產品預設值                         | 建議起點                    | 作用             | 適用場景               | 注意事項                               |
| --------------- | ----------------------------- | ----------------------- | -------------- | ------------------ | ---------------------------------- |
| 運行模式            | 【增強：Claude Agent】             | 唔確定時先用【增強：Claude Agent】 | 決定模型分工、權限同工具範圍 | 所有 Agent           | 建立後唔可以切換                           |
| 主模型             | 使用建立時揀嘅模型                     | 揀一個已驗證可以穩定調用工具嘅模型       | 主要推理同執行        | 所有 Agent           | 選擇器會按運行模式過濾唔兼容模型                   |
| Plan / Small 模型 | 同主模型相同                        | 先保持同主模型一致               | 任務拆解、簡單判斷同格式化  | 僅【增強：Claude Agent】 | Pi 同 DeepSeek Harness 唔會顯示呢兩個欄位    |
| 權限模式            | Claude/DSH 係【逐次確認】；Pi 係【智能批准】 | 真實項目目錄優先使用【逐次確認】        | 決定工具使唔使批准      | 文件、終端同網絡任務         | 【完全存取】可能刪除文件或者存取網絡                 |
| 心跳檢測            | 支援嘅運行模式初始開啟，間隔 30 分鐘          | 冇持續任務時可以關閉              | 等 Agent 定期檢查工作 | Claude Agent、Pi    | DeepSeek Harness 唔提供心跳檢測；固定時間用定時任務 |

### 用戶案例：合約檢查 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/docs/zhong-wen-fan-ti/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.