蜂群模式与子代理

把可以独立推进的工作交给子代理,同时保留主任务负责整合、验证和最终交付。

本页内容

任务分工与并行执行

在输入框左侧添加能力或上下文菜单里有蜂群模式(星型)与蜂群模式(网状)两项,二选一;再点一次已选中的那项即关闭。选中后输入区出现对应标签。

模式协作方式适合的任务
蜂群模式(星型)主任务派出子 Agent,子 Agent 只向主任务汇报最终结果,不再继续派生。几项互不相关、各自汇报即可的调查或检查。
蜂群模式(网状)任意 Agent 都能继续派生下级(路径形如 /root/research/web),可以互相发消息、追加后续任务,并等待下级回报。需要分层拆解、中途协调或多轮往返的大任务。

蜂群模式是会话级设置:随下一条消息生效并一直保持,直到切换或关闭;TUI 与对话中都可以用 /swarm star、/swarm mesh、/swarm off 切换,/swarm 查看当前模式。开启状态本身不会立即启动任务,也不保证每一个请求都会产生相同数量的子任务。

适合并行的工作包括分别调查两个独立模块、检查不同平台的入口、准备测试与阅读接口。先说明每个子任务的范围、允许修改的文件和需要返回的结果,避免多个代理同时改同一处内容。

可独立并行的任务示例
并行检查前端表单与后端校验:一位代理只阅读前端并列出边界情况,另一位只阅读后端并找出校验差异。由主任务汇总证据后提出修复方案,暂不修改文件。

子代理拥有独立上下文,并继承父任务的工作目录与权限模式。主任务通常收到子代理最终答复,而非自动把所有中间工具输出复制进自身上下文。共享工作目录意味着文件变化会相互可见;独立上下文不等于独立 Git 工作树。

网状模式下,子 Agent 默认继承派生者的对话上下文(只保留用户消息与最终回答),也可以只继承最近几轮或完全不继承。下级完成或出错时,结果以「某某已完成」「某某执行出错」提示行送到上级,不会打断上级正在进行的工作,上级下一次回复时会看到它。同一棵协作树同时最多保留 4 个 Agent(含主任务,可在配置文件的 swarm.mesh.max_concurrent_agents 调整);满了会暂时卸载最久没有活动、已经结束的 Agent,再次给它发消息时自动恢复。仍有子 Agent 在运行时不能退出网状模式,先等待它们完成或停止它们。

添加能力菜单中的蜂群模式、专家组件与文件或文件夹入口 蜂群模式标签与说明分工、文件范围和只读边界的草稿,截图时尚未发送
从添加能力菜单选择蜂群模式后,输入区显示模式标签。草稿中说明负责的文件与只读边界;截图时尚未提交此分工请求。Windows 实际界面 · 点击图片查看原图

查看进度与处理操作确认

产生子任务后,在主会话的后台任务面板查看运行中和已完成的任务,打开任务可阅读其会话与工具结果。子任务归属于父会话,不会作为普通任务充满主侧边栏和全局搜索结果。

来自子任务的权限请求与问题会在主界面出现,并标注来源。检查任务名称、工具参数与目标路径后处理;不要仅因为主任务尚有输出,就忽略另一个子任务正在等待回答。

可以在面板中停止运行中的子任务。停止父任务也会向其子任务传播中断;已经产生的文件和记录会保留,不自动回滚。

子任务始终跟随主会话:已结束的任务一直留在面板里,随时可以打开查看,不能单独归档或删除。只有把主会话归档后再永久删除,它的全部子任务记录才会随之删除。

TUI · 管理后台任务
/tasks
/tasks list
/tasks abort 子任务ID
展示运行中与已完成分组、查看会话和停止入口,以及带来源名称的权限确认。

全部子任务完成后,让主任务检查它们之间的冲突、统一差异并运行必要验证。各自报告“完成”不能代替整合后的构建或测试。

搜索全部帮助文档