一个代理在等部署审批,另一个需要补充说明才能继续调查,第三个已经跑了好几个小时——而当初启动它的工程师,早就把浏览器关了。它们可能都说同一种协议 A2A,但光有协议,并不会自动给团队一个地方去看清:哪些决定还悬着、该谁负责、上次批的到底是哪个版本。
Agent Taskbay 想填的就是这个运营层面的缺口。它是一个持久化、可自托管的「人类操作控制台」,专门面向 A2A 代理。它不接管代理的执行,npm 包名为 agent-taskbay(MIT 许可),1.0.0 是首个稳定版本。
为什么需要它?一个聊天窗口能装下一次和单个代理的对话,但一支团队同时跑好几个代理时,就需要别的地方。问题、审批、动辄几分钟到几天的任务,必须能扛住笔记本合盖;而该来回答的人,往往不是发起这次运行的人。决定存在哪里,就得能说清:批了什么、谁批的、发出去的确实是同一个版本。
它不替代框架自带的人机协同
如果你用 LangGraph、Google ADK 或其他代理框架,可能已经有 human-in-the-loop 能力:暂停执行、请求人工输入、等决定到了再恢复。Taskbay 不取代这些机制,它解决的是另一个问题——框架级 HITL 是一种执行能力,Taskbay 是一种人类运营能力。前者让代理可被打断,后者让跨 A2A 代理的人工介入在运营上可管理。
设想一个多代理系统:部署代理等审批发新版本,调查代理等澄清,研究代理交了报告等人审,还有代理仍在执行但需要人补指令。每个代理可能用不同框架,各自管自己的执行状态、检查点和中断。可操作员去哪儿看这些请求?每个决定归谁?指派的评审人不在怎么办?团队怎么跟踪待办、升级逾期任务、事后查发生了什么?这些是运营问题,不是执行问题。
分工是刻意设计的:代理框架负责执行、状态、检查点、中断与恢复;A2A 协议提供兼容系统间通信与任务交互的标准接口;Taskbay 提供操作员体验——做决定、跟踪人的工作。代理继续跑在原有框架里,Taskbay 不需要变成它们的编排器。
一个审批,绑定一个修订版本
当代理把任务置为 input-required 并声明审批请求扩展时,框架里的暂停就会出现在 Taskbay 中。带类型的问题走结构化表单扩展,同理。代理在自己的运行时里,执行动作前先检查决定;Taskbay 提供被审阅过的决定,以及发送记录。
操作员拿到的东西包括:首页统计可达代理数、等人处理的事项、活跃任务、未读通知;收件箱跨代理汇总需要输入的任务和仍未关闭的审批;视图分为「需要你」「属于你」「已逾期」「活跃」「已完成」,列表可按风险收窄。
一个审批,就是某个任务上的一个拟议动作。有操作权限的评审人用五种方式之一了结:批准、编辑后批准、拒绝、要求修改、转派。批准会在确认后把审阅过的动作发送一次;编辑会记为新的修订版本再发送;拒绝和要求修改什么都不发;转派把未决请求交给另一位合格评审人。除单纯批准外,每种结果都需要理由。职责分离默认开启,发起请求的人不能自己拍板;代理发起的审批没有请求人;被指派的请求由被指派者或管理员决定。
版本规则是这套东西的硬核。提案以编号修订形式存储,不原地编辑,其摘要是动作规范 JSON 的 SHA-256,每一层对象键都排序。评审人要指明自己读的是哪个修订。举例:代理提出修订 1「把 2.1 版部署到预发」,评审人打开看到修订 1;提案变了,修订 2 成了「部署 2.2 版」;评审人却批准了修订 1——Taskbay 返回 409,过期决定不授权任何东西,必须重读当前提案才会发送。评审人自己编辑也一样,编辑成为带独立摘要的新修订,被批准的是它。
决定与命令一起提交,获批动作只发一次,页面记录投递是否成功;投递状态未知的,不会重发。审计线索是只追加记录,保存提案、摘要、理由、评审人、投递和归属事件,数据库触发器拒绝更新和删除决定与修订。控制台有三种角色:admin、operator、viewer,团队以及按代理、按技能的授权决定谁能读、谁能操作。
想试的话,需要 Node.js 22.19 或更新版本,不用数据库服务器、不用账号、不用 .env 文件。运行 npx agent-taskbay,控制台监听 http://127.0.0.1:3002,自动打开浏览器并以本地管理员身份登录,数据库在 ~/.agent-taskbay,进程只绑定本机。另开一个终端跑 npx agent-taskbay demo-agent,它会在 4010 端口打印五个 Agent Card 地址,用 showcase 那张卡连接,发一句「please approve the deploy」,收件箱的「需要你」里就会出现高风险审批「Delete the staging cluster」,审阅后批准并确认,任务即完成,管理 → 审计线索里能看到每一步。
热门跟贴