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

Maestro 用户指南

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

操作方法 - 复杂流程

概述

InsurePath 识别了使用 UiPath™ Process Mining 进行的发票处理工作流。 他们使用 UiPath IXP 和 Document Understanding 处理传入的发票并提取发票数据。提取后，财务和会计团队仍然会手动处理大多数发票，包括解决供应商争议。

流程所有者、流程实施者和管理员决定使用 UiPath Maestro™ 和平台功能解决发票处理问题。

流程

构建有效的发票流程，以演示 Maestro 如何协调机器人、智能体和人类之间的工作。

这是我们将构建的流程的 BPMN 图。

先决条件

我们需要为此场景配置依赖资源。

Data Fabric：AP发票实体

使用 APInvoice 实体的“记录已创建”事件触发流程的开始。
  1. 导航到 Data Fabric。
  2. 在“导入/导出”下拉菜单中，选择“导入架构”。
  3. 导入 Schema(APInvoice).json 文件。

  4. 选中与 APInvoice 实体对应的“导入”复选框。
  5. 选择“导入” 。

Orchestrator：共享文件夹

使用 Orchestrator 中的共享文件夹整理“操作方法”资源。

导航到 Orchestrator，然后创建“共享/操作方法”文件夹。请阅读有关在 Orchestrator 中管理文件夹的更多信息。

自动化：发票与 PO 匹配

使用模拟自动化模拟发票与采购订单的双向匹配。 此流程接受“发票编号”输入参数，并设置“需要解决”输出变量。如果发票编号以 1 开头，值为“是”。否则，它为“否”。
  1. 导航到 Studio Web，然后从“新建”下拉列表中选择“导入”。 使用此文件导入。

  2. 在 UiPath Studio Web 中打开项目，然后将其发布到 Orchestrator 租户流程订阅源。
  3. 导航到 Orchestrator，然后转到“共享/操作方法”文件夹。
  4. 打开“自动化”选项卡，选择“流程”，然后选择“添加流程”。
  5. 在“包来源名称”字段中选择 Invoice.To.PO.Matching，然后选择“下一步”。
  6. 在“包要求”部分中，选择“下一步”。
  7. 将显示名称设置为“发票与 PO 匹配”，然后选择“创建”。

    查看“Studio Web 发布项目”页面，以了解有关发布和部署项目的其他详细信息。

自动化：将发票过账到 SAP

使用模拟自动化来模拟将发票过账到 SAP 的流程。此流程接受采购订单号的输入参数，没有输出。 如果采购订单号等于 fail，流程会抛出 runtime 异常，您可以在实例管理中将其修复。
  1. 导航到 Studio Web，然后从“新建”下拉列表中选择“导入”。 使用此文件导入。
  2. 在 Studio Web 中打开项目，然后将其发布到 Orchestrator 租户流程订阅源。
  3. 导航到 Orchestrator，然后转到“共享/操作方法”文件夹。
  4. 选择“自动化”选项卡，选择“流程”，然后选择“添加流程”。
  5. 在“包来源名称”字段中选择“将发票过账到 SAP”，然后选择“下一步”。
  6. 在“包要求”部分中，选择“下一步”。
  7. 将显示名称设置为“将发票过账到 SAP”，然后选择“创建”。

    查看“Studio Web 发布项目”页面，以了解有关发布和部署项目的其他详细信息。

智能体：解决差异的智能体
  1. 导航到 Agents，然后选择“立即构建智能体”。
  2. 输入以下详细信息：

    名称：解决差异的智能体

    描述：解决差异的智能体

    系统提示：您是解决发票差异的专家

    用户提示词：如果 以 11 {{InvNum}}开头，您将解决发票。 否则，您将拒绝发票，并将Needs human review since the PO Number doesn't match the Invoice 指定为 {{Reason}}。
    当您拒绝发票将 {{Decision}} 设置为 Rejected，但您批准发票将 {{Decision}} 设置为 Resolved。
  1. 选择“参数”，然后使用“编辑器”选项输入以下信息：

    输入

    {
  "type": "object",
  "properties": {
    "InvNum": {
      "type": "string"
    },
    "PONum": {
      "type": "string"
    }
  },
  "required": [
    "InvNum"
  ]
}{
  "type": "object",
  "properties": {
    "InvNum": {
      "type": "string"
    },
    "PONum": {
      "type": "string"
    }
  },
  "required": [
    "InvNum"
  ]
}
    输出
    {
  "type": "object",
  "properties": {
    "Decision": {
      "type": "string"
    },
    "Reason": {
      "type": "string"
    }
  },
  "required": []
}{
  "type": "object",
  "properties": {
    "Decision": {
      "type": "string"
    },
    "Reason": {
      "type": "string"
    }
  },
  "required": []
}
  2. 发布到 Orchestrator 租户流程订阅源。
操作应用程序：发票审批操作应用程序
  1. 导航到 Studio Web，然后从“新建”下拉列表中选择“导入”。 使用此文件导入。
  2. 在 Studio Web 中打开项目，然后发布到 Orchestrator 租户流程订阅源。
    注意：您可能需要导航到MainForm_MainForm_load.xaml实体并对其进行更新。 在数据管理器中，转到“实体”，然后选择“更新实体”，然后再发布。


  3. 导航到 Orchestrator，转到“共享/操作方法”文件夹，打开“自动化”选项卡，选择“应用程序”，然后选择“部署应用程序”。

对智能体流程进行建模

注意：智能体流程项目配置目前是租户绑定。 务必在编辑会话之间保持同一个租户。

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

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

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

  4. 右键单击，将项目重命名为“{您的姓名首字母} 发票流程”。将流程重命名为“发票流程”。

    Your agentic process is, by default, part of a solution. Read about solutions in the Studio Web user guide.



  5. 选择“开始”元素，然后在“名称”字段中输入“已收到发票”。
  6. 从工具框中选择“添加：文本批注”。 在批注中输入“Data Fabric 触发器”。

  7. 选择“开始”元素，然后从工具箱中选择“添加任务”，然后为任务名称输入“发票到 PO 匹配”。

  8. 选择“发票到 PO 匹配”任务，然后从工具箱中选择“添加：文本批注”，然后输入“自动化”以表示我们希望这是自动化任务。

发票与 PO 匹配的传出路径

根据从发票到 PO 匹配自动化结果，为网关配置两条传出路径，只会遵循其中一条。

  1. 选择“发票到 PO 匹配”任务，然后从工具箱中选择“添加：独家网关”，然后输入“是否需要解决？” 用于名称。

  2. 选择网关，然后从工具箱中选择“添加：任务”，然后为名称输入“发票审批”。 将 Action Center Action 应用添加为批注，表示我们希望将其作为 HITL 任务。
  3. 选择您刚刚在网关和任务之间创建的线条，然后按设计器右上角的“打开属性面板”按钮，以将名称更改为“否”。

  4. 再次选择网关，然后从工具箱中选择“添加：任务”，然后在名称中输入“解决差异”。拖动并将任务放置在网关下。 将“智能体”添加为批注，以指示这将是智能体任务。
  5. 选择您刚刚在网关和任务之间创建的线条，然后打开“属性”面板，以将名称更改为“是”。

发票审批传出路径

根据人工完成的“发票审批”任务的结果，为网关配置两条传出路径，其中只会遵循其中一条。
  1. 选择“发票审批”任务，然后添加另一个“排他网关”。
  2. 选择网关，从工具箱中选择“添加：任务”，然后在名称中输入“将发票过账到 SAP”。将“自动化”添加为批注，以表示您希望将其成为自动化任务。
  3. 选择您刚刚在网关和任务之间创建的线条，然后打开“属性”面板，以将名称更改为“批准”。
  4. 再次选择网关，从工具箱中选择“添加：任务”，然后在名称中输入“通知供应商”。拖动并将任务放置在网关下。 添加 Integration Service Outlook 连接器作为批注，以指示这将是指示为“发送”任务的 API 调用。
  5. 选择您刚刚在网关和任务之间创建的线条，然后打开“属性”面板，以将名称更改为“拒绝”。

解决传出路径的差异

为网关配置两条传出路径。 根据人工完成的“解决差异”任务的结果，只会遵循其中一项。
  1. 选择“解决差异”任务，然后添加另一个“排他网关”。
  2. 选择网关，然后从工具框中选择“连接”箭头。

  3. 选择“通知供应商”任务，以绘制一条从网关到任务的线。

  4. 选择您刚刚在网关和任务之间创建的线条，然后打开“属性”面板，以将名称更改为“已拒绝”。
  5. 再次使用“连接”工具，从网关到“发票审批”任务绘制线。
  6. 选择您刚刚在网关和任务之间创建的线条，然后打开“属性”面板，以将名称更改为“已解决”。

“解决差异”错误边界事件

如果智能体无法解决差异，会返回业务错误，将任务路由回复给人类以供进一步输入。 通过将“错误”边界事件添加到任务中，对其进行建模。
  1. 在左侧的完整工具框中选择“中间事件”，然后将其拖放到“解决差异”任务中。



  2. 选择“中间事件”，从工具箱中选择“更改元素”，然后选择“错误边界事件”。

  3. 选择“错误边界事件”，从工具箱中选择“添加：任务”，然后在任务名称中输入“解决差异”。将 Action Center Action 应用添加为批注，表示我们希望将其作为人机回圈任务。
  4. 选择新的“解决差异”任务。 再次使用“连接”工具，从此新任务到智能体网关绘制线条。

结束事件

为流程创建明确的结束是最佳实践。 快速了解您的流程遵循的路径非常重要，以便您为每个流程创建明确的结束。
  1. 选择“将发票过账到 SAP”任务，选择“添加：结束事件”，然后在名称中输入“发票已处理”。
  2. 选择“通知供应商”任务，选择“添加：结束事件”，然后在名称中输入“发票已拒绝”。

恭喜！您已创建了第一个 BPMN 端到端业务流程。 是时候将一些 UiPath 功能添加到流程中了。

实施智能体流程

消息开始事件

  1. 选择“开始”元素，从工具箱中选择“更改元素”，然后选择“消息开始”事件。

  2. 打开“属性”面板，然后在“实施”部分中配置以下内容：
    • 操作：等待连接器事件。
    • 连接器：Data Fabric
    • Data Fabric 连接：Data Fabric。
      注意：选择“连接到 Data Fabric”，以创建您尚未拥有的 Data Fabric 连接。
    • 触发器：已创建记录。
    • 对象：APInvoice。
    注意：所有输出都可以自动在流程配置中作为变量使用。
    注意：如果您在共享环境下，您可以将“触发器”更改为“记录已更新”，并将筛选器配置为“由电子邮件创建”与您的电子邮件相同。

发票到 PO 匹配自动化

  1. 选择“发票到 PO 匹配”任务，从工具箱中选择“更改元素”。 然后选择“服务”任务。
  2. 打开“属性”面板，然后在“实施”部分中配置以下内容：
    • 操作：开始并等待 RPA 工作流。
    • 自动化：发票与 PO 匹配。
  3. 通过将“发票已收到”消息开始事件输出映射为自动化输入，来配置输入。 使用“变量搜索”对话框查找变量。
    • InvNum：发票已收到 > 响应 > 发票号码。

    • PoNum：发票已收到 > 响应 > PO 号码

