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

Maestro 用户指南

上次更新日期 2025年10月20日

如何 - 简单流程

概述

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

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



流程建模

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

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

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

  1. 导航到您的 Automation Cloud™ 租户。
  2. 在左侧边栏上的产品列表中,选择 "Maestro"。
  3. Maestro 登陆页面上,选择“开始建模”。 此时将打开新的智能体流程。
    提示:您还可以在 Studio Web 中新建智能体流程,开始进行建模。

  4. 右键单击,将项目重命名为“简单流程”,将流程重命名为“简单流程”。

    默认情况下,智能体流程是解决方案的一部分。阅读Studio Web 用户指南中的解决方案。



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

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

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

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

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

    注意:验证错误显示在画布的左下角。

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

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



  12. 为流程创建明确的结束是最佳实践。 要快速确定流程遵循的路径,请为每个流程创建明确的结束。

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



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

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

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

实施流程

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

  2. 使用这些值配置变量,然后单击“保存”。 将自动创建输出变量。
    • 名称:路径
    • Type: String
    • 值:A




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

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

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

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

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

    或者,您可以简单地将以下表达式复制/粘贴到表达式编辑器中:
    • A
      vars.path == "A"vars.path == "A"
    • B
      vars.path == "B"vars.path == "B"

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

注意:您可以通过右键单击.bpmn文件名称,下载 BPMN 以供在其他项目中使用。

调试流程

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

直接调试

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

  2. 观察每个步骤的执行方式。导航“执行历史记录”“全局变量/事件”部分,查看其他详细信息。简单流程调试
  3. 选择“返回设计模式”,以退出调试。

分步调试

分步运行流程,以便您可以操作path变量,以测试路由 B
  1. 选择“分步调试”。

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

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

  4. 在下一个对话框中选择“更新 1 变量”和“更新变量”,以提交更改。
  5. 选择“继续”,以完成执行。
  6. 观看每个步骤是如何执行的。 导航“执行追踪记录”和“全局变量/事件”部分,以查看其他详细信息。 这次,流程采用 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” 进行配置。

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

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

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

  10. 选择“重试”,添加注释,然后选择“重试实例”,以使用新变量重试步骤,并观看实例完成。
    注意:您可能需要刷新页面,才能查看完整的实例。


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

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

在流程版本之间迁移

当前的流程流逻辑不够强大,无法管理所有路径场景。 您正在通过发布新版本的流程来解决这个问题。此更新版本不仅能有效适应新的流程实例,还能纠正现有的有问题的实例。为了确保有效处理 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

  4. 将“B 任务”的任务名称更改为“非 A 任务”。
  5. 将结束事件“结束 B”的名称更改为“结束非 A”。
  6. 单击“发布”,选择“Orchestrator 个人工作区订阅源”,然后单击“发布”。

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

  1. 导航到 Maestro,选择“流程实例”,然后在“流程”列表中选择“简单流程”,以打开您流程的“所有实例”视图。
  2. 单击最新实例以打开实例查看器。 您将在“哪条路径?”中看到流程处于失败状态。网关。
    注意:您可能需要单击列表的“刷新”按钮,以查看最新实例。
  3. 选择“迁移”,选择您刚刚发布的流程的目标版本(应为 1.0.1,但可能不同),提供注释,然后选择“迁移实例”。

  4. 选择“重试”,添加注释,然后单击“重试实例”,以使用新变量重试步骤,并观察实例完成。
    注意:您可能需要刷新页面,才能查看完整的实例。


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

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

最终流程

这是最终流程的样子:

此页面有帮助吗?

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