Skip to main content
委派让一个 Agent 向另一个 Agent 求助。与 Sub Agent 不同,目标不是为这次任务临时创建的,而是一个常驻的同事:它有自己的工作空间、记忆、技能、会话和定时任务。它在自己的环境里作答,结果回到发起方,不会直接发给用户。
只有在团队会话中——两个及以上启用的 Agent、且会话里有同事时——agent_delegate 工具才会出现。单 Agent 的部署看不到它。

Sub Agent 还是同事

需要把自己的活并行化,用 Sub Agent;任务本就属于别人——拥有那个代码库、那个知识库、那个客户关系的 Agent——才用委派。

委派是同步的

委派会把任务交出去,等待同事作答,再把答复返回。调用会一直阻塞到同事完成(或时间预算耗尽),因此没有需要轮询的状态,也没有需要跟踪的句柄:
在底层,这次运行仍会记录在目标的工作空间中,其父节点是发起委派的那个 run,因此一条委派链从两端都能走通。

可委派的对象

你能委派的对象,就是当前会话中的同事——正是你上下文里「团队会话」一节列出的那份名单,连同他们的 ID。委派始终限定在用户搭建的这个团队内部,绝不会把任务交给会话之外的 Agent,即便白名单本可放行。若指向的不是同事,工具会拒绝,并列出你实际可以委派的同事。

参数

agent_id —— 同事的 ID(「团队会话」一节里为他显示的 @id)。task —— 一份自洽的任务说明,同事无需看到本会话即可据此行动。

守卫

委派发生在完整的 Agent 之间,因此设有边界:
  • 成员 —— 目标必须是当前会话中的同事
  • 白名单 —— 谁可以找谁。不设置则任意 Agent 之间都可委派
  • 环路 —— 已在链路中的 Agent 不能被再次委派
  • 深度 —— 一条链最多允许多少跳
  • 长度 —— 单次任务文本的上限
  • 时间预算 —— 一次委派 run 最长可以跑多久,超出即放弃

配置

像上面的 "research" 那样配成空数组的 Agent,可以被委派,但不能再向外委派。