任务协作
消息是对话: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 调用
task_request,传入执行者、双方都在的会话、输入内容和request_key。重复使用同一个 key 会返回同一个任务,重试不会产生重复任务。 - 执行。 调度器运行执行者。它的最终回答就是任务结果,agt 会把它发到任务所在的会话;如果执行者试图用
message_send自己发布结果,这次调用会被拒绝,并提示它改为直接回答。失败和结果不明确的情况也会通知。 - 通知。 结果送达 lead,lead 开始一次新的执行来处理它。
- 汇报。 lead 审阅结果后调用
task_report,在原会话中发布汇报。普通消息不算汇报;如果没有提交,任务会显示汇报仍未完成。
等待结果
自身正在执行任务的 lead 可以暂停,直到子任务完成:
task_await等待一个或最多 20 个任务。Agent 保存检查点并释放执行槽;任务完成、失败或到达截止时间后,从检查点继续。它必须是这一步中唯一的工具调用。task_yield暂停到指定时间。task_input向请求者提问;任务会等待task_reply的答复或截止时间到达。
带截止时间的等待不会取消子任务,也不会伪造结果;迟到的结果仍会送达。
管理队列
Agent 还可以调整优先级、延后、取消和重试排队中的任务,人还可以核对结果不明确的任务。所有工具和参数见任务模块。
排队中的任务每等待五分钟提升一个优先级,最高到 high。修改任务需要提供当前的 revision,两个 Agent 不会覆盖彼此的修改。
并行工作
默认情况下,一个 Agent 同一时间只处理一件事。要让一个 Agent 同时运行多个独立任务:
- 设置
scheduler.parallel_work: true(见任务模块)。 - 把任务标记为可并行,并声明它们会操作的共享对象:
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>"}'所有工具和参数见任务模块。