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

Maestro 用户指南

上次更新日期 2025年5月19日

执行简单流程

在此示例中,您将实施一个简单的智能体流程,完成包括流程建模、实施、调试、发布、部署和管理在内的核心 Maestro 功能。这个简单的流程示例不使用任何其他 UiPath 产品。

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

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

流程建模

首先,开始对端到端流程进行建模,然后配置组件。
  1. 导航到您的 Automation Cloud™ 租户。
  2. 在左侧边栏上的产品列表中,选择 "Maestro"。
  3. Maestro 登陆页上,选择“开始”。
    提示:您还可以在 Studio Web 中新建智能体流程,开始进行建模。
    此时将打开新的智能体流程。
  4. 在设计界面的左上角,选择“开始”。
  5. 将项目重命名为“简单项目”,将流程重命名为“简单流程”。


  6. 关闭项目资源管理器。
  7. 选择画布上的开始事件元素,以便显示元素工具栏。在元素工具栏中选择“添加:文本标记”。
  8. 选择开始事件元素,然后在元素工具栏中选择“添加:中间事件”。
    1. 双击中间元素,以对其进行重命名。将其重命名为“延迟”。
      提示:您还可以在屏幕右侧的“属性”选项卡中的“命名”字段中对元素进行重命名。
    2. 将“延迟”中间事件更改为“计时器中间捕获事件”。


  9. 选择“延迟”计时器中间捕获事件,然后选择“添加:排他网关”。
    1. 将排他网关命名为“哪条路径?
  10. 选择“哪条路径?”排他网关,然后选择“添加:任务”。
    1. 将任务命名为“A 任务”。
    提示:在绘制和配置流程时,画布上会显示验证错误。如果要隐藏这些可视化内容,请在右上角工具菜单中选择“隐藏验证错误”。


  11. 再次选择“哪条路径?”排他网关,然后选择“添加:任务”。
    1. 将任务命名为“B 任务”。


  12. 选择“哪条路径?”排他网关。
    1. 展开“属性”选项卡中“条件”部分的第一个条件。
      生成的条件名称以 edge_Gateway_{randomcharacters} 开头。
    2. 在第一个条件的“标签”字段中键入 A
    3. 展开第二个条件。
    4. 在第二个条件的“标签”字段中键入 B


  13. 选择“A 任务”,然后在事件工具栏中选择“添加:结束事件”。
    1. 将结束事件命名为“结束 A”。
    提示:作为最佳实践,请为流程创建明确结束。用于快速确定您的流程采用的是哪条路径,以及每个流程的明确结束。
  14. 选择“B 任务”,然后在事件工具栏中选择“添加:结束事件”
    1. 将结束事件命名为“结束 B”。


实施流程

按照此程序,为在“流程建模”部分中创建的流程添加功能。
  1. 选择“开始事件”元素,然后将其重命名为“手动开始”。
  2. 在“属性”选项卡的“输入”部分中选择“新增”。


  3. 按照以下方法创建新变量:
    • 名称:路径
    • 类型:字符串
    • 值:A


  4. 选择“保存”
    此时将创建新变量。
  5. 选择“延迟”计时器中间捕获事件。
  6. 转到“属性”选项卡中的“计时器”部分,然后添加以下值:
    • 类型:持续时间
    • 值:从值配置中添加 5 秒


  7. 选择“哪条路径?”排他网关。
  8. 展开“属性”选项卡的“条件”部分中的条件。
  9. 配置第一个条件。
    1. 在第一个条件中选择“打开表达式编辑器”。


    2. 使用“插入变量”查找并插入“手动开始”输出变量 path
    3. 将值设置为等于 "A"
    4. 选择“保存”


  10. 配置第二个条件。
    1. 在第二个条件中选择“打开表达式编辑器”。
    2. 使用“插入变量”查找并插入“手动开始”输出变量 path
    3. 将值设置为等于 "B"
    4. 选择“保存”


    提示:您也可以简单地将以下表达式复制并粘贴到表达式编辑器中:
    • 表达式 Avars.path == "A"
    • 表达式 Bvars.path == "B"

调试流程

首先直接运行流程,以确保流程配置正确。由于 path 变量的默认值设置为 A,因此流程应进入“A 任务”和“结束 A”。
将光标悬停在元素的左上角,然后选择“点击以添加断点”,以便配置断点。目前,只有在开始调试流程后才能设置断点。但是,断点会在运行之间保留。

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


    每执行一个步骤时都会运行动画。您可以与示意图交互。选中“执行追踪”和“全局变量”选项卡,以查看其他详细信息。

  2. 选择“返回设计模式”,以退出调试。
  3. 选择“分步测试”,以使用 path 变量测试路由 B
  4. 选择“下一步”,以将执行移动到“延迟”计时器中间捕获事件。
  5. 在“全局变量”选项卡中,将 path 变量的“手动开始”值更新为 B


    注意:由于一个已知问题,调试时没有可视指示器可以帮助您区分名称相同的输入和输出变量。当您在列表中看到输入和输出变量同时存在时,输入将位于输出之前。您应编辑第一个变量,即输入变量,而非值为 null 的输出。
  6. 在对话框中选择“更新 1 个变量”,然后选择“更新变量”以提交更改。
  7. 选择“继续”,以完成执行。
    每执行一个步骤时都会运行动画。您可以与示意图交互。有关其他详细信息,请查看“执行追踪”和“全局变量”选项卡。这次,流程采用 B 路由。

  8. 选择“返回设计模式”,以退出调试。