是否需要解决？ 网关

  1. 选择“是否需要解决？”在网关中，展开“条件”以输入“否”和“是”路径的条件，然后使用“表达式编辑器”输入条件。

  2. 使用“插入变量”，以查找并插入发票到 PO 匹配输出变量“需要解决”，将值设置为“否”，然后选择“保存”。

  3. 或者，您可以简单地将以下表达式复制/粘贴到表达式编辑器中：
    1. 否：vars.ResolutionRequired == "No"
    2. 是：vars.ResolutionRequired == "Yes"

“批准发票”任务

  1. 选择“批准发票”任务，从工具框中选择“更改元素”，然后选择“用户”任务。
  2. 打开“属性面板”和“实施”部分，然后配置以下内容：
    • 操作：Create action app task
    • 操作*：Invoice.Approval action app
    • 任务标题：{your initials} Invoice approval。
  3. 通过将“发票已收到”消息开始事件输出映射为应用程序任务的输入，来配置输入。 使用“变量搜索”对话框查找 Data Fabric 记录 ID 的变量。
“解决差异”任务
  1. 选择“解决差异”，从工具箱中选择“修改”元素，然后选择“服务”任务。
  2. 打开“属性”面板，在“实施”部分中，配置以下内容：
    • 操作：Start and wait for agent。
    • 自动化：2-way matching agent。
  3. 通过将“发票已收到”消息开始事件输出映射为自动化输入，来配置输入。 使用“变量搜索”对话框查找变量。
    • InvNum：发票已收到 > 响应 > 发票号码
    • PoNum：发票到 PO 匹配 > PO 号码

解决智能体传出网关的差异

  1. 选择网关，展开“条件”以输入“已解决”和“已拒绝”路径的条件，然后选择文本条目选取器，打开表达式编辑器以输入条件。
  2. 将以下表达式复制/粘贴到表达式编辑器中。
    1. 已解决 - vars.Decision == "Resolved"
    2. 已拒绝 - vars.Decision == "Rejected"

“通知供应商”发送任务

  1. 选择“通知供应商”任务，从工具箱中选择“更改元素”，然后选择“发送”任务。
  2. 打开“属性”面板，然后在“实施”部分中配置以下内容：
    • 操作：Integration Servies - API execution
    • 连接器：Microsoft Outlook 365
    • 连接：{your outlook connection}
      注意：如果您没有可用连接Connect to Microsoft Outlook 365，请选择。
    • 活动：Send email
    • 触发器：Email sent
  3. 在“筛选”部分中，配置“发送电子邮件”活动的主要输入：
    • 到：{Invoice received > response> Invoice email}
    • 主题：Invoice rejected
    • 正文：发票被拒绝，原因是 {Resolve discrepancies > message}


批准发票传出网关
  1. 选择网关，展开“条件”以输入“批准”和“拒绝”路径的条件，然后选择文本条目选取器，打开表达式编辑器以输入条件。
  2. 将以下表达式复制/粘贴到表达式编辑器中：
    • 批准：vars.Action == "Approve"
    • 拒绝：vars.Action == "Reject"
将发票发布到 SAP 自动化
  1. 选择“将发票过账到 SAP”，从工具箱中选择“更改元素”，然后选择“服务”任务。
  2. 打开“属性”面板，然后在“实施”部分中配置以下内容：
    • 操作：Start and wait for RPA workflow
    • 自动化：Post Invoice to SAP。
    • 通过将“发票到 PO 匹配”任务的输出映射为自动化的输入，来配置输入。
      • PurchaseOrderId：失败
      注意：我们希望此自动化失败，以便稍后修复 runtime。

恭喜！您的第一个智能体流程现在已经配置完成。

是时候进行一些调试了。

调试业务流程

