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

Maestro 用户指南

上次更新日期 2026年3月6日

进行实例管理

“流程概述”主页提供所有流程实例的操作摘要,包括“活跃实例”仪表板、所有故障的表格和所有流程的表格。

“活跃实例”仪表板

“活跃实例”仪表板显示所有实例的计数,并划分为正在运行的实例和故障实例。

所有活跃实例

“故障”表格

“故障表格”显示所有未解决的故障,每个故障对应一个故障实例。该表格按每个流程的错误消息排列,包含自从该流程首次出现特定错误消息到现在经过的时间。

故障

”流程“表格

“流程”表格包含用户有权访问的租户中所有流程的列表。该表格包含正在运行的实例数量、发生故障的实例数量和实例总数,以及版本号和 Orchestrator 中的文件夹位置。

备注:

此视图中的流程基于您在 Orchestrator 中拥有的用户权限,更具体而言是流程视图文件夹权限,或您可以使用预定义的“自动化用户”文件夹角色。

流程

流程详细信息

从“流程”表格中选择特定流程时,将显示一个包含该流程所有实例的表格。此外,您可以在表格中选择一个版本,查看显示流程模型的图表。

“所有实例”视图

“所有流程实例”仪表板

“所有流程实例”仪表板提供工作区中每次流程执行的实时和历史数据视图。使用此屏幕监控自动化活动、解决故障并了解性能趋势。

docs image

  1. 实例数最多的几个流程

    查看执行频率最高的流程。此视图有助于识别可能需要优化或额外监控的大批量工作流。

    • 显示每个流程的执行总数。
    • 通过链接,您可以直接导航到该流程的详细历史记录示例:此 Workspace 中最活跃的流程有 151 个实例。
  2. 持续时间最长的几个流程

    找出总执行时间最长的流程。这样可以发现需要查看的瓶颈或长时间运行的流。

    • 统计所有实例的总运行时间。
    • 适用于性能监控和优化。

    同一 Loan.Origination.and.Review 流程的累计运行时间超过 201 天

  3. 流程实例状态(条形图)

    可视化图表,显示一段时间内已完成、发生故障或已取消的实例数量。

    • 已完成(绿色)
    • 发生故障(红色)
    • 已取消(灰色)使用此功能来发现几天内的趋势或查明异常。 4 月 22 日出现故障和完成数量峰值,可能表明最近进行了部署或上游系统发生故障。
  4. 流程表(带筛选器)

    此表提供了按流程名称划分的详细细分,包括:

    描述
    正在运行当前处于活跃状态的流程实例
    已完成已成功完成的流程总数
    发生故障由于错误而出现故障的流程总数
    总计执行总数
    版本已发布流程版本数量
    位置部署流程的 Orchestrator 文件夹
    提示:

    您可以搜索、按位置筛选或实时刷新此表格。

  5. 深入了解实例详细信息

    要查看有关单个流程运行的详细信息:

    1. 单击列表或图表中的流程名称链接(例如 Loan.Origination.and.Review)。此时将打开“实例详情”视图
    2. 使用以下筛选器查看实例:
      • 状态:正在运行、已完成、发生故障、已取消
      • 日期/时间范围
      • 版本号
      • 自定义值筛选器
      • 特定元素此详细视图可帮助您以完全透明的方式调试、审核和优化。

单实例视图

从“所有实例”视图中选择单个实例时,将显示一个图表,显示每个步骤的执行状态。此图表包含实例执行跟踪记录以及相关变量和操作历史记录。单实例视图用于在一个集中位置查看整个执行跟踪记录、操作历史记录、步骤详细信息和全局变量。

实例执行跟踪记录清楚地显示了实例流程执行过程中的每个步骤,包括智能体和子流程等分层步骤。要查看详细信息,您可以选择图表上的特定节点或“执行跟踪记录”中的某个步骤。选定组件将以蓝色突出显示,显示步骤 ID、标签、输入/输出变量、执行持续时间等详细信息,以及其他任务的链接,例如打开作业或应用任务。

操作历史”选项卡显示已执行的实例管理操作的详细信息,包括已执行操作的详细信息、负责人和提供的任何评论。这些详尽的信息确保了实例执行过程中的每个步骤完全透明且可追溯。

单实例视图

