子智能体
Sub-agents are background agent runs spawned from an existing agent run.
Each one runs in its own session (agent:<agentId>:subagent:<uuid>) and,
by default, announces its result back to the requester for review.
Subagent runs are tracked by the native subagent lifecycle owner.
Goals:
- Parallelize research, long tasks, and slow tool work without blocking the main run.
- Keep sub-agents isolated by default (session separation, optional sandboxing).
- Keep the tool surface hard to misuse: sub-agents do not get session or message tools by default.
- Support configurable nesting depth for orchestrator patterns.
Note
成本说明: 默认情况下,每个子代理都有自己的上下文和 token 用量。对于繁重或重复性任务,请为子代理设置更便宜的模型,并通过
agents.defaults.subagents.model 或按代理覆盖,让主代理继续使用更高质量的模型。当子代理确实需要请求方当前的转录时,使用
context: "fork" 派生它。线程绑定的子代理会话默认使用
context: "fork",因为它们会将当前对话分支到后续线程。
Control UI 显示分配的任务,而不显示仅针对模型的子代理指令。 命名的子代理会话使用其任务标题,不带自动的“Subagent:”前缀;其父级关系和只读状态仍可识别该运行。
子代理运行会结束,但会话不会。在 Control UI 中,从父级对话打开 子代理,可在 运行中 和 已完成 下查看子运行,包括 swarm 工作者。选择某个运行会在父级旁边打开其现有的只读转录。返回子代理 会返回列表,而不会替换父级对话或其草稿。该面板会自动加载所有子页面;较旧的运行中工作者即使较新的子运行已完成也仍可见。并行任务视图还会显示 swarm 的聚合进度。
直接打开的子代理页面会保留一个紧凑通知,标明其父级,并提供 打开父级会话 按钮。嵌入式面板省略该通知,因为父级已经位于其旁边。当 Gateway 报告可中止的运行且你的会话访问权限允许时,你仍可使用 停止。使用 visible: true 创建的持久会话是会话树中的普通会话:它们保留父级用于导航和完成通告,并且你始终可以在其中输入并像其他任何会话一样引导它们。
对于内部 QA、研究、编码、审查和测试通道,请使用普通子代理,并让结果返回父级任务。仅当用户请求独立会话,或需要返回并独立引导该工作时,才创建持久可见会话。单独的 PR 或报告、长时间运行或隔离的 worktree 并不会使工作者成为独立的用户可见任务。请求子代理并不意味着请求新的侧边栏会话或分类。
本页是索引。子代理在七个页面上有文档,每个读者任务对应一个页面。打开与你的任务匹配的页面。
| 页面 | 阅读时机 |
|---|---|
| 子代理斜杠命令 | 你想从聊天中检查某次运行,或需要了解完成交付规则。 |
| 子代理工具参考 | 你正在调用 sessions_spawn、sessions_yield 或 subagents,并需要参数。 |
| 线程绑定的子代理会话 | 你正在将子代理绑定到频道线程,或需要了解允许列表和归档规则。 |
| 嵌套子代理与身份验证 | 你正在构建编排器,并需要深度上限、通告链或身份验证。 |
| 子代理通告 | 你正在调试子代理结果如何到达请求方。 |
| 子代理工具策略 | 你需要了解子代理始终失去的工具,或想进一步缩小工具范围。 |
| 子代理并发、恢复与停止 | 你正在调整并发、在重启后恢复,或停止子树。 |
各章节迁移位置¶
来自先前单页版本的每个章节标题、手风琴、步骤和参数 ID 都会在此保留其锚点,因此诸如
/tools/subagents#thread-bound-sessions 之类的现有链接仍可解析。每个条目都指向
现在承载该内容的页面。
- 斜杠命令
- 线程绑定控件
- 派生行为
- 非阻塞、基于推送的完成
- 完成交付
- 完成交接元数据
- 模式和 ACP 运行时
- 上下文模式
- 工具:
sessions_spawn - 委派提示模式
- 工具参数
tasktaskNamelabelagentIdcwdruntimeresumeSessionIdstreamTomodelrunTimeoutSecondsthinkingthreadmodecleanupexpectsCompletionMessagesandboxcontextprojectIdprojectGitUrlvisiblegroupworktreeworktreeNameworktreeBaseRef- 任务名称和目标定位
- 工具:
sessions_yield - 工具:
subagents - 线程绑定会话
- 线程支持频道
- 快速流程
- 派生
- 绑定
- 路由后续消息
- 检查超时
- 分离
- 手动控件
- 配置开关
- 允许列表
agents.entries.*.subagents.allowAgentsagents.defaults.subagents.allowAgentsagents.defaults.subagents.requireAgentIdagents.defaults.subagents.announceTimeoutMs- 发现
- 自动归档
- 嵌套子代理
- 深度级别
- 通告链
- 按深度划分的工具策略
- 每个代理的派生限制
- 重置对话
- 级联停止
- 身份验证
- 通告
- 通告上下文
- 统计行
- 为什么优先使用
sessions_history - 工具策略
- 通过配置覆盖
- 并发
- 存活与恢复
- 停止
- 限制
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw