调试基础知识

在画布上调试工作流：启动调试运行、读取结果、查找故障并使用模拟测试工作流的各个部分。

调试在与构建工作流相同的画布上进行。没有单独的调试视图：调试运行从画布开始，画布下方的面板显示结果，出现问题时在画布上进行更改。

启动调试会话

Run Debug (▶) in the bottom toolbar of the canvas starts a debug run, in every tool. If the trigger has inputs, a dialog asks for their values. In Studio Web, Debug at the top left of the toolbar does the same. A panel appears below the canvas, and the execution trace fills in as each node runs.

“停止调试”会显式结束运行，对工作流进行的任何更改也会导致运行结束。流画布描述了调试控件和画布下方的面板。

读取结果

画布下方的“执行”选项卡包含三个部分，每个部分回答不同的问题：

• 调试运行：运行列表，包含每次运行的名称、持续时间和期限。
• 执行追踪：按顺序运行的每个节点，并显示时间和成功或失败指示器。在追踪中选择一个节点，该节点会在画布上高亮显示，将鼠标悬停在节点上会显示追踪的开始和结束时间。
• 详细信息：对于运行，变量、故障和元数据选项卡。对于节点，指节点接收到的输入和产生的输出。

“故障”选项卡列出了按节点分组的运行错误。每个事件都会为失败的节点命名并包含错误消息。最好先在此处检查意外停止。

“变量”选项卡分为三个部分显示 Runtime 变量值：输入（传递到工作流中的值）、输出（生成的值）和变量（内部工作流变量）。在追踪中选择一个节点，将显示该点时的状态。“筛选变量”字段按名称搜索值。

识别故障

调试运行后，画布上的每个节点都会显示成功或失败指示器。发生故障的节点也会在执行追踪记录中标记，并且“故障”选项卡会显示错误消息。

错误对象包含message字段（人类可读描述）和detail字段（技术原因）。message字段包含面向用户的故障摘要，因此应该从这里开始。

使用模拟节点

静态模拟单独测试工作流的一部分。具有静态模拟的节点不会运行，并将模拟的数据传递到之后的节点。当先前的节点速度较慢、需要本地不可用的凭据或依赖于外部系统时，这非常有用。节点的展开视图可通过双击节点打开，并在“输出”列中包含模式菜单。静态模拟会将真实响应替换为其之后的节点所需的数据，而生成使 LLM 生成响应。输出模拟描述了两者。

通过一次模拟多个节点，调试运行可以专注于工作流的特定部分。

提示

• 先执行追踪，后故障：追踪记录显示整个运行情况，故障仅显示损坏的部分。
• 变量值可显示数据不匹配情况：将上一个节点收到的数据与下一个节点预期的数据进行比较。
• 模拟外部依赖项可以加快迭代速度：模拟调用 API 或触发 RPA 流程的节点可以调试逻辑，无需等待外部系统。
• 小型迭代速度更快：每个调试周期修复一次比尝试一次修复所有内容更高效。
• 描述性节点名称提高了追踪的可读性：追踪和事件引用节点名称，以及描述节点所做操作的名称使追踪更容易扫描。

后续步骤

• 流画布：调试控件和画布下方的面板。
• 错误处理:在节点上配置错误分支。
• 变量和数据流：变量如何在节点之间工作。
• 社区：在 UiPath 论坛上与其他构建器一起提问和共享工作流。