- 简介
- 入门指南
- 流程建模
- 流程实施
- 流程运营
- 流程监控
- 流程优化
- 参考信息
Maestro 用户指南
概述
根据您的用例需求,在 Maestro 中开始使用可以简单,也可以高级。 简单流程可能涉及几个相互关联的步骤,例如接收输入、运行自动化以及返回结果,非常适合进行概念快速验证或实现简单的业务流。 本节将为您介绍简单流程,以便您了解基础知识。
本指南演示了如何实施简单流程,突出了核心智能体编排功能:建模、实施、调试、发布、部署和管理。 此流程不涵盖与其他 UiPath 产品的集成。 有关设置和实施依赖项(例如 Data Fabric、Integration Service、Studio Web、Agents 和 Action Center Action 应用程序)的说明,请参阅“操作方法 – 复杂流程”。
其目的在于构建类似于下图的简单路由流程:
流程建模
- 智能体流程项目配置目前为租户绑定。 务必在编辑会话之间保持同一个租户。
- 智能体流程项目配置目前仅支持一个业务流程 (.bpmn) 文件。 虽然您可以将多个文件添加到项目中,但这会导致调试和发布时出现意外问题。
首先对端到端流程进行建模,然后配置组件。
将智能体流程创建为新类型的 Studio 项目。
-
导航到您的 Automation Cloud™ 租户。
-
在左侧边栏上的产品列表中,选择 "Maestro"。
-
在 Maestro 登陆页面上,选择“开始建模”。 此时将打开新的智能体流程。
您也可以从在 Studio Web 中新建“智能体流程”开始。
-
Open the context menu to rename the project to Simple Process, and the process to Simple Process. Your agentic process is, by default, part of a solution. Read about solutions in the Studio Web user guide.
-
Select the start element and select Add: Text annotation from the toolbox and Enter Input variable path.
-
Select the start element and select Add: Intermediate event from the toolbox.
-
Select Change element from the toolbar and select Timer intermediate catch event and Enter Delay for the intermediate event name.
-
Select the timer element and select Add: Exclusive gateway from the toolbox and Enter Which path? for the gateway name.
-
Select the gateway and select Add: Task and Enter A task for the name.
验证错误将显示在画布的左下角。
-
Select the gateway again and select Add: Task and Enter B task for the name.
-
Select the gateway and expand the first condition, it will have a generated name starting with
edge_Gateway_{randomcharacters}and Enter A for the Label. Expand the second condition and Enter B for the Label. -
It is a best practice to create an explicit end to your process. To quickly identify which path the process followed, create an explicit end for each one. Select the A task and select Add: End event from the toolbox and Enter End A for the name.
-
Select the B task and select Add: End event from the toolbox and Enter End B for the name.
恭喜!您现已创建了第一个 BPMN 端到端流程!
现在,为流程添加一些功能。
实施流程
起始事件
-
Select the start element and in the Properties panel Enter Manual start for the Name and, in the Arguments section, select Add new to add a variable which we can use when we start the process.
-
Configure the variable with these values and select Save. An output variable will automatically be created.
- 名称:路径
- Type: String
- 值:A
-
选择“延迟”事件,打开“属性面板”,在“计时器”部分中选择“类型=持续时间”,在值配置中选择“5 秒”。
-
选择网关,然后展开“条件”以输入“否”和“是”路径的条件,然后选择文本条目选取器以打开表达式编辑器以输入条件。
-
使用“插入变量”查找并插入“手动开始”输出变量
path。将值设置为“A”,然后选择“保存”。
-
Open the Expression editor for condition B and insert the Manual start output variable path and set the value equal to “B” and select Save.
或者,您可以简单地将以下表达式复制/粘贴到表达式编辑器中:
-
A
vars.path == "A"vars.path == "A" -
B
vars.path == "B"vars.path == "B"
-
恭喜!您现已完全配置第一个流程。
You can download the BPMN for use in other projects by opening the context menu for the .bpmn file name.
调试流程
You can configure breakpoints by pointing to 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。
-
选择“调试”以测试您的流程。
-
Watch how each step is executed. Navigate the Execution Trail and Global Variables/Incidents sections to view additional details.
-
选择“返回设计模式”,以退出调试。
分步调试
分步运行流程,以便您可以操作path变量,以测试路由 B
-
选择“分步调试”。
-
选择“下一步”,以将执行移到计时器
-
将“手动开始”事件来源的
path全局变量更新为 B。按回车键或 Tab 键以提交更改。 -
在下一个对话框中选择“更新 1 变量”和“更新变量”,以提交更改。
-
选择“继续”,以完成执行。
-
观看每个步骤是如何执行的。导航“执行追踪记录”和“全局变量/事件”部分,以查看其他详细信息。 这次,流程采用 B 路由。
-
选择“返回设计模式”,以退出调试。
。
发布和部署简单流程
-
选择“发布” 。
-
选择“位置”,然后选择“发布”。
-
阅读“智能体流程的发布和升级”,了解发布到 Orchestrator 的步骤。
恭喜!您现已完全发布、部署和启动第一个流程。
现在,需要进行 runtime 实例管理。
管理业务流程
-
在 Automation Cloud 门户中,导航到 Maestro 服务。
-
在流程列表中选择“简单流程”,以打开您流程的“所有实例”视图。 如果需要,您可以使用“搜索”筛选列表。
-
选择最新实例以打开实例查看器。 您将在每个步骤中看到流程的实时执行(假设 5 秒延迟计时器仍在执行)。
Select the model background to see Global variables and Action History as well as the Execution trail. Select a node in the model or the Execution trail to inspect Details and Variables for that execution step. Congratulations! You’ve now fully managed your first process. Now break our process so you can fix it!
中断和修复流程
在此程序中,我们会导致执行失败,以便使用实例管理进行恢复。
-
转到 Orchestrator 中的“我的工作区”文件夹的“自动化”选项卡,然后在“流程”列表中找到 Simple.Process。
-
在 Simple.Process 条目中选择“开始作业”,但这次在开始中断之前编辑“参数”。
-
选择“参数”选项卡,然后编辑
path变量。 将值设置为 "C",然后选择“保存”。 -
选择“开始”。
-
导航到 Maestro,然后在“流程”列表中选择“简单流程”,以打开您流程的“所有实例”视图。
-
选择“哪条路径?”网关步骤,可以看到“网关无传出流”错误,这在预料之内,因为我们未对
path==”C”进行配置。 -
Select the first step container or the model background to view the Global variables.
-
通过将“手动开始”输出的
path变量(第二个)更新为 A,确保流符合配置的条件。 -
选择“更新 1 变量”以更新变量,并添加注释以用于审核。
-
选择“重试”,添加注释,然后选择“重试实例”,以使用新变量重试步骤,并观看实例完成。
:::note You might need to refresh the page to see the instance complete. ::: :::note You might need to refresh the page to see the instance complete. :::  -
请查看“操作历史记录”,以查看我们更改的审核追踪记录。
恭喜!您已成功修复损坏的实例。
在流程版本之间迁移
当前的流程流逻辑不够强大,无法管理所有路径场景。 您正在通过发布新版本的流程来解决这个问题。此更新版本不仅能有效适应新的流程实例,还能纠正现有的有问题的实例。为了确保有效处理 path 不等于 A 的所有场景,请将,请将 B 路由修改为“非 A”路由。
在此程序中,您会导致执行失败,以便使用新版本进行修复。
- 导航到 Orchestrator。
- 转到“我的工作区”。
- 转到“自动化”选项卡,然后在“流程”列表中找到 "Simple.Process"。
- 在“简单流程”条目中选择“开始作业”,然后选择“开始”。
- 选择“参数”选项卡,然后编辑
path变量。 - 将值设置为 "C",然后选择“保存”。
- 选择“开始”。
现在修复您的流程,以便您能够迁移此损坏的实例。
-
在 UiPath Studio 中打开“简单流程”。
-
选择“哪条路径?”网关,然后打开“属性”面板。
-
将 B 标签更改为“非 A”,并将条件更改为
vars.path != A -
将“B 任务”的任务名称更改为“非 A 任务”。
-
将结束事件“结束 B”的名称更改为“结束非 A”。
-
Select Publish, choose Orchestrator Personal Workspace Feed, and select Publish.
现在,将您损坏的实例迁移到新版本。
-
导航到 Maestro,选择“流程实例”,然后在“流程”列表中选择“简单流程”,以打开您流程的“所有实例”视图。
-
Select the latest instance to open the instance viewer. You will see the process is in a failed state at the Which path? gateway.
备注:You might need to select the refresh button for the list to see the latest instance.
-
选择“迁移”,选择您刚刚发布的流程的目标版本(应为 1.0.1,但可能不同),提供注释,然后选择“迁移实例”。
-
Select Retry, add a comment, and select Retry instance to retry the step with the new variable and watch the instance complete.
备注:您可能需要刷新页面,才能查看完整的实例。
-
请查看“操作历史记录”,以查看您更改的审核追踪记录。
恭喜!您已成功将损坏的实例迁移到新版本的流程!
最终流程
这是最终流程的样子: