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

Maestro 用户指南

上次更新日期 2025年11月21日

实施简单流程

概述

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

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

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



流程建模

备注:
  • Agentic process project configuration is currently tenant-bound. Make sure that you remain in the same tenant between editing sessions.
  • Agentic process project configuration currently supports only one business process (.bpmn) file. Although you can add multiple files to the project, this leads to unexpected issues for both debugging and publishing.

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

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

  1. 导航到您的 Automation Cloud™ 租户。
  2. 在左侧边栏上的产品列表中,选择 "Maestro"。
  3. Maestro 登陆页面上,选择“开始建模”。 此时将打开新的智能体流程。
    You can also start by creating a new Agentic Process in Studio Web.

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

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



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

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

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

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

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

    Validation errors are shown in the lower-left corner of the canvas.

  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 以供在其他项目中使用。

调试流程

You can configure breakpoints by hovering over the upper left of an element and selecting Click to add a breakpoint. Currently, breakpoints can only be set once you start debugging a process. However, they are retained between runs. Read about debugging and breakpoints.

直接调试

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

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

分步调试

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

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

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

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

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

发布和部署简单流程

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

  3. Read Publishing and upgrading agentic processes for the steps to publish to 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。保留所有权利。