maestro
latest
false
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath logo, featuring letters U and I in white

Maestro 用户指南

上次更新日期 2026年3月13日

实施简单流程

概述

根据您的用例需求,在 Maestro 中开始使用可以简单,也可以高级。 简单流程可能涉及几个相互关联的步骤,例如接收输入、运行自动化以及返回结果,非常适合进行概念快速验证或实现简单的业务流。 本节将为您介绍简单流程,以便您了解基础知识。

本指南演示了如何实施简单流程,突出了核心智能体编排功能:建模、实施、调试、发布、部署和管理。 此流程不涵盖与其他 UiPath 产品的集成。 有关设置和实施依赖项(例如 Data Fabric、Integration Service、Studio Web、Agents 和 Action Center Action 应用程序)的说明,请参阅“操作方法 – 复杂流程”。

其目的在于构建类似于下图的简单路由流程:

docs image

流程建模

备注:
  • 智能体流程项目配置目前为租户绑定。 务必在编辑会话之间保持同一个租户。
  • 智能体流程项目配置目前仅支持一个业务流程 (.bpmn) 文件。 虽然您可以将多个文件添加到项目中,但这会导致调试和发布时出现意外问题。

首先对端到端流程进行建模,然后配置组件。

将智能体流程创建为新类型的 Studio 项目。

  1. 导航到您的 Automation Cloud™ 租户。

  2. 在左侧边栏上的产品列表中,选择 "Maestro"。

  3. Maestro 登陆页面上,选择“开始建模”。 此时将打开新的智能体流程。

    您也可从在 Studio Web 中新建“智能体流程”开始。

    智能体编排类型流程

  4. 右键单击,将项目重命名为“简单流程”,将流程重命名为“简单流程”。 默认情况下,您的智能体流程是解决方案的一部分。阅读《Studio Web 用户指南》中的解决方案。

    重命名简单流程

  5. 选择“开始”元素,单击工具箱中的“添加:文本批注”,然后输入“输入变量路径”。

    添加文本注释

  6. 选择“开始”元素,然后从工具箱中单击“添加:中间事件”。

    添加中间事件

  7. 从工具栏中选择“更改元素”,然后选择“计时器中间捕获事件”,然后在中间事件名称中输入“延迟”。

    计时器中间捕获事件

  8. 选择“计时器”元素,单击工具箱中的“添加:专用网关”,然后在网关名称中输入“哪个路径?”。

    docs image

  9. 选择网关,单击“添加:任务”,然后在名称中输入“A 任务”。

    添加任务

    验证错误将显示在画布的左下角。

    验证问题

  10. 再次选择网关,单击“添加:任务”,然后在名称中输入“B 任务”。

    哪个路径

  11. 选择网关,展开第一个条件,其生成的名称将以 edge_Gateway_{randomcharacters} 开头,然后在标签中输入 "A"。展开第二个条件,然后在标签中输入 "B"。

    条件

    条件标签

  12. 为流程创建明确的结束是最佳实践。 要快速确定流程遵循的路径,请为每个流程创建明确的结束。 选择“A 任务”,单击工具箱中的“添加:结束事件”,然后在名称中输入“结束 A”。

    结束 A

  13. 选择“B 任务”,单击工具箱中的“添加:结束事件”,然后在名称中输入“结束 B”。

    B 末尾

恭喜!您现已创建了第一个 BPMN 端到端流程!

现在,为流程添加一些功能。

实施流程

起始事件

  1. 选择“开始”元素,在“属性面板”中,在“名称”中输入“手动开始”,在“参数”部分中选择“新增”,以添加我们在开始流程时可以使用的变量。

    属性开始事件

  2. 使用这些值配置变量,然后单击“保存”。 将自动创建输出变量。

    • 名称:路径
    • Type: String
    • 值:A

    添加变量

    start_event_input_arguments

  3. 选择“延迟”事件,打开“属性面板”,在“计时器”部分中选择“类型=持续时间”,在值配置中选择“5 秒”。

    duration

  4. 选择网关,然后展开“条件”以输入“否”和“是”路径的条件,然后选择文本条目选取器以打开表达式编辑器以输入条件。

    表达式编辑器

  5. 使用“插入变量”查找并插入“手动开始”输出变量 path

    use_variable

    将值设置为“A”,然后选择“保存”。

    插入变量 A

  6. 打开条件 B 的表达式编辑器,然后插入“手动开始”输出变量路径,将值设置为“B”,然后单击“保存”。

    docs image

    或者,您可以简单地将以下表达式复制/粘贴到表达式编辑器中:

    • A

      vars.path == "A"
      vars.path == "A"
      
    • B

      vars.path == "B"
      vars.path == "B"
      

恭喜!您现已完全配置第一个流程。

备注:

您可以通过右键单击.bpmn文件名来下载 BPMN,以用于其他项目。

调试流程

您可以将鼠标悬停在元素的左上方,然后选择“点击以添加断点”,以此来配置断点。目前,只有在开始调试流程后才能设置断点。但是,断点会在运行之间保留。阅读有关调试和断点的信息

docs image

直接调试

首先,直接运行您的流程,以确保您已正确配置。 将 path 变量的默认值设置为 "A",您可以看到它流向 A 任务结束 A

  1. 选择“调试”以测试您的流程。

    “调试”面板

  2. 观看每个步骤是如何执行的。导航“执行追踪”和“全局变量/事件”部分,以查看其他详细信息。简单流程调试

  3. 选择“返回设计模式”,以退出调试。

分步调试