调试场景
  • 发票编号以 x 开头 > 不需要解决，转到“发票审批”人机回圈。
  • 发票编号以 1x 开头 > 需要解决，转到“解决差异的智能体”，智能体拒绝。
  • 发票编号以 11 开头 > 需要解决，转到“解决差异的智能体”，智能体解决。
  1. 在页面左上角，选择“分步调试”。

    注意：您可以选择“测试配置”，以确认项目中使用的输入变量和连接。
  2. 将鼠标悬停在“发票到 PO 匹配”任务的左侧，然后选择以添加断点。

    注意：为结束事件配置断点。 这样，在完成调试会话之前，您有足够的时间检查所有变量。
  3. 选择“下一步”，以将执行移过“消息开始”事件。
  4. 使用以下响应对象更新“发票已收到”消息开始事件的响应全局变量，然后按 Enter 或 Tab 以提交更改：
    {
    "Currency": "USD",
    "DueDate": "2025-02-14",
    "InvoiceDate": "2025-02-14",
    "InvoiceEmail": "petrodev71@gmail.com",
    "InvoiceNumber": "12345",
    "PONumber": "4551232",
    "TotalAmount": 10000,
    "VendorName": "Acme",
    "Source": 1,
    "Status": 6,
    "Id": "6F92ECF6-D1EA-EF11-90CB-6045BD93BF30",
    "UpdateTime": "2025-02-14T18:22:40.6233376Z",
    "CreateTime": "2025-02-14T12:48:19.3578548Z",
    "UpdatedBy": {
        "Email": "anthony.petro@uipath.com"
    },
    "CreatedBy": {
        "Email": "anthony.petro@uipath.com"
    }
}{
    "Currency": "USD",
    "DueDate": "2025-02-14",
    "InvoiceDate": "2025-02-14",
    "InvoiceEmail": "petrodev71@gmail.com",
    "InvoiceNumber": "12345",
    "PONumber": "4551232",
    "TotalAmount": 10000,
    "VendorName": "Acme",
    "Source": 1,
    "Status": 6,
    "Id": "6F92ECF6-D1EA-EF11-90CB-6045BD93BF30",
    "UpdateTime": "2025-02-14T18:22:40.6233376Z",
    "CreateTime": "2025-02-14T12:48:19.3578548Z",
    "UpdatedBy": {
        "Email": "anthony.petro@uipath.com"
    },
    "CreatedBy": {
        "Email": "anthony.petro@uipath.com"
    }
}


  5. 选择扩展器以检查和/或进一步更改值。

  6. 在对话框中选择“更新 1 变量”和“更新变量”，以提交更改。
  7. 选择“下一步”或“继续”，以使用新值将执行移动到末尾。

恭喜！您的第一个智能体流程已经调试完成。

是时候发布和部署您的流程了。

Publish and deploy a complex process

  1. 选择“发布”以发布流程。

    This requires publishing the entire solution the process is part of.



  2. Read Publishing and deploying solutions for the steps to publish to Orchestrator.
  3. 导航到 Orchestrator，在“自动化”选项卡中，然后选择“添加流程”。

  4. 在“连接到 Microsoft Outlook 365 ”屏幕上，选择“连接”。

  5. 使用您的电子邮件凭据完成连接。 新连接将自动选择。

  6. 选择“下一步” 。
  7. 在“显示名称”中输入 {your initials} Invoice Processing，然后选择“创建”。

恭喜！您的第一个智能体流程现在已经部署完成。

是时候对 runtime 实例进行一些管理。

管理业务流程

  1. 导航到 Maestro 主页。
  2. 在“流程实例”视图中，选择{your initials} Invoice Processing打开您流程的“所有实例”视图。

  3. 您可以选择模型背景，以查看全局变量、故障、操作历史记录以及执行轨迹。您可以在模型或“执行追踪记录”中选择节点，以检查该执行步骤的“详细信息”和“变量”。
    注意：如果执行暂停在 Action Center 中，您需要在 Action Center 中执行任何人机回圈步骤。

p

恭喜！您已完全管理了第一个智能体流程，

是时候修复您破碎的流程了。

修复业务流程

对于本练习，请导致执行失败，以便您可以使用实例管理进行恢复。