在“执行轨迹”选项卡中,如果您单击第一行,则您将显示“全局变量”;但如果您单击任何其他行,则您将触发“变量”的显示。

  • 全局变量”在同一流程的实例之间共享,具有持久性,而且其值不限于单个流程实例的生命周期。
  • 变量”对于流程实例是局部的,在特定流程实例中定义,表示该特定实例的当前状态或数据上下文。

角色和权限

此视图中的流程基于您在 Orchestrator 中拥有的用户权限,更具体地说是:

  • 作业视图文件夹权限,您也可以使用预定义的“自动化用户”文件夹角色。
  • 包视图租户权限,您也可以使用预定义的“允许成为自动化用户”租户角色。

管理实例

您还可以管理实例,包括暂停、继续、重试、取消、移动和迁移。执行这些操作之一时,会提供一个评论部分,供您记录其他详细信息。这些评论将显示在“操作历史记录”部分中。

暂停

对实例进行“暂停”操作,将在当前运行的所有步骤完成后暂停执行实例。

继续

对实例进行“继续”操作,将继续执行实例。

重试

对实例进行“重试”操作,将重新启动工作流中从上一个已完成步骤开始的所有当前活动。此操作通常是在编辑发生故障的实例的变量或更新外部系统中的某些内容之后进行的。

重试实例

迁移

对实例进行“迁移”操作,会将其升级到流程的其他版本。这样您就可以使用目标版本中的最新逻辑和配置更新实例。

迁移实例

“将实例迁移到新版本”标注

取消

对实例进行“取消”操作,将停止当前的所有活动,并终止其在智能体流程中的进度。此操作不可撤销。

备注:

如果您取消包含人机回圈任务的实例,Maestro 会自动删除该任务,因此您无需转到 Action Center 手动将其删除。

移动

对实例进行“移动”操作,会将执行移动到其他流程元素,从而更改序列。此操作通常适用于发生故障的实例或已暂停实例中上一步需要重新执行或您想要跳过当前步骤并继续执行后续步骤的情况。

进行移动后,您必须选择“重试”或“迁移”选项才能继续执行。

备注:

此操作可能会导致正在进行的执行路径中断,并可能影响流程的一致性。 新位置所需的某些变量值可能不会自动生成,您可能需要手动更新以确保准确性。

迁移实例

日志记录、审核历史记录和执行可追溯性

此页面说明 Maestro 如何为长时间运行、涉及多方参与者的流程提供可审核性、运行可追溯性和合规支持。本页面说明 Maestro 记录哪些执行数据、为什么记录这些数据、可在何处访问这些数据,以及如何保留或导出数据以满足监管和运营要求。

这些信息适用于在 UiPath Automation Cloud 中由 Maestro 编排的流程。Maestro 依赖核心 UiPath Platform 服务(例如 Orchestrator、Automation Cloud 审核记录、Insights 以及 AI Trust Layer)来强制执行记录、保留和访问控制。

执行意图和审核目标

Maestro 记录旨在支持实现以下结果:

  • 在机器人、智能体、人类参与者以及外部系统之间对业务事务进行端到端追踪
  • 重建某个流程遵循特定执行路径的过程和原因
  • 在不保存不必要客户数据的情况下支持内部和外部审核
  • 支持运营团队调查失败、重试和性能问题

Maestro 记录编排级执行元数据,而不是完整的业务有效负载。该设计在可审核性、性能和数据最小化要求之间实现了平衡。

Maestro 在流程执行期间记录的内容

对于每个流程实例,Maestro 会记录执行元数据,这些元数据会说明执行了什么、何时执行,以及由谁或何种实体执行。

Maestro 记录:

  • 已执行的流程步骤和子流程步骤
  • 执行时间戳,包括开始时间、完成时间和持续时间
  • 执行状态,例如正在运行、已完成、失败或暂停
  • 每个步骤的执行身份信息
  • 在步骤完成时捕获的变量值

Maestro 记录这些数据以支持运营监控、故障排查以及对流程行为的审核重建。

参与者身份和执行上下文

Maestro 记录执行身份信息,让您能够确定执行每个步骤的人员或执行内容。

对于每个执行的步骤,Maestro 记录:

  • RobotUserName,适用于机器人执行的自动化
  • UiPath Platform 中执行实体的直接链接

