监控流水线运行

本页介绍运行启动之后的一切：找到它、了解每个步骤做了什么，以及让失败的运行重新动起来。要启动一次运行，请参阅手动运行流水线。

找到一次运行

在工作区侧栏中点击 流水线。此界面即工作区的运行队列——包含每一次运行，最新的排在最前。
用左侧栏筛选。筛选器恰好有三个，每个都带有实时计数：全部、运行中、失败。
用 ↑/↓（或 j/k）在表格中移动，按 Enter 打开聚焦的运行。点击某一行也有同样的效果。

每一行都用一个图标表示运行的启动方式（手动运行显示播放图标；代码图监听显示文件图标；其他情况显示自动触发器）。工具提示会给出触发器的名称——手动、PR 已发布、文件变更等——对于监听运行，还会说明哪些文件发生了变更。接着是流水线名称、状态徽章、有效时长（对于 queued 运行则是队列位置），以及本次尝试是多久前开始的。有效时长不包含空闲的停止与重启间隔，因此并不等于墙上时钟跨度。

没有针对已完成、已挂起或已取消运行的筛选器，没有按模板筛选，没有时间窗口，也没有按模板查看运行历史的功能。要比较同一模板的运行，只能按名称在队列中逐一查找。

查看运行详情

运行页面由三个上下排列的部分组成。

元信息条包含开始时间、有效时长、步骤进度（“3/7 个步骤”）、指出出错步骤及其原因的失败摘要，以及重试和删除操作。

时序瀑布图为每个步骤显示一个条形，标注其时长，对于智能体步骤还会标注以分为单位的成本。被重试过的步骤会在时长后显示 ×N 后缀；该后缀是尝试次数唯一出现的地方。

图画布绘制模板，并显示每个节点的实时状态。选中某个节点会打开它的步骤面板。

运行与步骤状态

状态	含义
等待中	已创建，尚未开始
排队中	已接纳但被暂缓：此模板的最大并行上限已满；尚无步骤记录
运行中	正在执行
已挂起	正在等待外部事项——属正常情况，并非卡住
已完成	成功完成
失败	以错误结束
已取消	被用户或系统停止

步骤具有上述除 排队中 以外的状态，另外还有 已跳过，用于表示路由器未走的分支（以及该分支中现已无法到达的后代步骤）。

已挂起 是智能体步骤大部分时间所处的状态：派发出去的智能体或审批门会一直占住该步骤，直到其工作完成。引擎有两道兜底机制会让整个运行失败而不是恢复：挂起超过 24 小时的步骤（extras.awaitApproval——即 orchestration.awaitApproval 主体——可豁免；human.gate 不豁免），以及服务器停止时正处于中途的非幂等步骤。

检查步骤

在画布上选中一个节点。步骤面板按顺序显示：

步骤失败时显示错误提示框，被跳过时显示带原因的 已跳过 提示框。
开始、结束和时长。
分支——并行分支的分支索引。
查看对话——跳转到该步骤运行所在的对话。流水线对话在侧栏中是隐藏的，因此这是唯一的进入方式。
输入和输出，以可折叠的 JSON 呈现。
智能体活动——该步骤派发的每个智能体运行对应一个卡片，显示其状态、摘要、时长和成本。

对于智能体步骤，输出是智能体通过 submit_output 提交的结构化载荷，而不是它的文字叙述。推理过程记录位于 智能体活动 以及 查看对话 背后的对话中。

对于 bash 步骤，输出是脚本在退出码为 0 时写入的、经过修剪的 stdout。非零退出会使该步骤失败，并以 stderr 的末尾部分作为错误消息。

恢复失败的运行

阅读元信息条上的失败摘要；它会指出失败的步骤。步骤面板的错误提示框中包含具体消息。
检查该步骤的输入——状态键缺失或拼写错误是最常见的原因。提示词智能体步骤会直接失败并指出未解析的占位符；bash 步骤则会把它们渲染为空字符串并照常运行，问题通常会在下一个步骤才暴露出来。
对于智能体步骤，打开 查看对话，看看智能体实际做了什么。
点击元信息条上的重试。已完成和已跳过的步骤保留其输出；其余步骤会被删除并重新执行，运行状态重新变为运行中。本次尝试的时长计时会重新开始。

值得优先检查的常见原因：

超时——该步骤超过了其 超时（毫秒）。请记住该字段的单位是毫秒。
脚本错误——bash 命令以非零码退出，或者服务器主机的 PATH 中没有 bash。
Schema 校验——智能体 submit_output 的载荷不满足该步骤的输出 schema。
未解析的占位符——提示词智能体步骤引用的某个 {{key}} 从未在上游写入。错误会列出每一个未解析的键。
未注册的主体——主体键未注册的步骤会在模板加载时发出警告，然后就是完全不执行。

停止卡住的步骤

选中正在运行的步骤，然后点击步骤面板标题栏中的 终止运行 按钮。这会杀死该步骤的进程，将步骤标记为失败，从而使整个运行失败——所有仍在进行的同级分支也会随之结束。

此界面没有取消运行的操作控件。pipeline.cancel 作为一项 RPC 操作存在，引擎也实现了它，但流水线界面中没有任何地方调用它；步骤上的 终止运行，或运行上的删除，是仅有的停止手段。

跟踪成本

成本按步骤报告，显示在瀑布图的右侧列中以及 智能体活动 下的每个卡片上。详情页没有运行总计，运行队列中也没有成本列，因此要比较两次运行的成本，只能把各自步骤的成本相加。