您现在已经完成第一个流程的调试。

发布、部署和启动流程

  1. 选择“发布”,以发布智能体流程。
    1. 在“位置”字段中选择“Orchestrator 个人工作区订阅源”。
    2. 选择 “发布”


    注意:发布到 Orchestrator 个人工作区订阅源的流程会自动部署,但发布到租户或文件夹订阅源的流程仍然必须作为单独步骤部署到 Orchestrator。
    注意:在新租户中,默认设置仅在个人工作区中提供机器人。如果要在常规文件夹(非个人工作区)中执行第一个流程,需要进行额外设置。
    要在其他文件夹中运行作业,您必须:
    1. 创建机器人(用户或 Unattended)并将其分配给该文件夹。
    2. 确保您的用户或计算机拥有必要的权限和 runtime 许可证。

    有关配置机器人和文件夹的更多信息,请参阅“在 Orchestrator 中管理作业”。

  2. 导航到 Orchestrator
  3. 转到“我的工作区”。
  4. 转到“自动化”选项卡,然后在“流程”列表中找到 "Simple.Process"。


  5. 选择 "Simple.Process" 条目中的“开始作业”。
  6. 选择“开始”。


您现在已经完成第一个流程的发布、部署和启动。

管理智能体流程

  1. 导航到 Maestro 服务。
  2. 在流程列表中选择“简单流程”,以打开流程的“所有实例”视图。
    提示:您还可以根据需要使用搜索字段对列表进行筛选。
  3. 选择最新实例,以打开实例查看器。
    您可以查看流程在每个步骤中的实时执行情况。

    选择模型背景,以查看“全局变量”和“操作历史记录”以及“执行追踪”。在模型或执行追踪中选择一个步骤,以检查该执行步骤的“详情”和“变量”。

您现在已经完成第一个流程的管理。

损坏和修复流程

在此程序中,我们会导致执行失败,以便使用实例管理进行恢复。
  1. 导航到 Orchestrator
  2. 转到“我的工作区”。
  3. 转到“自动化”选项卡,然后在“流程”列表中找到 "Simple.Process"。


  4. 选择 "Simple.Process" 条目中的“开始作业”。
  5. path 变量的值更改为 C


  6. 选择“开始”。
  7. 导航到 Maestro
  8. 在流程列表中选择“简单流程”,以打开流程的“所有实例”视图。
  9. 选择最新实例,以打开实例查看器。
    流程在哪条路径?排他网关上处于失败状态。



  10. 选择“哪条路径?”排他网关步骤,以检查“网关没有输出流”错误。
    此错误在意料之内,因为没有配置 path == "C"

  11. 在“状态和步骤”面板中选择第一步,以查看“全局变量”。


  12. path 变量的第二个“手动开始”输出值(第二行)更新为 A,使其符合配置的条件。


  13. 选择“更新 1 个变量”,以更新变量。
  14. 在“备注”字段中添加备注,以供审核。


  15. 选择“重试”。
  16. 添加备注,然后选择“重试实例”,以使用新变量重试步骤,并完成实例。


  17. 访问“操作历史记录”选项卡,以查看变更的审核追踪记录。
您已成功修复损坏的实例。

在流程版本之间迁移

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

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

  1. 导航到 Orchestrator
  2. 转到“我的工作区”。
  3. 转到“自动化”选项卡,然后在“流程”列表中找到 "Simple.Process"。
  4. 选择 "Simple.Process" 条目中的“开始作业”。
  5. path 变量的值更改为 C


  6. 选择“开始”。
  7. 导航到 Studio,然后打开“简单流程”。
  8. 选择“哪条路径?”排他网关。
  9. B 标签更改为“非 A”,将条件更改为 vars.path != A


  10. 将“B 任务”任务名称更改为“非 A 任务”。
  11. 将“结束 B”结束事件更改为“结束非 A”。
  12. 选择“发布”,以发布项目。
    1. 在“位置”字段中选择“Orchestrator 个人工作区订阅源”。
    2. 选择 “发布”
  13. 导航到 Maestro
  14. 在流程列表中选择“简单流程”,以打开流程的“所有实例”视图。
  15. 选择最新实例,以打开实例查看器。
    流程在哪条路径?排他网关上处于失败状态。
  16. 选择“迁移”,以迁移流程。
    1. 选择您刚发布的流程的目标版本
      在此示例的上下文中,版本应为 1.0.1
    2. 提供备注。
    3. 选择“迁移实例”。


  17. 选择“重试”,以使用新变量重试步骤。
    1. 提供备注。
    2. 选择“重试实例”。


  18. 访问“操作历史记录”选项卡,以查看变更的审核追踪记录。
您已成功将损坏的实例迁移到新版本的流程。

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
© 2005-2025 UiPath。保留所有权利。