只有在团队会话中——两个及以上启用的 Agent、且会话里有同事时——
agent_delegate 工具才会出现。单 Agent 的部署看不到它。Sub Agent 还是同事
需要把自己的活并行化,用 Sub Agent;任务本就属于别人——拥有那个代码库、那个知识库、那个客户关系的 Agent——才用委派。
委派是同步的
委派会把任务交出去,等待同事作答,再把答复返回。调用会一直阻塞到同事完成(或时间预算耗尽),因此没有需要轮询的状态,也没有需要跟踪的句柄:可委派的对象
你能委派的对象,就是当前会话中的同事——正是你上下文里「团队会话」一节列出的那份名单,连同他们的 ID。委派始终限定在用户搭建的这个团队内部,绝不会把任务交给会话之外的 Agent,即便白名单本可放行。若指向的不是同事,工具会拒绝,并列出你实际可以委派的同事。参数
agent_id —— 同事的 ID(「团队会话」一节里为他显示的 @id)。task —— 一份自洽的任务说明,同事无需看到本会话即可据此行动。
守卫
委派发生在完整的 Agent 之间,因此设有边界:- 成员 —— 目标必须是当前会话中的同事
- 白名单 —— 谁可以找谁。不设置则任意 Agent 之间都可委派
- 环路 —— 已在链路中的 Agent 不能被再次委派
- 深度 —— 一条链最多允许多少跳
- 长度 —— 单次任务文本的上限
- 时间预算 —— 一次委派 run 最长可以跑多久,超出即放弃
配置
像上面的
"research" 那样配成空数组的 Agent,可以被委派,但不能再向外委派。