手动执行工作流
在编辑器里点"执行",或在列表里批量跑 —— 并看懂右侧的实时事件流。
手动执行是你把工作流跑起来最基本的方式 —— 开发调试、一次性业务需求、定期非定时的汇报都走这个入口。这一篇讲清楚"在哪里点、对话框里每一项是什么、跑起来后看什么"。
三种手动执行入口
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 模式 —— 可以设断点、单步执行、看变量、修改变量。详见 断点调试。
启动后的行为
点「开始执行」后:
- 前端立刻创建一个 execution 记录(状态 PENDING),页面自动跳到执行详情。
- 平台调度器拉起执行(通常 < 200ms 内从 PENDING 变 RUNNING)。
- 页面建立 SSE 连接,每个事件推过来实时刷新 UI。
- 画布中"正在跑的 step"被高亮;完成的标绿色,失败的标红色。
右侧实时事件流
执行详情页的右栏是一条"日志+事件"混合流。重要事件类型:
execution.started/execution.finished— 执行的起止step.started/step.completed/step.failed/step.skipped— 步骤生命周期step.log— code step 的 stdout / stderragent.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:
- 状态先变成 CANCELLING
- 当前正在跑的 step 收到中断信号(code step 会收到 SIGTERM,LLM step 主动 abort)
- 所有 step 停下来后状态变 CANCELLED
有些耗时操作(长网络超时)可能无法立刻响应 —— 沙箱级硬超时会兜底,最多 5 分钟一定能停下。
跑完后怎么看结果
执行详情页
- 甘特图 — 整体时间线、每个 step 的耗时
- step 列表 — 按顺序的 step 状态概览
- step 详情 — 输入 / 输出 / 事件日志 / 工具调用
- 变量面板 — 这一步执行前的所有可用变量快照
- 产物栏 — 生成的文件,点开预览或下载
Token & Cost
顶部摘要条显示:总耗时、总 tokens (in / out)、总成本 (USD)。点展开可看每个 LLM step 的单独消耗。
常见操作
用同样的参数重跑一次
执行详情页右上角「重试」按钮 —— 用这次 execution 的 variables 立刻再发起一次新 execution。方便对比两次结果。
从中间某一步重跑
点某个 step 旁的「从这一步重试」—— 前面已完成的 step 结果保留,从这一步开始重新走。适合"某个 step 出错修好后不想从头再花钱"。
导出执行报告
顶部「导出」可以把整次 execution 的元数据 + step 详情 + 产物导出为 JSON。适合事后回溯或分享给同事。