Multi-Agent
Multi-Agent 让一个根 Agent 组织多个子 Agent。每个子 Agent 有自己的任务、对话和模型运行,但仍属于同一棵协作树;根 Agent 负责分工、跟进、整合和向你交付结果。
什么时候适合使用
适合并行且边界清楚的工作,例如:
- 一个 Agent 阅读前端,一个阅读后端,最后交叉核对。
- 并行研究多个候选方案或资料来源。
- 实现、测试和文档分别审查。
- 让一个子 Agent 专注复现问题,另一个检查历史变更。
不适合把强依赖的连续小步骤全部拆开。子 Agent 之间的沟通和上下文复制也有成本;简单任务通常由一个 Agent 更快完成。
当前使用方式
目前没有面向用户的“创建子 Agent”按钮。你需要在根对话中明确要求根 Agent 分工,例如:
请把这个项目的评审拆成三个相互独立的子任务:前端交互、Rust 核心、测试与发布。并行完成后交叉检查,最后由你汇总。所有子任务先只读。
根 Agent 可以使用协作工具创建子 Agent、发送消息、安排后续任务、等待结果、查看树或中断后代。是否实际拆分仍取决于当前模型能否正确调用这些工具;可以在提示中要求它报告分工和每个子任务的状态。
每个任务使用整棵协作树内唯一、创建后固定的名称。后续跟进、等待或中断都使用这个名称,不需要复制内部编号或路径。任务完成后名称仍保留;要继续同一个子任务,可以直接说“让前端审查继续检查审批交互”。
主 Agent 的协作名称固定为“主智能体”,聊天标题可以单独修改;子任务不能使用这个保留名称。子任务宜使用“前端检查”“核心检查”这样的简短名称。
创建子 Agent 模板
模板可以固定常用角色的名称、说明、指令和模型:
- 先添加一个项目。
- 打开“设置 → 子智能体”。
- 点击“新建模板”,填写名称、简短描述和完整指令。
- 选择一个已启用模型。
- 选择可以使用该模板的一个或多个项目并保存;也可以先不分配,稍后再编辑。
模板保存在同一个工作区模板库中,通过项目分配控制可见范围。可以启停、编辑、重新分配或删除;修改只影响未来创建的子 Agent,已经创建的节点保留当时快照。
树内资源共享
同一 Agent 任务树中的根 Agent 和子 Agent 可以发现获准的父子对话附件,并继续使用树内生成的受管 Artifact 或 Agent 浏览器下载引用。系统从持久 Agent 树验证共同根身份,不接受模型自报的对话或根 ID;独立任务树和普通无关对话之间不会因此共享资源。
共享的是受管引用与读取能力,不是把宿主绝对路径暴露给模型,也不会扩大原任务的文件或命令权限。
在 Agent Center 中观察
当前根对话产生子 Agent 后,右侧栏会出现“子智能体”模块:
- “进行中”显示排队、运行和等待审批的子 Agent。
- “已结束”显示完成、失败、中断、结果未知、归档或停用状态。
- 打开一个子 Agent 可以查看它的只读对话和工具活动。
- 返回列表时会保留当前根任务的浏览位置。
子 Agent 对话是观察界面,不能直接输入消息、编辑历史或启动新运行。需要返工或补充时,在根对话中告诉根 Agent 对哪个子任务继续安排。
系统提示词要求 Agent 在汇报子任务当前状态前先查询一次最新状态,等待期间使用等待工具,避免不断查询。查询失败时应明确说尚未确认;“已结束”只说明那次运行结束,是否完成你的要求还要核对结果。主 Agent 自己等待审批时不会继续思考;审批恢复后要报告子任务状态,也应重新查询。
子 Agent 的审批
子 Agent 仍受文件、命令、Skill、MCP 和浏览器权限约束。需要用户决定的动作会与主 Agent 的审批一起显示在根对话的输入框位置。卡片上方显示来源子 Agent 的头像和名字,即使只剩一条子 Agent 审批也会保留这行,右侧显示 1 / 1,切换箭头禁用。
有多条待审批时,使用右上角箭头切换卡片,数字显示当前位置和待审批总数。每条可以独立批准或拒绝;操作确认后,该条移除、总数减少,对应 Agent 可以继续运行。新请求不会切走当前卡片,切换也会保留各条拒绝理由草稿。全部待审批处理完后,界面恢复尚未回答的问题或普通输入框。
审批前应核对:
- 这是哪个子 Agent 提出的动作。
- 它的目标是否在最初分工内。
- 是否与另一个子 Agent 同时修改同一文件或外部资源。
子 Agent 的权限不会比根任务更宽;后续任务还会根据祖先权限进一步收紧。
协作是如何组织的
当前结构是一棵树:每个子 Agent 只有一个直接父 Agent。发送消息只负责传递信息;真正安排下一次执行需要父 Agent 发出后续任务。子 Agent 完成一次运行后不会自动消失,后续仍可被再次唤醒。
每个 Agent 同时最多运行一个 Turn,交互式根 Agent、子 Agent 和 Scheduled Automation 共享并发容量。当前默认全局同时最多执行 50 个 Agent Turn,单棵树最多 64 个节点、深度最多 8;达到限制时任务会排队或被拒绝,而不是无限扩张。
实用提示
- 让每个子任务有明确输入、输出和禁止范围。
- 尽量避免两个子 Agent 同时写同一文件。
- 要求每个子 Agent 提供证据,而不是只返回“完成”。
- 最终结果由根 Agent 汇总,并要求它处理冲突和不一致。
- 涉及外部副作用时不要让多个子 Agent 重复提交同一动作。
当前限制
- 只支持树状协作,不支持任意依赖关系、条件分支或图形工作流。
- 用户不能直接编辑、启动或回复子 Agent 对话。
- Scheduled Automation 不能直接把目标设为子 Agent;它只能启动根任务,再由根 Agent 分工。
- Agent Center 只显示当前活动根对话的协作树,不跨多个根任务聚合。
- 进程崩溃后无法确认的外部副作用会保守标为结果未知,不会自动重放。