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

Maestro 用户指南

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

操作方法 - 复杂流程

概述

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

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

流程

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

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

先决条件

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

Data Fabric：API 发票实体

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

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

Orchestrator：共享文件夹

使用 Orchestrator 中的共享文件夹来组织操作方法资源。

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

自动化：发票到 PO 的匹配

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

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

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

自动化：将发票过账到 SAP

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

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

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

    名称：“解决差异智能体”

    描述：“差异解决”智能体

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

    用户提示：如果{{InvNum}}以 11 开头，则“解决”发票。否则，您将拒绝发票，并将拒绝的{{Reason}}指定为Needs human review since the PO Number doesn't match the Invoice 。
    拒绝发票时，将{{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并更新实体。从“Data Manager”中转到“实体” ，然后选择“更新实体”然后才能发布（发布前）。


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

Model an agentic process

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

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

以一种新类型的 Studio 项目创建智能体流程。

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

  4. 右键单击将项目重命名为{your名首字母缩写} “InvoiceProcess”（发票流程） ，和将流程重命名为“InvoiceProcess”（发票流程） 。

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



  5. 选择起始元素，然后在“名称”字段中输入“收到的发票” 。
  6. 选择工具箱中的“添加：文本标注” 。在注释中输入“Data Fabric”触发器。

  7. 选择开始元素，然后从工具箱中选择“添加任务” ，然后输入“Invoice to PO Matching”作为任务名称。

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

发票到 PO 匹配的传出路径

为网关配置两条传出路径，根据发票到 PO 匹配自动化的结果，系统将只选择其中的一条传出路径。

  1. 选择“发票到 PO”匹配任务，然后从工具箱中选择“添加：排他网关” ，然后键入“是否需要解决方案？”对于名称。

  2. 选择网关，然后从工具箱中选择“添加：任务” ，然后键入“Invoice批准”作为名称。将Action Center Action 应用添加为注释，以指明我们希望这是一个 HITL 任务。
  3. 选择刚才在网关和任务之间创建的行，然后按设计器右上方的“打开属性面板”按钮，以将名称更改为“否” 。

  4. 再次选择该网关，然后在工具箱中选择“添加：任务” ，然后键入名称“解决差异” 。将任务拖动并将其定位在网关下方。将智能体添加为注释，以指明这将是智能体任务。
  5. 选择刚在网关和任务之间创建的行，然后打开属性面板，将名称更改为“是” 。

发票批准传出路径

为网关配置两条传出路径，根据人工完成的发票审批任务的结果，将只选择其中的一条路径。
  1. 选择“发票”批准任务并添加另一个排他网关。
  2. 选择网关，从工具箱中选择“添加：任务” ，然后输入“将发票过账到 SAP”作为名称。将“自动化”添加为注释，以指明您希望将其作为自动化任务。
  3. 选择刚才在网关和任务之间创建的行，然后打开属性面板，将名称更改为“ Approve ” 。
  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”以创建尚无的连接。
    • 触发器: 已创建记录。
    • 对象（对象） ：API 发票。
    注意：所有输出都将自动在流程配置中作为变量提供。
    注意：如果您处于共享环境中，则可以将“触发器”更改为“记录已更新” ，并配置筛选器，将“创建者电子邮件”设置为等于您的电子邮件。

发票到 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 匹配 > 采购订单编号

解决差异代理传出网关

  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 匹配任务的输出映射为自动化的输入来配置输入。
      • 采购订单 ID ：失败
      注意：我们希望此自动化失败，以便稍后修复运行时。

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

是时候进行一些调试了。

调试业务流程

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

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

    注意：为“结束”事件配置断点。这使您有足够的时间在调试会话完成之前检查所有变量。
  3. 选择“下一步” ，之后执行“消息开始”事件。
  4. 使用以下响应对象更新已收到发票消息消息起始事件的响应全局变量，然后选择 Enter 或 Tab 以提交更改：
    {
    "Currency": "USD",
    "DueDate": "2025-02-14",
    "InvoiceDate": "2025-02-14",
    "InvoiceEmail": "[email protected]",
    "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": "[email protected]"
    },
    "CreatedBy": {
        "Email": "[email protected]"
    }
}{
    "Currency": "USD",
    "DueDate": "2025-02-14",
    "InvoiceDate": "2025-02-14",
    "InvoiceEmail": "[email protected]",
    "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": "[email protected]"
    },
    "CreatedBy": {
        "Email": "[email protected]"
    }
}


  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作为“显示名称”，然后选择“创建” 。

恭喜！现在，您已经完全部署了第一个智能体流程!

现在需要进行一些运行时实例管理。

管理业务流程

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

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

p

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

是时候修复损坏的流程了。

修复业务流程

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

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

  4. 打开新的浏览器标签页，然后在左侧导航菜单中选择“操作” 。



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

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

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

迁移到业务流程的新版本

修复上一部分中创建的问题，以免再次发生这种情况。

准备失败的实例

  1. 打开一个新的选项卡，然后导航到 Data Fabric >“APInvoice” >“数据”，然后添加一条包含以 2xxxx 开头的“发票编号” 的记录，以确保进入“将发票过账到 SAP”步骤。
    注意：如果您处于共享环境中，则可以选择“创建者电子邮件”与您配置的筛选条件匹配的现有记录。
  2. 导航回“所有实例”页面，选择列表的刷新按钮，然后选择最新的实例。
  3. 在人机回圈步骤中暂停执行时，您必须打开操作（以前称为 Action Center）以分配和完成任务。
  4. 打开新的浏览器标签页，然后在左侧导航菜单中选择“操作” 。
  5. 选择“收件箱” ，选择“未分配” ，选择您的任务，然后选择“分配给自己”
  6. 在表单加载后找到处于“待处理”状态的任务，然后选择“批准” 。
  7. 返回到 Maestro 选项卡，等待“将发票过账到 SAP”步骤失败，然后选择节点或执行步骤。
更新要修复的流程版本
  1. 在 UiPath Studio 中打开{your initials} Invoice Processing流程。
  2. 通过将 PO 编号配置为输入，修复了损坏的“将发票过账到 SAP”步骤。
  3. 选择“将发票过账到 SAP” ，然后打开属性面板。
  4. 在“输入”部分中，通过将发票从 PO 匹配任务的输出映射为自动化的输入来配置输入。
    • 采购订单 ID ： 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。保留所有权利。