---
title: 智能体工作流 – Agent Teams 文档
description: 了解任务生命周期、看板、消息、任务日志、并行工作、实时进程以及跨团队通信。
lang: zh-Hans
---

# 智能体工作流

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 关联。

::: warning Fix-first review
如果在审查期间要求队友做出变更，它应当发布一条包含修复内容的后续评论，然后 lead 即可批准。
:::

## 看板

看板是主要的操作界面。它让你能够：

- 浏览处于打开、被阻塞和审查中的工作
- 打开任务详情并查看运行时日志
- 无需阅读原始会话文件即可审查变更
- 指派或重新指派负责人

::: tip
使用卡片上的快捷操作按钮来开始、完成或请求审查，无需打开详情面板。
:::

## 消息与评论

| 渠道 | 何时使用 |
| --- | --- |
| 私信 | 重新引导某个智能体、快速提问 |
| 任务评论 | 属于某个特定任务的备注 |

评论为后续审查保留了上下文，并出现在任务时间线中。

::: tip 优先使用任务评论
如果备注是关于某个特定任务的，请将其作为该任务的评论添加，而不是发送私信。这样能让历史记录与工作保持关联。
:::

## 任务日志

任务专属日志为单个指派隔离出运行时输出、操作和消息。用它们来回答：

- 这个智能体运行了什么？
- 它为什么更改了这个文件？
- 它是否向另一位队友求助过？
- 是哪个任务产生了这个 diff？

### 验证清单

当某个任务看起来卡住，或其 diff 看起来与任务脱节时，按以下顺序验证生命周期：

1. 任务拥有预期的负责人，并已转入 `in_progress`。
2. 负责人发布了一条包含计划或首次进度更新的任务评论。
3. 任务日志显示在任务时间窗口内有运行时活动。
4. 文件变更与同一个任务、负责人和会话相关联。
5. 最后一条任务评论包含验证命令及其结果。

如需更深入的调试，请使用[故障排查](/zh/guide/troubleshooting#task-log-triage)中的持久化证据命令。UI 是工作界面，但对于棘手的启动或归属错误，持久化的任务文件、收件箱和运行时证据才是真正的依据。

## 并行工作模式

队友可以同时处理相互独立的任务。你还可以创建依赖关系（`blocked-by`），让一个任务等待另一个任务完成。留意看板上被阻塞的泳道，如果一位队友空闲而另一位负担过重，则重新指派负责人。

## 实时进程

当智能体启动本地服务器或工具时，实时进程区域会显示 URL 和正在运行的进程。直接从应用中打开这些 URL 即可查看结果。进程会一直保持注册状态，直到被显式停止或运行时退出。

## 跨团队通信

当团队之间已建立关联时，智能体可以向其他团队发送消息。可将其用于工作交接、共享库，或各小队之间的状态检查。
