跳转到主要内容
文档运行手动执行

手动执行工作流

在编辑器里点"执行",或在列表里批量跑 —— 并看懂右侧的实时事件流。

手动执行是你把工作流跑起来最基本的方式 —— 开发调试、一次性业务需求、定期非定时的汇报都走这个入口。这一篇讲清楚"在哪里点、对话框里每一项是什么、跑起来后看什么"。

三种手动执行入口

1. 在编辑器里点「执行」

最常用。适合你正在改一条工作流、想立刻试一跑。

2. 在工作流列表卡片上点「▶ 执行」

适合一条已经稳定的工作流、不想打开编辑器的时候。

3. 批量执行

在工作流列表顶部勾选多条,点「批量执行」。弹窗里:

  • 每条工作流分别填 variables(或直接用默认值)
  • 选并发数(1–10)控制同时开几条
  • 选失败策略:一条失败是否中断其它条

执行对话框拆解

无论哪个入口,点「执行」后会弹一个结构一致的对话框:

参数(variables)区

自动按 workflow.variables 展示每个参数:

  • 有默认值的预填
  • 必填的加红色星号
  • 有 description 的 hover 可看解释
  • 枚举类型用下拉菜单
  • 数组 / 对象类型直接编辑 JSON

Dry-run 开关

强烈建议第一次跑勾选。详见上面 Quickstart。

触发来源 (debug)

默认 manual。如果想模拟"定时触发"或"Webhook 触发"来调试,可以切换 —— 某些步骤的 condition 可能依赖这个。

Recovery 开关(Pro+)

工作流声明了 recovery.autoResumeOnRestart 时,对话框里多一个"本次执行是否允许自动续跑"的 toggle。详见 自动续跑

Debug 开关(Pro+)

勾选后本次执行进入 debug 模式 —— 可以设断点、单步执行、看变量、修改变量。详见 断点调试

启动后的行为

点「开始执行」后:

  1. 前端立刻创建一个 execution 记录(状态 PENDING),页面自动跳到执行详情。
  2. 平台调度器拉起执行(通常 < 200ms 内从 PENDING 变 RUNNING)。
  3. 页面建立 SSE 连接,每个事件推过来实时刷新 UI。
  4. 画布中"正在跑的 step"被高亮;完成的标绿色,失败的标红色。

右侧实时事件流

执行详情页的右栏是一条"日志+事件"混合流。重要事件类型:

  • execution.started / execution.finished — 执行的起止
  • step.started / step.completed / step.failed / step.skipped — 步骤生命周期
  • step.log — code step 的 stdout / stderr
  • agent.message — Agent 的一条中间发言(group_chat 里最常见)
  • agent.tool_call — Agent 调了一个工具 + 参数 + 返回值
  • artifact.emitted — 产生了一份产物(Markdown / Excel / 图像 / JSON)
  • breakpoint.hit — 命中了断点
  • approval.requested / approval.granted / approval.denied

每个事件带时间戳、层级(debug / info / warn / error)、归属 step。过滤栏可以按类型 / 层级筛选。

中途取消

执行详情页右上角的「取消」按钮可以主动停止一个 RUNNING 的 execution:

  1. 状态先变成 CANCELLING
  2. 当前正在跑的 step 收到中断信号(code step 会收到 SIGTERM,LLM step 主动 abort)
  3. 所有 step 停下来后状态变 CANCELLED

有些耗时操作(长网络超时)可能无法立刻响应 —— 沙箱级硬超时会兜底,最多 5 分钟一定能停下。

跑完后怎么看结果

执行详情页

  • 甘特图 — 整体时间线、每个 step 的耗时
  • step 列表 — 按顺序的 step 状态概览
  • step 详情 — 输入 / 输出 / 事件日志 / 工具调用
  • 变量面板 — 这一步执行前的所有可用变量快照
  • 产物栏 — 生成的文件,点开预览或下载

Token & Cost

顶部摘要条显示:总耗时、总 tokens (in / out)、总成本 (USD)。点展开可看每个 LLM step 的单独消耗。

常见操作

用同样的参数重跑一次

执行详情页右上角「重试」按钮 —— 用这次 execution 的 variables 立刻再发起一次新 execution。方便对比两次结果。

从中间某一步重跑

点某个 step 旁的「从这一步重试」—— 前面已完成的 step 结果保留,从这一步开始重新走。适合"某个 step 出错修好后不想从头再花钱"。

导出执行报告

顶部「导出」可以把整次 execution 的元数据 + step 详情 + 产物导出为 JSON。适合事后回溯或分享给同事。

什么时候该用手动执行,什么时候用其它触发

  • 手动 — 开发调试、一次性需求、"我现在就想让它跑"
  • 定时调度 — 固定频率自动触发
  • Webhook — 外部系统事件驱动

下一步