设计 Maestro Flow

在 Studio Web 中使用流画布设计 Maestro Flow，包括如何添加和连接触发器和节点、配置属性、管理变量、处理错误以及调试流程。

备注：

Maestro Flow 处于预览阶段。

Maestro Flow 画布是一个可视化设计器，您可以在其中通过放置节点并按顺序连接节点来构建自动化。

Maestro Flow 画布

画布以边线连接的节点图形式显示您的流。执行从触发器节点开始，并按顺序流经每个已连接的节点。

要添加节点，请选择任何现有节点传出边缘上的+手柄，以打开“添加节点”面板。要手动连接两个节点，请从一个节点的输出句柄拖动到另一个节点的输入句柄。您可以通过在 Maestro Flow 画布上打开任何节点的标签来重命名任何节点。

顶部工具栏提供：

• 云端调试— 在云端运行端到端流程。
• 分步调试— 推进流程，一次一个节点。
• 发布— 打包流程并将其发布到 Orchestrator。

添加触发器

流程从默认的“手动触发器”节点开始，该节点按需启动流程。在画布上选择触发器，以在“属性”面板中对其进行配置。

触发器属性

• ID — 触发器的标识符，用于在表达式中引用其输出（例如$vars.manualTrigger1.output.userId ）。
• 标签— 触发器在画布上的显示名称。
• 变量— 触发器拥有的输入变量。当触发器触发时，其输入可在下游用作$vars.<triggerId>.output.<inputName> 。

添加节点

要添加节点，请选择任何节点传出边缘上的+手柄以打开“添加节点”面板，选择一个类别并选择节点类型。有关可用节点类型的完整列表，请参阅关于 Maestro Flow。

节点属性

选择一个节点，将在右侧的“属性”面板中打开其配置，该面板分为以下几个部分：

• 常规— 节点ID （在$vars表达式中使用）、标签（画布上的显示名称）、说明和图标颜色。
• 错误处理— 切换“启用错误处理”状态，向节点添加错误输出句柄。启用后且节点出现故障时，系统会路由到错误路径，而不是停止流。
• 更新变量— 在节点完成时为流程变量分配值。选择“+ 添加变量更新” ，选择目标变量，然后输入要赋值的表达式。

在“变量”选项卡（“属性”旁边）中，您可以定义流程级变量。每个变量都有名称、类型（字符串、数字、布尔值、对象或数组）和方向（输入、输出或双向）。

在画布上打开节点的上下文菜单，将打开包含以下内容的上下文菜单： “添加断点” 、 “添加探测器” 、 “复制” 、 “剪切” 、 “粘贴”和“删除” 。

变量和数据流

节点不会自动共享数据。下游节点通过使用$vars前缀的表达式访问节点的输出。

每个生成数据的节点都将其输出作为$vars.<nodeId>.output提供。节点 ID 是根据节点类型自动分配的，例如，第一个 API 工作流节点为apiWorkflow1 。您可以在“属性”面板的“常规”部分查看和编辑节点的 ID。

// Access the output of a node named apiWorkflow1
$vars.apiWorkflow1.output

// Access the response body of an HTTP request node
$vars.httpRequest1.output.body

使用“变量”选项卡，定义必须在整个流程中可访问的变量，或定义流程输入和输出的变量。变量被引用为$vars.<variableName> 。

有关完整的表达式语法和作用域规则，请参阅 Maestro 文档中的“变量和数据流” 。

错误处理

默认情况下，故障节点会停止整个流。要处理特定节点上的故障，请在节点的“属性”面板中切换“启用错误处理” 。这会将错误输出句柄添加到画布上节点的右下角。将错误句柄连接到下游节点，以将故障路由到单独的路径。

当节点发生故障且已连接其错误句柄时，错误详细信息将在错误路径上显示为$vars.<nodeId>.error ，其中字段包括message 、 code 、 status和detail 。

有关记录并继续、重试和警示并终止等模式，请参阅 Maestro 文档中的“错误处理” 。

调试 Maestro Flow

在顶部工具栏中选择“在云端调试” ，以端到端运行流程。运行完成后，选择画布上的任何节点以检查其输出。成功的节点显示绿色指示器；选中“失败的节点”时，会显示错误详细信息。

选择“分步调试”，以一次一个节点地推进流程。

打开任何节点的上下文菜单，然后选择“添加断点” ，以在调试运行期间暂停该节点上的执行。选择“添加探测器” ，以不间断地捕获节点的输出。

相关链接

• 变量和数据流
• 错误处理
• 子流
• 控制流程
• 发布和部署流程