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 按依赖完成一个目标”,中间缺两层不同机制:
- Task 方向:一件工作怎样脱离一次工具调用,拥有独立身份、输入、执行 run、状态、结果和通知;
- 多 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. 调研形成的参照分工
- Comma:学习持久 Task、创建幂等、独立执行 Session、结果通知与两类沉默监控。其当前版本一个 Task 一个 Worker,旧 Task Graph 已退役,因此不是依赖调度的主参照。
- Hermes Kanban:学习任务依赖、ready 推进、原子领取、具名执行者、审查与故障回收。其 SQLite/本机进程形态不照搬到 tako 的多副本 Go/PostgreSQL 目标栈。
- Octop/harness-agent TeamManager:学习具名 Agent 发现、同步/后台同伴调用与 inbox;作为后续可选能力,不是 V1 前提。
- Eino:继续负责 Task 内部的 Agent 与模型/工具执行;外层业务 Task、依赖、通知和交付事实由 PostgreSQL 保存。
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. 与现行文档的边界
- doc/25、doc/39:现有同步子代理委派与 wire 档案仍是当前实现真源;本方案集未改变它们。
- doc/41:现有
run_tasks是一次 run 内的看板,不是可调度 Task;两者不能混名。 - doc/30:现有 run 的租约、执行代次、journal 与显式 resume 是恢复底座;本方案集不承诺外部副作用 exactly-once。
- doc/43:租户并发容量仍在数据库裁决;编排组不能绕过它。
- doc/45:任务是否真正做对由独立场景评测证明,不由 Agent 自报成功。
- doc/71:文件写入竞争与长任务 worktree 有独立方案边界,V1 不顺带实现并行仓库合并。
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 与代码为准。