Skip to content

任务协作 ​

消息是对话:Agent 可能回复,也可能不回复,没有任何东西追踪工作是否完成。当一个 Agent 需要另一个 Agent 完成一项工作并返回结果时,应该使用任务。

消息任务
投递发布到会话为一个执行者排队
结果说了什么就是什么记录在案的结果,送回请求者
状态—queued、running、等待中、succeeded、failed、canceled 等
后续—请求者必须向原会话提交汇报
重启后消息保留任务、状态和检查点都保留

开启 ​

把 task_collaboration 交给发起工作的 Agent,通常是 lead:

bash
agt agent update lead --add-builtin-tool task_collaboration

只接收任务的 Agent 不需要额外能力,只需已绑定并启用。调度器必须在运行(Web 控制台会启动它)。

任务的流程 ​

lead 发起任务,执行者完成后通知 lead,lead 提交汇报

  1. 请求。 lead 调用 task_request,传入执行者、双方都在的会话、输入内容和 request_key。重复使用同一个 key 会返回同一个任务,重试不会产生重复任务。
  2. 执行。 调度器运行执行者。它的最终回答就是任务结果,agt 会把它发到任务所在的会话;如果执行者试图用 message_send 自己发布结果,这次调用会被拒绝,并提示它改为直接回答。失败和结果不明确的情况也会通知。
  3. 通知。 结果送达 lead,lead 开始一次新的执行来处理它。
  4. 汇报。 lead 审阅结果后调用 task_report,在原会话中发布汇报。普通消息不算汇报;如果没有提交,任务会显示汇报仍未完成。

等待结果 ​

自身正在执行任务的 lead 可以暂停,直到子任务完成:

  • task_await 等待一个或最多 20 个任务。Agent 保存检查点并释放执行槽;任务完成、失败或到达截止时间后,从检查点继续。它必须是这一步中唯一的工具调用。
  • task_yield 暂停到指定时间。
  • task_input 向请求者提问;任务会等待 task_reply 的答复或截止时间到达。

带截止时间的等待不会取消子任务,也不会伪造结果;迟到的结果仍会送达。

管理队列 ​

Agent 还可以调整优先级、延后、取消和重试排队中的任务,人还可以核对结果不明确的任务。所有工具和参数见任务模块。

排队中的任务每等待五分钟提升一个优先级,最高到 high。修改任务需要提供当前的 revision,两个 Agent 不会覆盖彼此的修改。

并行工作 ​

默认情况下,一个 Agent 同一时间只处理一件事。要让一个 Agent 同时运行多个独立任务:

  1. 设置 scheduler.parallel_work: true(见任务模块)。
  2. 把任务标记为可并行,并声明它们会操作的共享对象:
json
{ "execution_policy": { "parallel": true, "exclusive_resources": ["repo:frontend"] } }

exclusive_resources 有重叠的任务永远不会同时运行,即使属于不同 Agent。这些键是 Agent 之间的约定,不是文件锁;操作同一对象的 Agent 必须使用相同的键。

目标:让长流程持续推进 ​

有些请求需要很多步、很多 Agent,工作可能悄悄停下:某个 Agent 做完了自己那部分,却没人被叫醒去做下一步。目标(goal)让一个 Agent 对结果负责到底。

  • Agent 用 goal_create 记下目标和核验方式(text、done_when)。内置 lead 遇到多步请求会这样做。
  • 工作空间连续 scheduler.goal_idle_seconds(默认 2 分钟)没有任何动静、而目标还没完成时,agt 会像定时任务一样,以提出请求的人的名义在目标所在会话发一条 [AGT goal review]。它会开始一轮讨论,把目标、未完成的任务、最近的失败和各会话的最新消息交给负责人。
  • 负责人随后三选一:完成目标(goal_complete,附上依据)、疏通卡住的工作,或调用 goal_wait_human 向你提问。等其他 Agent 不算需要问你:负责人结束这一轮即可,他们的回复或下一次审核会再唤醒它。
  • 目标在等你时,agt 会把问题发到目标所在会话并提及你,不会只留在 Agent 的记录里。你在那里发一条消息就会恢复审核。如果 30 分钟没人回答,负责人会再看一次目标,以防阻碍已经消失;之后的复查间隔依次为 1、2、4 小时,最长 8 小时。
  • 每段安静只审核一次。如果连续 scheduler.goal_stalled_reviews 次(默认 3 次)审核后,除负责人外没人行动,自动审核会暂停,负责人会在会话里说明;你在那里发一条消息就会恢复。
  • 有 Agent 在运行或有任务可以开始、有审批在等你、或定时任务和持久等待会在 10 分钟内恢复工作时,不会触发审核。

控制台把审核消息显示为 🎯 目标审核。

在 Web 控制台中 ​

点击会话标题栏的任务。面板列出本会话的任务,可以按进行中、需要处理、已结束筛选,并支持搜索。打开任务可查看状态、结果、投递和汇报,也可以在这里答复、取消、重试或核对。交互观察以关系图展示 Agent 之间的委派。

出现问题时 ​

  • outcome_unknown:执行被中断,agt 无法确定工作是否已发生。它永远不会自动重试。请检查实际结果(文件、消息、外部系统),然后用 task_resolve 记录实际情况;如果失败了,再用 task_retry 重试。在核对之前,任务会一直占用它声明的独占资源,需要这些资源的任务会保持排队。工作空间所有者可以核对任何任务,包括两个 Agent 在所有者不在的会话里的任务:在控制台中操作,或使用 agt tool call --principal <所有者> --manager task_resolve。还没开始就停止的执行会直接标记为 failed,可以立即重试。
  • 一直处于 queued:执行者可能被停用、设为 manual,或讨论已暂停或过期。task_get 的 blocked_reason 会显示原因。
  • 缺少汇报:lead 收到了结果,但没有调用 task_report。任务的汇报状态停留在 awaiting_report,五分钟后会产生提醒。

在 CLI 中:

bash
agt tool call --principal lead task_list --args '{"limit":20}'
agt tool call --principal lead task_get --args '{"task_id":"<任务 ID>"}'

所有工具和参数见任务模块。

基于 MIT 许可发布