本页内容
本页内容
代理协调
子代理
子代理是从现有代理运行生成的后台代理运行。每个会话都在自己的会话 (agent:<agentId>:subagent:<uuid>) 中运行,默认情况下,announces 其结果返回给请求者以供审核。子代理运行由本机子代理生命周期所有者跟踪。
目标:
- 并行处理研究、长任务和缓慢的工具工作,而不阻塞主运行。
- 默认保持子代理隔离(会话分离,可选沙箱)。
- 保持工具面不易被滥用:子代理默认不获得会话或消息工具。
- 支持可配置的嵌套深度,以满足编排器模式。
Control UI 显示分配的任务,而无需仅模型子代理指令。命名子代理会话使用其任务标题,不带自动“子代理:”前缀;他们的父关系和仅查看状态仍然标识运行。
子代理运行结束;会话则不然。在 Control UI 中,从父对话中打开 Subagents,以查看 Running 和 Finished 下的子运行,包括 swarm 工作线程。选择一个运行会在父级旁边打开其现有的仅供查看的记录。 返回子代理 返回列表而不替换父对话或其草稿。面板自动加载所有子页面;即使新孩子已经完成,年长的跑步工人仍然可见。并行任务视图还显示总体集群进度。
直接打开的子代理页面会保留一个命名其父级的紧凑通知和一个 打开父会话 按钮。嵌入面板会忽略该通知,因为父面板已经位于其旁边。当网关报告可中止运行并且您的会话访问允许时,您仍然可以使用 Stop。使用 visible: true 创建的持久会话是会话树中的普通会话:它们保留其父级以用于导航和完成公告,并且您始终可以输入它们并像任何其他会话一样引导它们。
使用普通子代理进行内部 QA、研究、编码、审查和测试通道,并将结果返回到父任务。仅当用户请求单独的会话或需要返回并引导独立工作时,才创建持久可见会话。 PR 或报告、长期运行或单独的独立工作树并不会使工作人员成为单独的面向用户的任务。请求子代理并不请求新的侧边栏会话或类别。
此页是一个索引。子代理记录在七页上,每个读者作业一页。打开与您的任务匹配的页面。
| 页面 | 读它的时候 |
|---|---|
| 子代理斜线命令 | 您想要从聊天中检查运行,或者需要完成交付规则。 |
| 子代理工具参考 | 您正在调用 sessions_spawn、sessions_yield 或 subagents 并且需要参数。 |
| 线程绑定子代理会话 | 您要将子代理绑定到通道线程,或者需要许可名单和存档规则。 |
| 嵌套子代理和身份验证 | 您正在构建一个协调器,并且需要深度上限、公告链或身份验证。 |
| 分代理公告 | 您正在调试子结果如何到达请求者。 |
| 分代理工具政策 | 您需要子代理总是丢失的工具,或者想要进一步缩小它们的范围。 |
| 子代理并发、恢复和停止 | 您正在调整并发性、重新启动后恢复或停止子树。 |
各部分移动的地方
先前单页版本中的每个部分标题、手风琴、步骤和参数 ID 都保留其锚点,因此现有链接(例如 /tools/subagents#thread-bound-sessions)仍然可以解析。每个条目都指向现在保存内容的页面。
- 斜线命令
- 螺纹装订控件
- 生成行为
- 非阻塞、基于推送的完成
- 竣工发货
- 完成切换元数据
- 模式和ACP运行时间
- 上下文模式
- 工具:
sessions_spawn - 委托提示方式
- 刀具参数
tasktaskNamelabelagentIdcwdruntimeresumeSessionIdstreamTomodelrunTimeoutSecondsthinkingthreadmodecleanupexpectsCompletionMessagesandboxcontextprojectIdprojectGitUrlvisiblegroupworktreeworktreeNameworktreeBaseRef- 任务名称和目标
- 工具:
sessions_yield - 工具:
subagents - 线程绑定会话
- 螺纹配套通道
- 快流
- Spawn
- Bind
- 路线跟进
- 检查超时
- 分离
- 手动控制
- 配置开关
- 许可列表
agents.entries.*.subagents.allowAgentsagents.defaults.subagents.allowAgentsagents.defaults.subagents.requireAgentIdagents.defaults.subagents.announceTimeoutMs- 发现
- 自动存档
- 嵌套子代理
- 深度级别
- 公告链
- 按深度划分的工具策略
- 每个代理生成限制
- 重置对话
- 串级停止
- 认证
- 公告
- 公告上下文
- 统计行
- 为什么更喜欢
sessions_history - 刀具政策
- 通过配置覆盖
- 并发
- 活性和恢复
- 停止
- 限制