BANZ文档

6.3 运行工作流与人工步骤

本页内容

发布过的工作流可以随时运行。这一页讲怎么启动一次运行、在运行页上看它跑到哪一步、失败了怎么办,以及轮到你做决定时怎么处理。

启动一次运行

  1. 打开工作流页,点“运行”。
  2. 选“主题”:只列出这个项目里你参与的、进行中的主题。工作流设了默认主题时会预先选中它(默认主题怎么设见 6.4 自动化)。
  3. 填开始的各项输入。列表类型的输入每行写一个。
  4. 点“运行”。

提示“上线前评审 已开始”,同时打开这次运行的页面,左边列表栏也展开到这次运行。

项目里没有你参与的进行中的主题时,会提示:运行要在一个主题里进行。先去建一个或加入一个(见 4.2 主题)。

运行页

运行页顶部是状态:运行中、已暂停、完成、失败、已取消。下面写着:

  • 按哪个版本跑,这里显示的是工作流的名称,例如“release-review,v2”;试运行写“release-review,草稿”;
  • 在哪个主题里、谁在什么时候发起的;
  • 已经跑了多久,完成了几步(例如“已完成 2/4 步”)。

画布上每一步都标着状态:未到达、等待中、运行中、等待决定、已跳过、完成、失败。打开“跟随运行中的步骤”,画布会跟着正在跑的那一步移动。

点一步打开它的面板,有“尝试 / 输出 / 设置”三个标签。agent 步骤的每次尝试写着“第 N 次”和状态(正在创建会话、工作中、已提醒、完成、失败),点“打开会话”就能进到 agent 干活的那个会话。

页面下方还有“步骤”“输入”“产出”几块;失败时有“失败原因”,点“查看步骤”跳到出错的那一步。

运行中的运行页:一步完成,一步在跑
运行中的运行页:一步完成,一步在跑

运行建出的会话

每个 agent 步骤每尝试一次,就在主题里新建一个会话:

  • 标题是“工作流标题 #编号 · 步骤标题”,步骤没写标题时用步骤 ID,例如“上线前评审 #3 · check”。同一步从第二次尝试起,标题后面会加上“(try 2)”这样的字样;试运行建出的会话在编号后面多一段“· test”,例如“上线前评审 #3 · test · check”。
  • 步骤打开了“工作树”时,会话在新的工作树里运行。
  • 会话页上写着“由 上线前评审 #3 为 林晓 创建”,鼠标移上去可以打开这次运行。
  • 在左边列表栏里,运行挂在主题下面,它的会话挂在运行下面。
  • 这一步结束后,会话在看板上自动移到“已完成”或“已取消”(见 4.3 看板、工作状态与标签)。

用别人的 agent 时,会话照样跑在那个人的电脑上,发起运行的人是指派者。

列表栏里挂在主题下的运行和它的会话
列表栏里挂在主题下的运行和它的会话

暂停、重试、取消

运行页顶部的按钮:

按钮 作用
暂停 / 继续 暂停后不再开始新的步骤,正在跑的照常跑完
重试 只在失败后才有:从失败的步骤重新运行,每一步都从它的下一次尝试开始。试运行和单独运行一步不能重试
取消运行 正在工作的每一步都会停下,运行以“已取消”结束

轮到你做决定

工作流走到人工步骤,而决定人是你时:

  • 收件箱里出现“在 上线前评审 #3 中决定 approve”(approve 是这一步的 ID),原因写着“工作流运行”;系统通知会提醒你有人在等你答复。
  • 工作流列表和项目页的工作流卡片上显示“等你决定”。

处理方法:

  1. 在收件箱里点这一条,打开运行页。收件箱里不能直接回答,要到运行页上处理。
  2. 运行页顶部有“等你决定”一块,写着它问你什么。
  3. 点“批准”:填这一步要求的字段,可以写“备注”。点“拒绝”:备注必填,写明原因。

批准走“通过”出口,拒绝走“驳回”出口。过了这一步设的“等待”时限还没人决定(没设时默认 12 小时):工作流里接了“超时”出口的就走超时;没接的,这一步失败,整个运行也失败。

运行失败时,收件箱里会出现一条“上线前评审 #3 失败了”,点开进入运行页查看失败原因。

运行页的等你决定区和批准表单
运行页的等你决定区和批准表单
Esc

↑↓选择↵打开Esc关闭