agent-ecosystem/landing/product-docs/zh/guide/agent-workflow.md
777genius 95e0f34d31 docs(product-docs): add zh, es, ja, fr, de doc translations
Localize the VitePress docs into Simplified Chinese, Spanish, Japanese,
French and German (18 pages each), mirroring the existing en/ru structure.

- generate the 5 new locales in config.ts from a single strings table
  (nav, sidebar, search, footer, docFooter, outline, editLink) with
  locale-prefixed links
- rework DocsCardGrid from the binary isRu check to a per-locale map so
  the home cards render translated copy and prefixed links for every locale
2026-05-31 17:50:54 +03:00

5 KiB
Raw Blame History

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

智能体工作流

Agent Teams 通过任务状态、消息、日志以及可审查的代码变更,让智能体的工作变得可见。

模式

模式 说明
Solo 单个队友,自行管理任务
Team 多个队友并行工作,互相审查

两种模式共享相同的看板、任务日志和代码审查界面。

任务生命周期

Agent Teams 沿着两个独立维度跟踪每个任务:工作状态与审查状态。

维度 状态 说明
工作状态 pendingin_progresscompleted 跟踪任务是处于等待、正在被处理,还是已被负责人完成
审查状态 nonereviewneedsFixapproved 跟踪任务在完成后审查流程中所处的位置

看板展示的是组合后的视图,但这两个维度各自独立移动。

工作状态流转

阶段 发生的事情 负责人
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. 最后一条任务评论包含验证命令及其结果。

如需更深入的调试,请使用故障排查中的持久化证据命令。UI 是工作界面,但对于棘手的启动或归属错误,持久化的任务文件、收件箱和运行时证据才是真正的依据。

并行工作模式

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

实时进程

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

跨团队通信

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