文档

内置工具›代理编排

子代理

agent_spawn
分组
代理编排
开启方式
对话设置「工具」页里它自己的开关。
审批
需审查：写入和无边界的操作要你批准，除非安全级别或之前的「总是允许」已经覆盖。
档案键
tool.agent_spawn.description

启动一个子代理：一次独立的模型运行，在后台处理一项任务，再把结果交回这段对话。

默认情况下，子代理只看得到模型写下的任务，看不到这段对话。结果通过 task_wait 取回，或者以一行 box 送达。详见子代理与工作流。

什么时候询问你

在手动下，每启动一个子代理都会先询问，卡片提供总是允许。

限制

  • 每段对话同时最多运行 8 个后台任务，子代理、工作流运行和后台命令合计。再启动第 9 个会被拒绝，直到其中一个结束，不论它的结果有没有被取走；到了超时的命令仍会转入后台，即使超出上限。
  • 结果是子代理的最终回复，超过 64 KiB 会被截断。

值得知道

  • 子代理拥有对话的工具，但没有 agent_spawn、workflow、ask_user、fork、计划工具和交接工具。它的后台命令向它汇报，它给出最终回复时仍在运行的会被停止。
  • 停止回合不会停止子代理。要停止它，在任务面板（更多选项 → 任务）里它那一行操作。

参数

参数类型说明
name 必填
名称		string必填。用于 task_wait 寻址，也是任务栏里这一行的标题；小写字母开头，可含数字、_ 和 -；整个对话分支树内不可重名
prompt 必填
任务		string默认子代理看不到当前对话，任务描述必须自包含全部背景
agent_type
命名类型		string可选的可信命名定义名称；可用的名称与用途列在本轮的可用 Agent 清单里。照抄其中一个名称即可——由宿主解析，无歧义时大小写与分隔符不敏感。不能与 context=conversation 同时使用
context
初始上下文		stringnone（默认）：只看到任务；conversation：携带当前对话历史副本
"none" "conversation"
默认 "none"
label
显示名		string显示在时间线上的短名称
schema
输出模式		object可选的 JSON Schema 子集；给出后子代理必须调用 structured_output 交回符合该模式的结果，返回值会随 task_wait 一起回来。顶层必须是 type 为 object 的对象模式；支持 type、properties、required、items、enum、const、additionalProperties、minItems/maxItems、minLength/maxLength、minimum/maximum，其余关键字会被当场拒绝

在 GitHub 上编辑本页