智能体工作流
Agent Teams 通过任务状态、消息、日志以及可审查的代码变更,让智能体的工作变得可见。
模式
| 模式 | 说明 |
|---|---|
| Solo | 单个队友,自行管理任务 |
| Team | 多个队友并行工作,互相审查 |
两种模式共享相同的看板、任务日志和代码审查界面。
任务生命周期
Agent Teams 沿着两个独立维度跟踪每个任务:工作状态与审查状态。
| 维度 | 状态 | 说明 |
|---|---|---|
| 工作状态 | pending、in_progress、completed | 跟踪任务是处于等待、正在被处理,还是已被负责人完成 |
| 审查状态 | none、review、needsFix、approved | 跟踪任务在完成后审查流程中所处的位置 |
看板展示的是组合后的视图,但这两个维度各自独立移动。
工作状态流转
| 阶段 | 发生的事情 | 负责人 |
|---|---|---|
| Pending | 任务已创建并就绪,但还没有人开始处理 | Lead 或用户 |
| In progress | 智能体进行工作,并通过看板 MCP 工具更新任务状态 | 队友 |
| Completed | 负责人发布一条结果评论,并将任务标记为完成 | 队友 |
审查状态流转
| 阶段 | 发生的事情 | 负责人 |
|---|---|---|
| None | 任务尚未进入审查(可能处于 pending、in progress 或刚刚 completed) | — |
| Review | 已请求审查;审查者检查 diff 与结果 | 审查者 |
| Needs fix | 审查期间提出了变更要求;负责人必须更新 | 队友(负责人) |
| Approved | 审查通过;任务定稿 | 审查者 |
规划 → In progress
当队友开始一项任务时,工作状态变为 in_progress。智能体创建一条包含其计划的任务评论,并继续工作。所有原生工具操作(read、bash、edit、write)都会被流式记录到任务日志中。
Completed → Review
当队友完成工作后,它会发布一条结果评论,并将工作状态标记为 completed。随后 lead 或审查者可以请求审查,以启动审查流程。
Review → Approved
如果审查界面显示变更可以接受,则批准该审查。任务随即定稿,并与其 diff 关联。
Fix-first review
如果在审查期间要求队友做出变更,它应当发布一条包含修复内容的后续评论,然后 lead 即可批准。
看板
看板是主要的操作界面。它让你能够:
- 浏览处于打开、被阻塞和审查中的工作
- 打开任务详情并查看运行时日志
- 无需阅读原始会话文件即可审查变更
- 指派或重新指派负责人
TIP
使用卡片上的快捷操作按钮来开始、完成或请求审查,无需打开详情面板。
消息与评论
| 渠道 | 何时使用 |
|---|---|
| 私信 | 重新引导某个智能体、快速提问 |
| 任务评论 | 属于某个特定任务的备注 |
评论为后续审查保留了上下文,并出现在任务时间线中。
优先使用任务评论
如果备注是关于某个特定任务的,请将其作为该任务的评论添加,而不是发送私信。这样能让历史记录与工作保持关联。
任务日志
任务专属日志为单个指派隔离出运行时输出、操作和消息。用它们来回答:
- 这个智能体运行了什么?
- 它为什么更改了这个文件?
- 它是否向另一位队友求助过?
- 是哪个任务产生了这个 diff?
验证清单
当某个任务看起来卡住,或其 diff 看起来与任务脱节时,按以下顺序验证生命周期:
- 任务拥有预期的负责人,并已转入
in_progress。 - 负责人发布了一条包含计划或首次进度更新的任务评论。
- 任务日志显示在任务时间窗口内有运行时活动。
- 文件变更与同一个任务、负责人和会话相关联。
- 最后一条任务评论包含验证命令及其结果。
如需更深入的调试,请使用故障排查中的持久化证据命令。UI 是工作界面,但对于棘手的启动或归属错误,持久化的任务文件、收件箱和运行时证据才是真正的依据。
并行工作模式
队友可以同时处理相互独立的任务。你还可以创建依赖关系(blocked-by),让一个任务等待另一个任务完成。留意看板上被阻塞的泳道,如果一位队友空闲而另一位负担过重,则重新指派负责人。
实时进程
当智能体启动本地服务器或工具时,实时进程区域会显示 URL 和正在运行的进程。直接从应用中打开这些 URL 即可查看结果。进程会一直保持注册状态,直到被显式停止或运行时退出。
跨团队通信
当团队之间已建立关联时,智能体可以向其他团队发送消息。可将其用于工作交接、共享库,或各小队之间的状态检查。
