> 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/cherry-studio/preview/agent.md).

# 工作-智能體

畀 AI 自主執行任務嘅智能體

**工作**（又叫 **智能體 / Agent**）係 Cherry Studio 入面一套可以 **自動調用工具、讀寫文件、跨多步完成任務** 嘅系統——同"對話助手"（一個角色預設）唔係一回事。入口喺 **左側導航欄嘅【工作】**（唔係舊版教程入面嘅頂部標籤）。

{% hint style="success" %}
最慳事嘅用法：先同 Agent 講你想完成咩，等佢自己檢查仲缺邊啲模型 / 工具 / 知識庫 / 頻道；需要精確控制時再手動調。
{% endhint %}

<figure><img src="https://2742912793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-f42ea7ff1326aba8aae108e24d22e9b2bb237b42%2Fagent-work-overview.png?alt=media" alt=""><figcaption><p>【工作】界面：頂部依次選擇智能體、模型同工作目錄，喺下方輸入任務；左側管理任務同工作目錄</p></figcaption></figure>

## 佢可以做咩

* **讀寫文件**：俾佢一個 **工作目錄**，佢就可以喺入面讀、改、生成文件。
* **調用工具**：內置工具，加上你掛載嘅 [技能](/docs/zhong-wen-fan-ti/advanced-basic/extensions/skills.md) 同 [MCP](/docs/zhong-wen-fan-ti/advanced-basic/extensions/mcp.md) 外部工具。
* **多步推理 / 子任務**：拆解目標、派子智能體、跑後台命令。
* **接入自動化**：配合 [頻道](/docs/zhong-wen-fan-ti/advanced-basic/automation/channels.md) 派駐到 IM 平台、用 [定時任務](/docs/zhong-wen-fan-ti/advanced-basic/automation/scheduled-heartbeat.md) 定時執行。

## 快速上手

1. 打開【工作】，揀一個 Agent；冇就撳【添加智能體】，按四步（基礎信息 / 人格 / 技能 / 知識庫）創建。內置嘅 **Cherry Assistant** 可以直接用。
2. 需要處理本地文件時，揀一個 **工作目錄**；唔涉及文件用預設工作區就得。
3. 用"要交付咩、可用邊啲資料、點樣先算完成"嚟描述任務。
4. 喺右側面板睇 **狀態 / 文件 / 子任務 / 消息流**；開咗開發者模式仲可以睇 **調用鏈**。

## 權限模式

Agent 執行文件 / 命令操作時，可選 **逐次確認 / 自動接受編輯 / 智能批准 / 只規劃 / 完全訪問** 五種權限模式，由最謹慎到最放手。無人值守跑任務（如頻道、定時任務）時先至用更放手嘅模式。

***

## 想再深入啲？

完整用法睇進階教程：

* [Agent 工作區](/docs/zhong-wen-fan-ti/advanced-basic/agent-workspace.md) —— 由創建到交付嘅完整工作方式
* [創建 Agent 同模型分工](/docs/zhong-wen-fan-ti/advanced-basic/agent-workspace/create-agent.md)
* [工作目錄、任務同文件](/docs/zhong-wen-fan-ti/advanced-basic/agent-workspace/workspaces-tasks-files.md)
* [內置工具、知識庫、技能同 MCP](/docs/zhong-wen-fan-ti/advanced-basic/agent-workspace/tools-knowledge-skills-mcp.md)
* [權限、記憶同後台任務](/docs/zhong-wen-fan-ti/advanced-basic/agent-workspace/permissions-memory-background.md)

***

### 攞幫助同提交意見

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改善建議，請參考 [反饋與建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。


---

# 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/cherry-studio/preview/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.