Agent 工作区

从创建到交付的完整工作方式

Agent 适合处理有明确目标、需要使用工具或文件、可能持续多个步骤的任务。入口是左侧导航【工作】，不是旧版教程中的顶部标签。

最省事的配置方式，是先告诉 Agent 你想完成什么，再让它检查缺少的模型、工具、知识库或频道。需要精确控制时，再打开 Agent 编辑窗口或【设置】手动调整。

工作目录、权限和完成标准贯穿整个任务；需要修改时回到计划阶段重新确认。

工作区由什么组成

部分	作用	何时需要关注
Agent	保存角色、模型、提示词与能力	同一类工作要重复进行时
任务	一次连续的工作记录	每个目标单独开任务，便于保留上下文
工作目录	Agent 可以直接处理的文件范围	代码、资料整理、文档生成等文件任务
输入区	发送目标、附件并调用工具	发起任务或追加要求
右侧面板	查看状态、文件、子任务和消息流	跟踪长任务、检查产物或排错

开始任务前先确认 Agent、模型、工作目录和右侧面板。

开始一个任务

1

1. 打开【工作】并选择 Agent

已有合适的 Agent 时直接选择；没有时点击【添加智能体】，完成基础信息、人格、技能和知识库四步创建。

2

2. 选择工作目录

需要处理本地文件时，选择本次任务所在目录；不涉及文件时可以使用应用创建的默认工作区。一个任务对应一个工作区，避免让 Agent 在不相关目录间来回查找。

3

3. 用结果描述任务

告诉 Agent 要交付什么、可以使用哪些资料、有哪些限制以及怎样算完成。例如：

阅读当前目录中的会议记录，整理出决策、负责人和截止时间，生成 action-items.md。不要修改原始文件。

4

4. 在右侧面板检查过程与产物

【状态】展示活动任务、子智能体、工作流和后台命令；【文件】可预览并编辑文本产物；开启开发者模式后还能查看【调用链】。

API 网关提示

Agent 运行依赖 Cherry Studio 的 API 网关。网关未启用时，应用会提示【启用并启动】；也可以到【设置】→【API 网关】检查端口、运行状态和本机安全软件拦截。

API 网关是 Agent 的运行依赖，但不等于要把接口公开到网络。保持默认本机使用即可；只有明确要让其他程序调用时，才需要复制 URL 和 API 密钥。

一个 Agent 还是多个 Agent

• 同一角色、同一套能力但任务不同：复用一个 Agent，新建多个任务。
• 角色、资料范围或权限不同：拆成多个 Agent。
• 一个目标需要并行研究或多个步骤协作：先让一个 Agent 使用子智能体或工作流，不必立刻手工创建很多 Agent。

用户案例：整理项目资料

产品经理把需求说明、访谈记录和竞品资料放在同一目录，创建“需求整理”Agent，绑定产品知识库并使用【逐次确认】权限。Agent 先读取资料，再将需求清单和待确认问题写入新文件。产品经理在右侧【文件】中直接修订文字，原始资料保持不变。

为什么 Agent 看不到刚绑定的能力？

Agent 编辑内容会自动保存。正在生成的回复不会被中断；模型、技能、MCP 和知识库等变化会从下一条消息开始生效。若仍未出现，先确认能力已启用，再新发一条消息。

删除工作目录会把磁盘文件一起删除吗？

在任务列表中删除工作目录时，只会移除 Cherry Studio 中的目录记录和该目录下的任务记录，不会删除磁盘上的真实目录。Agent 在任务执行中进行的文件操作仍受所选权限模式影响。