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

# Agent 工作區

Agent 啱處理有明確目標、需要用工具或者檔案、而且可能會持續多個步驟嘅任務。入口係左邊導航【工作】，唔係舊版教程入面嘅頂部標籤。

{% hint style="success" %}
最慳事嘅配置方式，係先同 Agent 講你想完成乜，再等佢檢查缺少嘅模型、工具、知識庫或者頻道。需要精準控制時，再打開 Agent 編輯窗口或者【設定】手動調整。
{% endhint %}

<figure><img src="/files/a24314de50f31a040d15629246490e8b9b0375d9" alt="Agent 从说明交付物、选择工作目录到检查文件和结果的任务闭环图"><figcaption><p>工作目錄、權限同完成標準會貫穿成個任務；需要修改時，返去計劃階段重新確認。</p></figcaption></figure>

## 工作區由乜組成

| 部分    | 作用                | 幾時需要留意              |
| ----- | ----------------- | ------------------- |
| Agent | 保存角色、模型、提示詞同能力    | 同一類工作要重複做嘅時候        |
| 任務    | 一次連續嘅工作記錄         | 每個目標獨立開一個任務，方便保留上下文 |
| 工作目錄  | Agent 可以直接處理嘅檔案範圍 | 程式碼、資料整理、文件生成等檔案任務  |
| 輸入區   | 發送目標、附件同叫用工具      | 發起任務或者追加要求          |
| 右側面板  | 睇狀態、檔案、子任務同消息流    | 跟蹤長任務、檢查產物或者排錯      |

<figure><img src="/files/fc057a6fe0013b22be8bf5ebcc416a2e3b95343c" alt="Agent 工作区中的 Agent、模型、工作目录和右侧面板"><figcaption><p>開始任務前先確認 Agent、模型、工作目錄同右側面板。</p></figcaption></figure>

## 開始一個任務

{% stepper %}
{% step %}

### 1. 打開【工作】並選擇 Agent

如果已經有合適嘅 Agent 就直接揀；如果冇，就撳【添加智能體】，完成基礎資訊、人格、技能同知識庫四步創建。
{% endstep %}

{% step %}

### 2. 選擇工作目錄

需要處理本機檔案時，揀今次任務所在目錄；如果唔涉及檔案，可以用應用程式建立嘅預設工作區。一個任務對應一個工作區，避免 Agent 喺唔相關目錄之間來回搵。
{% endstep %}

{% step %}

### 3. 用結果描述任務

同 Agent 講要交付乜、可以用咩資料、有咩限制，同埋點先算完成。例如：

```
閱讀目前目錄入面嘅會議記錄，整理出決策、負責人同截止時間，生成 action-items.md。唔好修改原始檔案。
```

{% endstep %}

{% step %}

### 4. 喺右側面板檢查過程同產物

【狀態】會顯示活動任務、子智能體、工作流同背景命令；【檔案】可以預覽同編輯文字產物；開咗開發者模式之後仲可以睇【調用鏈】。
{% endstep %}
{% endstepper %}

## API 閘道提示

Agent 運行依賴 Cherry Studio 嘅 API 閘道。閘道未啟用時，應用程式會提示【啟用並啟動】；亦可以去【設定】→【API 閘道】檢查埠、運行狀態同本機安全軟件阻擋。

{% hint style="warning" %}
API 閘道係 Agent 嘅運行依賴，但唔等於要將介面公開到網絡。保持預設本機使用就得；只有明確要畀其他程式調用時，先需要複製 URL 同 API 密鑰。
{% endhint %}

## 一個 Agent 定係多個 Agent

* 同一角色、同一套能力但任務唔同：重用一個 Agent，新建多個任務。
* 角色、資料範圍或者權限唔同：拆成多個 Agent。
* 一個目標需要並行研究或者多步驟協作：先叫一個 Agent 用子智能體或者工作流，唔使即刻手工建立好多 Agent。

## 用戶案例：整理項目資料

產品經理將需求說明、訪談記錄同競品資料放喺同一個目錄，建立「需求整理」Agent，綁定產品知識庫並使用【逐次確認】權限。Agent 先讀取資料，再將需求清單同待確認問題寫入新檔案。產品經理喺右側【檔案】入面直接修訂文字，原始資料保持不變。

<details>

<summary>點解 Agent 睇唔到剛綁定嘅能力？</summary>

編輯 Agent 內容會自動保存。正在生成嘅回覆唔會被中斷；模型、技能、MCP 同知識庫等變更會由下一條消息開始生效。如果仲未出現，先確認能力已啟用，再重新發一條消息。

</details>

<details>

<summary>刪除工作目錄會連磁碟檔案一齊刪咗咩？</summary>

喺任務列表刪除工作目錄時，只會移除 Cherry Studio 入面嘅目錄記錄同該目錄底下嘅任務記錄，唔會刪除磁碟上真正嘅目錄。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/zhong-wen-fan-ti/advanced-basic/agent-workspace.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.