跳转至

子智能体

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 之类的现有链接仍可解析。每个条目都指向 现在承载该内容的页面。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw