6.1 工作流 · BANZ 文档

工作流是一张流程图：一件事分几步、每一步谁来做、做完往哪走，都画好存起来，以后每次照着跑。这一页先讲几个基本概念，再讲工作流在哪里、怎么新建、工作流页上有什么，以及谁能做什么。

先弄懂几个词

以“官网改版”项目里的“上线前评审”为例：agent 先检查页面，检查通过就请林晓批准，批准了就结束；检查不通过直接以失败结束。

词	意思
步骤	图上的一个方块，代表一件事。每个工作流从“开始”出发，每条路都以“结束”收尾
连线	步骤之间的箭头，表示做完这一步接着做哪一步
agent 步骤	交给某个 agent 去做，做完交回结果。每做一次都会在主题里新建一个会话，适合几分钟到几小时的工作：写作、评审、改代码
模型步骤	由模型在几秒内回答一个简短的判断或改写，不碰文件，不用工具
人工步骤	停下来等一个人决定“通过”还是“驳回”，适合合并、发送、花钱这类要人拍板的事
条件	按前面的结果分两路走，比如“评审通过”走一路，“不通过”走另一路
输入	每次运行开始时要填的值，比如这次要评审哪个页面
运行	照着工作流跑一次。每次运行都在一个主题里进行，它建出的会话也放在这个主题里
草稿和版本	你在编辑器里改的是草稿；点“发布 v3”这类按钮后变成一个版本（v1、v2……）。版本不会再变，正常的运行都按某个版本跑
试运行	在编辑器里直接用草稿跑一次，用来检查刚改的地方，不用先发布

还有几种步骤，用到时再看：子工作流（把本项目另一个工作流当作一步）、循环（对列表里的每一项各跑一次）、模板（把已有的值拼成一段文字）、便签和分组（只是给看图的人写说明，运行时不读）。各步骤的设置见 6.2 编辑工作流。

工作流属于项目，项目里任何一个主题都可以运行它。

点导航栏的“工作流”，列表按项目分组。手机上在“我”页里。

每个工作流一行：

右键一行或点 ⋯：“打开”进入工作流页；你能编辑时还有“编辑”，直接打开编辑器。列表顶部标题旁有一个归档图标按钮，用来切换“显示已归档的工作流”和“显示进行中的工作流”。

项目页也有“工作流”标签，列出同样的工作流（见 4.1 项目）。

在“工作流”列表里，鼠标移到项目名那一行，点 +（“在官网改版中新建工作流”）。
填“名称”：以小写字母开头，只能用 a-z、0-9、- 和 _，最多 60 个字符，同一项目里不能重名，例如 release-review。命令行和文件里用这个名字。
填“标题”：大家看到的名字，例如“上线前评审”；留空就用名称。
点“创建工作流”。

建好后直接打开编辑器，接着画图（见 6.2 编辑工作流）。能看到项目的人都能新建工作流；已归档的项目不能新建。

点工作流打开它的页面。页头是标题、说明，旁边标着版本号或“草稿”、“已归档”、“定时运行”；下面写着名称、一共几步、你“可编辑”还是“只读”、最后修改时间。

页头的按钮：

按钮	作用
运行	启动一次运行（见 6.3 运行工作流与人工步骤）。发布过、且没有归档时才有
编辑	打开编辑器，修改图
“发布 v2”	把已保存的草稿发布成下一个版本，按钮上的数字就是下一个版本号。没保存时提示“请先保存草稿”，检查有问题时提示“请先改掉检查发现的问题”
把草稿复制为 YAML	把草稿当成一段文本复制下来，方便备份或发给别人
⋯	“编辑”改标题和说明；“归档”或“恢复为进行中”

下面五个标签：

标签	内容
图	只读的流程图，角标是问题数。点一步打开它的“设置 / 问题 / 后续”，可以点“在编辑器中编辑”，每个问题旁有“在编辑器中修改”
文件	工作流的文件（YAML），会写的人可以直接改，点“保存”
运行	这个工作流的历次运行，试运行标着“试运行”
版本	发布过的各个版本，点一下把它复制为 YAML。在某个版本上启动的运行会按它跑完
设置	名称、状态、最新版本（谁在什么时候发布的）、创建者、ID，以及“定时”（见 6.4 自动化）

做什么	谁能做
看项目的工作流和版本	能看到项目的人：个人项目只有你，组织项目是组织的所有成员
编辑、发布、归档、设定时	工作流的创建者；组织项目里还有组织的所有者和管理员
启动运行	要运行的那个主题的参与者
暂停、继续、重试、取消运行	发起这次运行的人，以及工作流的编辑者
试运行、单独运行一步	工作流的编辑者
做人工步骤的决定	这一步指定的决定人

agent 步骤用的是那个 agent 所在电脑上的 agent 程序和账号。
默认上限：每个工作流最多 50 步；一次运行同时最多 4 个 agent 步骤在工作；每个项目同时最多 10 个运行；嵌套最多 3 层；循环最多 100 项；已结束的运行保留 90 天。