准备失败的实例
  1. 打开一个新的标签页，导航到“Data Fabric > APInvoice > 数据”，然后添加发票编号以 2xxxx 开头的记录，以确保进入“将发票过账到 SAP”步骤。
    注意：如果在共享环境下，您可以使用“由电子邮件创建”与您配置的筛选条件匹配的现有记录。
  2. 导航到流程的“所有实例”页面，选择列表刷新按钮，然后选择最新实例。
  3. 当执行在人机回圈步骤暂停时，您必须打开 Actions（原名为 Action Center），以分配和完成任务。

  4. 打开一个新的浏览器标签页，然后在左侧导航菜单中选择 "Actions"。



  5. 选择“收件箱”，然后转到“未分配”。
  6. 查找并选择您的任务，然后选择“分配给自己”。

  7. 在“待处理”中找到您的任务，然后在表单加载后选择“批准”。
修复失败的实例
  1. 返回到“智能体流程”选项卡，等待“将发票过账到 SAP”步骤失败，然后选择节点或“执行”步骤。 请注意“错误”和“变量”。
  2. 通过将“失败”更改为 "1234" 来更新变量以修复输入，然后选择“保存”。
  3. 选择“更新 1 变量”以更新变量并添加注释。
  4. 在“操作历史记录”选项卡中，选择“重试”，添加注释，然后选择“重试实例”，以使用新变量重试步骤。 观看实例完成。

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

迁移到业务流程的新版本

修复在上一部分中创建的问题，避免其再次发生。

准备失败的实例

  1. 打开一个新的标签页，导航到“Data Fabric > APInvoice > 数据”，然后添加发票编号以 2xxxx 开头的记录，以确保进入“将发票过账到 SAP”步骤。
    注意：如果在共享环境下，您可以使用“由电子邮件创建”与您配置的筛选条件匹配的现有记录。
  2. 返回“所有实例”页面，选择列表刷新按钮，然后选择最新实例。
  3. 当执行在人机回圈步骤暂停时，您必须打开 Actions（原名为 Action Center），以分配和完成任务。
  4. 打开一个新的浏览器标签页，然后在左侧导航菜单中选择 "Actions"。
  5. 选择“收件箱”，选择“未分配”，选择您的任务，然后选择“分配给自己”。
  6. 在“待处理”中找到您的任务，然后在表单加载后选择“批准”。
  7. 返回到 Maestro 选项卡，等待“将发票过账到 SAP”步骤失败，然后选择节点或执行步骤。
更新以进行修复的流程版本
  1. 在 UiPath Studio 中打开{your initials} Invoice Processing流程。
  2. 通过将 PO 号码配置为输入，修复失败的“将发票过账到 SAP”步骤。
  3. 选择“将发票过账到 SAP”，然后打开“属性”面板。
  4. 在“输入”部分中，通过将“发票到 PO 匹配”任务的输出映射为自动化的输入来配置输入。
    • PurchaseOrderId：Invoice to PO matching>PoNum。
  5. 将流程发布到租户订阅源。
  6. 在 Orchestrator 中找到您的流程，然后从菜单中选择“升级到最新版本”。
  7. 导航回 Maestro，转到您的流程和正在运行的实例。
  8. 这次使用“迁移”选项，不要修复变量。
  9. 选择流程的新版本，添加注释，然后选择“迁移实例”。

  10. 现在，您需要通知引擎，以继续在新版本上进行处理。 选择“重试”，添加注释，然后选择“重试实例”以继续执行，现在将成功完成。

恭喜！您已成功将正在运行的实例迁移到新版本。

此页面有帮助吗？

支持与服务
获取您需要的帮助
UiPath Academy
了解 RPA - 自动化课程
UiPath 论坛
UiPath Community 论坛
Uipath Logo
信任与安全
使用条款
隐私策略
Cookie 政策
© 2005-2025 UiPath。保留所有权利。