tako 文档 GitHub

70 · 多 Agent 编排与持久 Task

性质:方案集入口。调研篇保存参考证据;第一版方案 是 V1 的唯一方案真源。 状态:✅ 已落地(2026-11-10 施工+活体验收,commit 9b31baa)。 日期:2026-11-09。 代码落点:yk-tako-eino/internal/runengine/agent_task_*.go、cmd/yktako/main.go、web/src/TasksView.vue;活体 scripts/acceptance/agent_task_*.sh。 与总纲关系:承接 doc/16 #9“多 Agent 协作”的缺口。

1. 为什么是一个方案集、两个方向

tako 当前已有主 Agent 委派 coder/researcher:子代理有独立上下文、工具权限、持久档案和完整档案 resume。但要把“调用一个子代理”推进到“多个 Agent 按依赖完成一个目标”,中间缺两层不同机制:

  1. Task 方向:一件工作怎样脱离一次工具调用,拥有独立身份、输入、执行 run、状态、结果和通知;
  2. 多 Agent 编排方向:多件 Task 之间怎样表达依赖、取得执行权、控制并发、交接结果和响应失败。

如果只做 Task,得到的是可靠的异步委派;如果跳过 Task 直接画任务图,图上的节点仍没有独立执行与恢复语义。两条线因此共用一套 V1 方案,但施工顺序不是并列:Task 是底座,多 Agent 编排消费 Task。

2. 阅读顺序

顺序 文档 回答什么
1 Task · Comma 调研 Comma 如何把委派做成持久工作;哪些机制有代码证据;为什么它当前不是完整任务图
2 多 Agent · 参照调研 Comma、Hermes、Octop 分别解决什么,为什么不能只凭“Swarm”名字判断能力
3 第一版方案:持久 Task 与固定 DAG 编排 V1 的用例、角色、契约草案、状态、存储、调度、恢复、验收与落地顺序

以下两篇初稿已被 V1 方案取代,只保留当初的推导过程,不再作为方案或施工真源:

3. 调研形成的参照分工

4. V1 最小完成线

先让一件 Task 独立跑完并能恢复,再完成下面这一场:

用户目标
  → 协调 Agent 一次创建 A、B、C 三件 Task 与两条依赖边
  → researcher 分别执行 A、B
  → C 声明 parents=[A,B],只有两者成功才 ready
  → writer 读取 A、B 的结构化结果与文件路径,生成汇总
  → 一个执行者中途崩溃:C 不提前启动,恢复后只产生一个 C
  → 协调 Agent 交付一份可独立检查的 final 文件

这条链同时证明“有多个 Agent”和“系统确实在编排它们”。只看到多个角色名、没有依赖与结果交接,不算本方案达成。

V1 的图创建后不修改工作内容、执行者或依赖边。下一版可以讨论 Goal 驱动的动态计划修订,但不把动态改图、Agent 自由群聊或无限共享历史塞进 V1。

下一阶段已单立 doc/72:有界修订、Task HITL 与事件驱动(2026-11-11 已施工并活体验收,commit a5a9a5e)。它建在本篇 V1 之上,不改变 V1 的完成线与验收事实;V1 五场回归在本轮仍全绿。协调/交付 run 的崩溃、明确 error、人工恢复与结果定位另见 doc/73(2026-11-11 已施工并活体验收)。并行 Task 的工作区隔离、父结果交接、验证与发布恢复由 doc/74 专项设计(2026-11-12 已落地):Task 不认识 Git,LLM 决定编排与隔离需求,WorkspaceProvider 按项目形态选择 Git 或普通目录实现。目标可行性判断、同组修订或继任编排组选择由 doc/75 专项设计(2026-11-13 已落地);项目内容根与运行资源容器调整见 doc/76(2026-11-13 已落地)。可组合执行原语与后台命令(wait_task、bash_output/stop_bash、bash_job_finished 通知、就地认领与单组收口的共用实现)见 doc/82(2026-11-15 已落地)——本篇的「来源会话空闲时消费通知」链路由此扩展为「空闲消费 / 就地认领两条路」。

5. 与现行文档的边界

6. 施工:已按施工包一次完成(2026-11-10)

主 Agent 把 V1 细化成 tmp/70-多Agent编排与Task/施工包.md(执行期材料,不入库,用户验收后按纪律留档 doc/log/),开发一次完成整个 V1:先实际打通 POST /api/tasks,再完成固定 DAG 与真实前端;不按拍向用户逐点交审。

结果:活体五场(single 24/24、busy 14/14、dag 22/22、crash 20/20、two_replicas 13/13)+ 单测全绿 + 浏览器停止/恢复链走查;施工期抓到的契约缺口(创建不发事件、组/交付事件空租户被吞、artifacts:null 炸详情渲染、SSE 心跳与 last_event_id 续读)已修复并回填 doc/40 §4.2c 与 doc/46 §7.7。证据与遗留见施工包;状态以本 README 与代码为准。