分步运行流程,以便您可以操作path变量,以测试路由 B

  1. 选择“分步调试”。

    debug_step_by_step

  2. 选择“下一步”,以将执行移到计时器

    下一步

  3. 将“手动开始”事件来源的 path 全局变量更新为 B。按回车键或 Tab 键以提交更改。

    全局变量

  4. 在下一个对话框中选择“更新 1 变量”和“更新变量”,以提交更改。

  5. 选择“继续”,以完成执行。

  6. 观看每个步骤是如何执行的。导航“执行追踪记录”和“全局变量/事件”部分,以查看其他详细信息。 这次,流程采用 B 路由。

    流程路由 B

  7. 选择“返回设计模式”,以退出调试。

发布和部署简单流程

  1. 选择“发布”

  2. 选择“位置”,然后选择“发布”。

    发布解决方案

  3. 阅读“智能体流程的发布和升级”,了解发布到 Orchestrator 的步骤。

恭喜!您现已完全发布、部署和启动第一个流程。

现在,需要进行 runtime 实例管理。

管理业务流程

  1. 在 Automation Cloud 门户中,导航到 Maestro 服务。

  2. 在流程列表中选择“简单流程”,以打开您流程的“所有实例”视图。 如果需要,您可以使用“搜索”筛选列表。

    简单流程

  3. 选择最新实例以打开实例查看器。 您将在每个步骤中看到流程的实时执行(假设 5 秒延迟计时器仍在执行)。

    简单流程

您可以单击模型背景,以查看全局变量操作历史记录以及执行追踪记录。 您可以单击模型中的节点或执行历史记录,以检查该执行步骤的“详细信息”和“变量”。恭喜!您现在已完全管理第一个流程。 现在中断我们的流程,以便您进行修复!

中断和修复流程

在此程序中,我们会导致执行失败,以便使用实例管理进行恢复。

  1. 转到 Orchestrator 中的“我的工作区”文件夹的“自动化”选项卡,然后在“流程”列表中找到 Simple.Process

  2. Simple.Process 条目中选择“开始作业”,但这次在开始中断之前编辑“参数”。

  3. 选择“参数”选项卡,然后编辑 path 变量。 将值设置为 "C",然后选择“保存”。

    参数路径

  4. 选择“开始”。

  5. 导航到 Maestro,然后在“流程”列表中选择“简单流程”,以打开您流程的“所有实例”视图。

    “所有实例”视图

  6. 选择“哪条路径?”网关步骤,可以看到“网关无传出流”错误,这在预料之内,因为我们未对 path==”C” 进行配置。

    errors

  7. 单击第一步中的容器或模型背景,以查看全局变量

    global_variables

  8. 通过将“手动开始”输出的 path 变量(第二个)更新为 A,确保流符合配置的条件。

    手动开始 C

  9. 选择“更新 1 变量”以更新变量,并添加注释以用于审核。

    更新变量

  10. 选择“重试”,添加注释,然后选择“重试实例”,以使用新变量重试步骤,并观看实例完成。

    :::note
    You might need to refresh the page to see the instance complete.
    :::
    
    ![retry instance](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-retry-instance-597470-64bdf93f.webp)
    :::note
    You might need to refresh the page to see the instance complete.
    :::
    
    ![retry instance](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-retry-instance-597470-64bdf93f.webp)
    
  11. 请查看“操作历史记录”,以查看我们更改的审核追踪记录。

    action_history

恭喜!您已成功修复损坏的实例。

在流程版本之间迁移

当前的流程流逻辑不够强大,无法管理所有路径场景。 您正在通过发布新版本的流程来解决这个问题。此更新版本不仅能有效适应新的流程实例,还能纠正现有的有问题的实例。为了确保有效处理 path 不等于 A 的所有场景,请将,请将 B 路由修改为“非 A”路由。

在此程序中,您会导致执行失败,以便使用新版本进行修复。

  1. 导航到 Orchestrator
  2. 转到“我的工作区”。
  3. 转到“自动化”选项卡,然后在“流程”列表中找到 "Simple.Process"。
  4. 在“简单流程”条目中选择“开始作业”,然后选择“开始”。
  5. 选择“参数”选项卡,然后编辑 path 变量。
  6. 将值设置为 "C",然后选择“保存”。
  7. 选择“开始”。

现在修复您的流程,以便您能够迁移此损坏的实例。

  1. UiPath Studio 中打开“简单流程”。

  2. 选择“哪条路径?”网关,然后打开“属性”面板。

  3. B 标签更改为“非 A”,并将条件更改为 vars.path != A

    vars 路径

  4. 将“B 任务”的任务名称更改为“非 A 任务”。

  5. 将结束事件“结束 B”的名称更改为“结束非 A”。

  6. 单击“发布”,选择“Orchestrator 个人工作区订阅源”,然后单击“发布”。

现在,将您损坏的实例迁移到新版本。

  1. 导航到 Maestro,选择“流程实例”,然后在“流程”列表中选择“简单流程”,以打开您流程的“所有实例”视图。

  2. 单击最新实例以打开实例查看器。 您将在“哪条路径?”中看到流程处于失败状态。网关。

    备注:

    您可能需要单击刷新按钮以查看最新实例。

  3. 选择“迁移”,选择您刚刚发布的流程的目标版本(应为 1.0.1,但可能不同),提供注释,然后选择“迁移实例”。

    迁移实例

  4. 选择“重试”,添加注释,然后单击“重试实例”,以使用新变量重试步骤,并观察实例完成。

    备注:

    您可能需要刷新页面,才能查看完整的实例。

    重试实例

  5. 请查看“操作历史记录”,以查看您更改的审核追踪记录。

恭喜!您已成功将损坏的实例迁移到新版本的流程!

最终流程

这是最终流程的样子:

最终流程

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新