- 简介
- 入门指南
- 流程建模
- 流程实施
- 流程运营
- 流程监控
- 流程优化
- 参考信息
Maestro 用户指南
集成系统和数据
使用 Data Fabric 管理文件
在 UiPath Maestro™ 中，文件通过 Data Fabric（原名为 "Data Service"）进行管理。每次从来源（例如电子邮件附件或云存储提供商）下载文件时，都会将文件上传到 Data Fabric 中支持文件存储的实体中。
然后使用 Data Fabric 引用来引用文件，该引用是一个包含以下内容的三元组：
- EntityName
- RecordId
- FieldName
通过引用，您可以在智能体流程中的任何位置使用该文件。
先决条件
在 Maestro 中使用文件之前，请确保：
- 您的组织或租户中已启用 Data Fabric。
- 已配置拥有文件支持字段的实体。
创建记录时，除了 Data Fabric 自动填充的字段以外，无需其他字段。
用例示例
本示例显示了如何从 Box 下载文件，并将其作为电子邮件附件发送出去。
-
下载文件
- 配置一个发送任务，以使用 Box 连接器运行“下载文件”活动。
- 选择您想要下载的文件。
- 使用 Data Fabric 编辑器设置“文件资源输出”。选择支持文件的“实体”和“字段”。
执行活动时，活动将返回一个 Data Fabric 引用 (
EntityName,RecordId,FieldName)，指向 Data Fabric 中的新文件记录。 -
通过电子邮件发送文件
- 使用 Outlook 连接器的“发送电子邮件”活动配置另一个发送任务。
- 通过引用 Data Fabric 编辑器上一步中的 RecordId 来附加文件。
测试结束后，您会发现工作流变量中有可用的 RecordId。
您还可以通过搜索 RecordId，验证文件是否存在于 Data Fabric 应用程序中。
- 在 Maestro 中，只有 Data Fabric 才支持文件。
- 如果 Data Fabric 中已经存在文件，您可以通过添加其 Data Fabric 引用来重新使用该文件。
在 Maestro 中使用智能体
智能体在 Maestro 中的运行方式
智能体在 Maestro BPMN 工作流中表示为“服务”任务。当您的流程调用“服务”任务时，Maestro 会调用相应智能体，并提供特定流程实例所需的输入参数。
智能体将输出数据返回到 Maestro，用于确定工作流中的后续步骤。您可以配置智能体，使其报告使用的工具、做出的决策并追踪数据，以便提高调试能力和透明度。
智能体可以：
- 直接在 UiPath Platform 中构建（低代码或编码）
- 通过外部 API 或 Integration Service 连接
- 通过基于工作流逻辑的事件或信号触发
观看真实示例：UiPath Maestro：无缝透明贷款自动化背后的大脑。
通过 Integration Service 连接智能体
UiPath Integration Service 提供现成连接器和自定义连接器，用于将外部系统集成到您的自动化中：
- 面向 Salesforce、Microsoft 365 和 Google Workspace 等服务的预构建连接器
- 用于将任何 REST API 公开到 UiPath Platform 的自定义连接器构建器
- 统一凭据和连接管理
使用 Integration Service，Maestro 可向并非原生托管在 UiPath 中的智能体或系统发送数据或从中接收数据。了解有关 Integration Service 的更多信息。
使用外部智能体
Maestro 是供应商中立的。您可以使用 UiPath Integration Service 连接器在您首选的外部 AI 智能体中编排作业，无需重新构建流程。
您可以编排：
- 专有 AI 服务
- 外部决策引擎
- 在其他平台上托管的微服务或机器人
Maestro 通过调用 REST 端点来调用这些智能体，获得包含结构化数据的响应有效负载。
通过 Integration Service 连接外部智能体
在设计时，添加“服务”任务，选择“开始并等待外部智能体”，然后从选定连接器中配置智能体活动。在运行时，Maestro 会将提示词和上下文发送给智能体，并等待响应。您可以将该响应映射到变量，以驱动网关、分配和后续操作。
以下链接显示了如何连接外部智能体、在 Maestro 流程中运行智能体，以及捕获其输出以用于路由和决策：
快速入门：API 工作流集成
Integration Service 连接器如果存在，则优先使用。当您需要 API 级连接时，请使用 API 工作流（早期 API、不断发展的架构或流响应）。以声明方式定义请求和输出，解析 JSON（无需自定义代码），并将结果传递给您的 Maestro 流程。
何时使用 which ：
- 连接器：受支持的系统、稳定的架构、托管的身份验证、最佳的长期选择。
- API 工作流：新的或不支持的 API、更改响应形状或“仅流式传输”输出。
分步指南
- Snowflake Cortex - API 工作流：处理 Cortex 智能体的流输出，将其组合成可用的响应，并返回结构化 JSON 以供下游自动化使用。
- Databricks Genie - API 工作流：启动对话，轮询消息状态直至完成，提取生成的 SQL (attachment_id)，执行它，然后返回答案。
智能体属性配置
在 Maestro 中，智能体被视为业务流程的参与者。在 BPMN 工作流中，智能体用“服务”任务表示，可以调用 UiPath 托管智能体和外部智能体。每个智能体任务都可以配置特定输入和输出参数，使 Maestro 可以将上下文感知数据传递给智能体，并接收结构化结果作为交换。
请参阅“BPMN 建模中的任务”，以简要了解 Maestro 中的“服务”任务。
智能体执行模式
智能体行为在“服务”任务的“属性”面板中定义。您可以根据您的业务需求配置任务，以调用 UiPath 智能体或外部智能体。
启动并等待智能体
此选项用于调用部署在 UiPath 租户中的智能体。其中包括：
- 使用 Agent Builder 等工具创建的低代码智能体。
- 使用 Python 或其他语言开发并部署到 Orchestrator 的编码智能体。
在运行期间，Maestro 以 JSON 格式将输入参数发送给智能体。智能体完成执行后返回响应，其中包含流程所需的输出值。
启动并等待外部智能体
此选项用于连接到第三方系统或外部系统。你必须指定：
-
连接器：集成目标（例如 CrewAI、Salesforce 或其他服务）
-
连接：连接器的已配置实例，表示特定智能体或上下文专属凭据集。
备注：通过定义多个连接，您可以使用具有不同权限或行为的同一个智能体。
输入和输出
智能体的输入和输出配置方式与其他 Maestro 任务类型相同。
- 输入：在运行时传递给智能体的变量或表达式。
- 输出：从智能体的 JSON 响应中填充的变量。
Maestro 以 JSON 有效负载的形式发送输入参数，其格式如下：
{
"key1": "value1",
"key2": "value2"
}
{
"key1": "value1",
"key2": "value2"
}
智能体必须使用 Maestro 所需的相同参数名称返回 JSON 响应。这些值通过任务“属性”面板中的“输出 > 响应”部分映射到流程变量。
输入和输出示例
输入示例（从 Maestro 到智能体）：
| 参数 | 描述 |
|---|---|
role | 任务的角色或上下文（例如，验证与摘要） |
prompt | 为智能体提供的指令，通常包含流程专属数据 |
tools | 智能体可能用于完成任务的工具列表 |
user_id | 在流程和智能体上下文之间共享的唯一标识符 |
提示示例： "Complete loan validation for {loan_application_number}. Respond in JSON format using the parameter 'loan_application_status'."
输出示例（从智能体到 Maestro）
| 参数 | 描述 |
|---|---|
conversation_id | 引用对话或交互会话 |
loan_application_status | 智能体返回的状态结果 |
tokens_used | 有关资源使用情况的元数据 |
要在工作流中使用智能体输出，必须在任务的“输出 > 响应”配置中将每个输出参数分配给一个流程变量。
业务规则（预览）
业务规则允许 RPA 开发者将决策模型和标记 (DMN) 文件作为工作流或流程图的一部分来进行存储和管理。
Orchestrator 中的业务规则
Orchestrator 中的业务规则允许您存储和管理基于决策模型和标记 (DMN) 的规则。您可以使用专用活动在任何智能体流程中评估这些规则。此外，您还可以修改规则，无需重新部署使用这些规则的流程。这样可以更轻松地动态更新和维护业务逻辑。
在 Orchestrator 中，我们使用以下功能集进行存储和管理：
- 存储具有用户和机器人角色基础访问权限的 DMN 文件
- 版本控制
- 跨文件夹链接业务规则
- 标记
为了执行业务规则，Maestro 包含支持 DMN v1.3 的新业务规则任务。
访问业务规则版本
要跟踪您的业务规则，请使用“版本”字段。使用上传的 DMN 文件保存业务规则后，您将无法再更改其版本。
您可以从“业务规则”页面查看业务规则的版本。要查看版本，请选择一个业务规则，然后编辑该业务规则，或者直接转到“更多操作”，然后选择“查看版本”。
如果需要，您还可以通过以下方法之一下载业务规则的版本：
- 在创建业务规则期间上传 DMN 文件后，选择文件旁边的下载图标。
- 在“业务规则”页面中所需的业务规则上，选择“更多操作”，然后“下载版本”。或者，在“更多操作”下，选择“查看版本”。此时将打开一个侧面板，您可以在这里选择您想要下载的版本旁边的下载图标。
业务规则链接
要链接其他文件夹中的业务规则：
- 在“业务规则”页面上，选择“添加业务规则”，然后选择“从其他文件夹链接”。
- 接下来，“导入业务规则”页面会显示其他文件夹中所有业务规则的列表。
- 选择要添加到当前文件夹的一个或多个业务规则，选择“继续”，然后选择“链接”。
要管理业务规则链接：
- 在“业务规则”页面上，选择一个业务规则，转到“更多操作”，然后选择“管理链接”。
- 在下一个窗口中，选择要添加业务规则的一个或多个文件夹，或者取消选择要移除业务规则的文件夹。
- 选择“更新”。
执行业务规则
在执行业务规则之前，请确保：
- 借助符合 DMN 要求的编辑器对 DMN 文件进行了建模。
- 通过上传 DMN 文件，在 Orchestrator 中新建了一个业务规则。
- 要执行业务规则，请打开一个 Maestro 流程
- 在您的流程中添加业务规则任务。
- 选择存储在 Orchestrator 中的 DMN 文件，作为业务规则。
- 根据 DMN 文件的建模方式映射输入和输出参数。
编辑业务规则
要编辑业务规则，您需要拥有业务规则编辑权限。
-
在“业务规则”页面上，选择一个业务规则，转到“更多操作”，然后选择“编辑”。
-
接下来，您可以编辑以下字段：“名称”、“描述”、“标签”、“属性”和“文件”。
备注：使用上传的 DMN 文件保存业务规则后，您将无法再更改其版本。
备注：确保参数名称仅由字母、数字和下划线字符组成。名称必须以字母或下划线字符开头。
-
选择“更新”。
移除业务规则
要移除业务规则，您需要拥有业务规则的“删除”权限。
- 在“业务规则”页面上，选择一个业务规则。
- 接下来，转到“更多操作”。
- 选择“删除” 。
流程应用程序（预览）
概述
流程应用程序为业务用户提供基于角色的仪表板、表单和分流中心，用于管理日常运营。它们让用户可以通过一个跨越智能体、机器人和人类的统一工作区，实时了解流程的运行状况，从而帮助用户识别延迟、低效问题，并最终将问题升级处理。
借助 Process Apps，团队可以：
- 借助实时上下文和指导性决策，解决延迟和违反 SLA 的问题。
- 做出更明智的资源选择，以提高运营效率。
- 推动整个组织更快地解决问题，取得更好的业务成果。
Process Apps 将 Maestro 流程编排和 UiPath™ 低代码应用程序开发相结合，为运营团队提供了可操作的见解，而无需在系统之间切换。
先决条件
要使用流程应用程序，请确保在您的 Automation Cloud 租户中提供以下服务：
- UiPath Automation Cloud™
- UiPath Maestro™
开始使用
您可以使用 UiPath TypeScript SDK 和示例应用程序资源开始探索流程应用程序。
表 1.
| 资源 | 描述 |
|---|---|
| SDK GitHub | UiPath TypeScript SDK 文档 |
| 示例 React 应用程序 | 流程应用程序示例 |
| NPM 包 | UiPath TypeScript SDK |
用例示例
- 分类仪表板：直接从操作控制台跟踪流程事件并根据升级采取措施。
- 案例和 SLA 管理：监控 SLA，识别违规行为并触发恢复流程。
- 人机回圈操作：提供上下文表单，用于批准、更正或更正异常处理。
与 Maestro 集成
流程应用程序连接到 Maestro 流程和事件数据，以实时了解正在运行的执行。企业用户无需使用开发者工具，即可在单个界面中监控实例、跟踪 KPI 并执行任务。
示例：Finance Operations 流程应用程序可以显示 Maestro 的延迟发票批准，并允许用户直接批准或重新分配任务，而无需离开应用程序。