Maestro 不会存储专用的参与者类型字段,例如人类机器人智能体。您可以根据记录身份信息和执行上下文推断参与者类型。

该方法保留了可追溯性,同时不会在平台服务之间重复身份模型。

决策和执行路径

Maestro 记录的是执行路径,而不是抽象决策标签。

Maestro 不会记录显式决策或规则结果字段。相反,Maestro 会记录流程在网关、子流程和条件流中的执行路径。

您可以通过查看以下内容来重建决策过程:

  • BPMN 模型
  • 实例执行历史记录中显示的执行路径
  • 完成步骤的序列和时间

该设计使审核人员和运维人员能够在无需引入冗余决策产物的情况下,理解流程为何遵循特定路径。

输入、输出和客户数据处理

Maestro 限制数据的保留范围,以降低敏感信息暴露风险。

默认情况下,Maestro 不会记录:

  • 完整的业务有效负载
  • 文档内容
  • 与外部系统交换的客户数据

Maestro 在步骤完成时记录变量状态快照,以支持可追溯性和调试。

当流程使用文件时,Maestro 会将其作为作业附件进行处理,这些附件的作用范围限定于单个流程实例。平台权限和保留策略控制对这些文件的访问权限。

您可以在何处查看执行和审核数据

UiPath 通过多个运营和审核视图呈现 Maestro 执行数据。

您可以使用:

  • “所有实例”视图来对单个流程运行进行端到端追踪,包括步骤进展、时间点和持续时间
  • “所有事件”视图来调查失败、重试和恢复操作
  • Orchestrator 日志来分析机器人级执行细节
  • Insights,以便通过预置和自定义仪表板来分析一段时间内的执行数据

实例视图

Insights 会采集 Maestro 的执行事件,包括流程运行、元素运行和异常事件。UiPath 通过 Maestro 模板仪表板公开此数据,该仪表板支持审核审查、运营报告和趋势分析。

这些视图共同支持从宏观监控到单个执行步骤在内的深入分析。

审核日志、Insights 采集,以及保留

UiPath Automation Cloud 管理 Maestro 执行过程的审核日志记录和保留。

默认情况下:

  • Automation Cloud 审核日志保留长达 2 年
  • 机器人执行日志和备份保留 30 天
  • 采集到 Insights 中的 Maestro 执行追踪记录的保留时长:
    • 对于 Standard Platform 层级,为 2 年
    • 对于 Advanced Platform 层级,为 5 年

保留期取决于平台层级和服务配置。您可以导出审核和 Insights 数据,以满足更长的保留时间或监管要求。

导出日志和支持合规性

您可以导出与 Maestro 相关的审核日志和执行元数据,以支持合规性、调查和长期存档。UiPath 支持从 Automation Cloud 导出 CSV 格式的审核日志。您可以将导出的数据存储在客户托管的系统中,也可以将其采集到监管、风险和合规性工作流中。

AI 驱动步骤和 AI Trust Laye

当流程使用经由 AI Trust Layer 处理的 AI 驱动步骤时,UiPath 将记录有关 AI 使用情况的审核元数据。

此元数据包括:

  • 模型标识符
  • 产品和租户上下文
  • 调用元数据

默认情况下,UiPath 从审核日志中排除客户提示和 AI 生成的内容。您可以配置 AI 监管策略,以在需要时控制日志记录行为。

AI 审核详细信息的可用性取决于功能配置和发布状态。

将 Maestro 数据与外部系统相关联

您可以将 Maestro 执行数据与来自外部系统(例如 Salesforce、ServiceNow 或 AWS)的日志相关联。

要支持端到端可追溯性,您可以使用:

  • 共享的业务标识符
  • 实例标识符
  • 执行时间戳

您可以导出 Maestro 审核数据并将其采集到客户托管的日志记录或 SIEM 平台,以支持集中监控和审核工作流。

Maestro 默认不会记录哪些内容

Maestro 遵循数据最小化原则,避免保留不必要的信息。

默认情况下,Maestro 不会记录:

  • 完整的业务有效负载或文档
  • 包含客户内容的 AI 提示或响应
  • 显式决策或规则结果字段

此设计支持安全操作,同时保留了为审核和合规性目的重建流程执行行为的能力。

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新