Maestro Case Management 组件词典

Maestro Case 组件的参考字典，包括案例键、阶段、任务、规则、角色、SLA 和 runtime 管理界面。

	Maestro 案例	Maestro BPMN	Maestro 流程
内容适用于	✅	❌	❌

概述

本参考文档提供 Maestro Case 管理中每个组件的实际细分。将其用作字典，以了解每个构造、它公开的属性以及它与其他构造的关系。有关构建案例的分步指导，请参阅案例管理教程。

受众：中级到高级 — Automation Developers、解决方案架构师、技术负责人。

产品状态：正式发布。

概念如何建立关联

以下层次结构显示了 Maestro Case 管理结构在设计时和运行时如何结合在一起。

Case (runtime instance, identified by Case Key)

DESIGN-TIME (Studio Web)
├── Case Manager (rules-based orchestration)
├── Case Personas (human roles, scoped to stages)
└── Case Plan (visual blueprint)
    ├── Event Triggers
    └── Stages + Stage Transitions (entry / complete / exit / re-entry)
        └── Tasks (Human, Agent, External Agent, RPA, Connector,
                    API Workflow, Agentic Process, Child Case,
                    Wait Timer, Wait Event, Ad-hoc)

CROSS-CUTTING
└── SLAs & Escalations (case-level and stage-level)

RUNTIME
├── Case App (business users — view, track, act)
└── Case Instance Management (operators — pause, resume, cancel, migrate, retry)

---

案例键

案例键在 Maestro 和外部系统中唯一标识案例实例。

密钥类型	描述	示例
系统密钥	在创建案例时由 Maestro 自动生成。使用可配置的常量前缀。	HC-1234, CLM-00891
外部（客户定义）密钥	在创建案例时传递的上游 ID，以便跨工具识别相同的真实案例。	CRM 案例编号、保单编号、ERP 订单 ID

在 Studio Web 中创建案例类型时配置案例键。选择“常量前缀键”并提供前缀字符串（例如， HO- ）。Maestro 会附加自动递增的标识符。

当案例源自其他系统（CRM、ERP、工单工具），并且人工或集成必须跨工具关联案例，且无需维护单独的映射表时，请使用外键。

---

阶段

阶段是案例生命周期中的命名阶段（例如，接收、审核、结算）。阶段是案例计划画布上的列，每个阶段对在该阶段执行的相关任务进行了分组。

阶段类型

Maestro 支持两类阶段：

类型	描述	示例
初级阶段	表示案例的正常路径进度。	接收、审核、结算、结算
次要阶段	表示从主要流程中分支出来的异常路径。可能返回原点或达到极限。	“待客户处理”、“拒绝”、“已撤消”

阶段属性

属性	描述
name	显示名称（例如，“已提交”、“经理审核”）。
required	案例是否必须通过此阶段才能完成。如果 true 和进入规则的评估结果从未为 True，则案例将阻止。如果为 false，则即使从未进入此阶段，案例也可以完成。
entryRule	必须满足的条件才能激活此阶段。
completeRule	确定此阶段何时完成的条件。通常是“当完成所有必需的任务时”。
exitRule	提前退出条件。满足条件时，即使不满足完整规则，阶段也会立即终止。
reentryCondition	允许案例返回此阶段进行返工的条件。
autoComplete	在完成所有必需任务后，自动将阶段标记为完成。
runOnReentry	控制是否在上次完成后重新进入时重置并重新执行阶段。默认值：false。
sla	阶段完成的时限（工作日或日历日）。

必需阶段与可选阶段

	所需阶段	可选阶段
案例完成	在此阶段完成之前，无法完成案例。	即使从未进入此阶段，案例也可以完成。
何时使用	每个案例必须经过的核心阶段（例如“已提交”、“付款”）。	仅有时适用的条件阶段（例如，用于高价值案例的“VP 审核”）。
进入规则从不为 True 时行为	案例块。	案例会跳过该阶段。

次要阶段退出行为

行为	描述	示例
返回到原点	当次要阶段中的所有任务完成后，案例会路由回发送它的阶段。	收到文档后， “待客户处理”阶段将返回“审核”状态。
终端	当次要阶段中的所有任务完成时，案例结束。	“拒绝”阶段会在发送拒绝数据包后关闭案例。
连接器驱动的条目	当外部连接器事件到达时，无论案例处于哪个主要阶段，都会激活次要阶段。	发布 Microsoft Teams 频道消息时，自动进入“已撤消”阶段。

在重新进入时运行行为（阶段）

runOnReentry	行为	Use case
true	阶段重置为活跃。重新评估所有任务 — 必填任务带有 runOnReentry: true 重新执行。	更正循环：“已提交”阶段需要在被拒绝后重新验证。
false (默认)	阶段保持“已完成”状态。重新进入无效。之前的结果将保留。	应仅运行一次的一次性阶段（例如，“初始接收”）。

---

任务类型

任务是阶段中的独立工作单元。任务是案例处理的基本构建块。

支持的任务类型

任务类型	描述	使用示例
人工（操作）	已通过角色分配给人员。打开案例应用程序队列中的表单或工作项目。人工审核、做出决策然后提交。	经理批准，理算员审核，财务批准。
智能体 (UiPath)	UiPath AI 智能体对数据执行自主推理。适用于基于判断力的工作。	对费用进行分类，标记异常，起草客户回复。
外部智能体	在 UiPath 外部调用第三方 AI 智能体（例如，通过 A2A 协议或 API）。启用多供应商智能体编排。	从合作伙伴系统中调用外部合规智能体。
RPA 工作流	触发 UiPath Robot 在不存在 API 的旧系统中执行用户界面自动化。	在旧版工资系统中流程报销，将数据输入到大型机中。
连接器 (Integration Services)	通过预构建或自定义连接器调用外部系统。与回调同步执行或异步执行。	在 Salesforce 中查找策略详细信息，运行信用检查。
API 工作流	通过自定义 API 请求调用外部系统。与回调同步执行或异步执行。	调用调度软件以获得可用空档，新建工单。
Maestro 智能体流程	将 Maestro 智能体流程（基于 BPMN）作为任务调用。流程使用自己的编排运行并返回结果。	带有自己的智能体逻辑的多步骤审核工作流。
案例管理（子案例）	生成另一个案例定义作为子案例。子元素有自己的生命周期、阶段和任务，并通过 caseID 链接到父元素。	索赔案例会生成一个子欺诈调查案例。
等待计时器	暂停执行，直到指定的持续时间已过或达到目标日期/时间。	等待 48 小时，然后再发送后续通知。
等待连接器事件	暂停执行，直到外部事件通过连接器（Webhook、消息队列、系统回调）到达为止。	等待银行系统发送的付款确认。

临时任务

临时任务是在需要执行不属于原始案例计划的计划外任务时，由人类用户在运行时创建的。例如，案例处理人工在字段中添加“请求其他文档”字段。调查期间执行任务。

任务属性

属性	描述
name	显示名称。
type	以下组织之一：human、agent、externalAgent、rpa、connector、agenticProcess、childCase、waitTimer、waitEvent、adhoc。
required	父阶段是否必须等待此任务完成。如果是 true，则在任务完成之前，该阶段无法完成。如果是 false，则即使此任务尚未完成，该阶段也可以完成。
entryRule	确定此任务何时开始的条件。启用条件执行（例如，仅在 amount >= 1000 时运行）。
completeRule	确定何时将此任务视为已完成的条件。
exitRule	任务的提前退出条件。满足时，任务会立即终止。
runOnReentry	如果重新进入父阶段，此任务是否重置并重新执行。默认值：false。
linkedWorkflow	引用实施工作流、表单或智能体配置。
assignment	对于人工任务：用于确定受分配人的角色、用户、团队或路由规则。
sla	对于人工任务：到期时间、警告阈值和升级处理人。

必需任务与可选任务

	所需任务	可选任务
阶段完成	此任务无法完成父阶段。	即使此任务未完成，父阶段也可以完成。
何时使用	必须做的工作（例如，审核阶段的“经理审批”）。	值得拥有的工作（例如，“标记异常”— 很有帮助，但没有它，阶段也可以继续）。
自动完成交互	如果阶段有 autoComplete: true，则完成所有必需的任务。	不考虑参与自动完成检查。

“在重新进入时运行”行为（任务）

runOnReentry	行为	Use case
true	任务将重置并重新执行，生成新的输出。	必须重新检查更正数据的验证任务。
false (默认)	任务保留其先前的结果；不会重新执行。	输出仍然有效的任务（例如，无需重新运行“对费用进行分类”）。

---

条件

条件（也称为转移条件或规则）可以控制阶段和任务级别的生命周期移动。Maestro 支持四种条件类型。

进入条件

针对案例字段进行评估。当条件为 True 时，阶段或任务从“可用”转换为“活动” 。

范围	描述	示例
阶段	对阶段的开始进行控制。	vars.validationPassed == true 激活“审核”阶段。
任务	启用在活动阶段中有条件地执行任务。	仅在 amount >= 1000 时运行。

完成条件

定义阶段或任务在正常情况下完成的时间。对于阶段，这通常是“完成所有必需的任务时”。对于任务，通常是“当任务生成输出时”。

范围	描述	示例
阶段	工作完成时，将阶段标记为已完成。	已完成所有必需的任务。
任务	在收到任务输出后，将其标记为已完成。	taskOutput.status != "error"。

退出条件（提前退出）

提前退出机制。满足条件时，即使不满足完成规则，阶段或任务也会立即终止。退出条件充当异常或条件场景的开关。

范围	描述	示例
阶段	在所有任务完成之前终止阶段。	vars.action == "Reject" 终止“审核”阶段，案例转到“拒绝”次要阶段。
任务	在任务正常完成之前将其停止。	policyValid == false 停止进一步验证。

备注：

不要将退出条件与完成条件混淆。工作 完成 （正常完成）时触发 完成条件 。当某些情况发生变化时，意味着工作 应停止 （提前解散），就会触发 退出条件 。两者都会导致案例管理器评估接下来进入哪个阶段。

重新进入条件

允许案例以结构化且可审核的方式返回到先前完成的阶段。此功能为受控返工循环实现非线性案例流程。

范围	描述	示例
阶段	当需要其他工作时，将案例返回到上一阶段。	vars.decision == "Claim is missing key incident reports" 案例从“审核”返回至“接收”。

重新进入时，配置要在目标阶段重新运行的特定任务。重新执行符合 runOnReentry: true 的任务；包含 runOnReentry: false 的任务会保留其先前的结果。

跳过规则

阶段上的一个可选条件，当条件为 True 时，该条件完全绕过该阶段。

范围	描述	示例
阶段	跳过不适用的阶段。	riskScore < 30 跳过详细调查阶段。

---

SLA 和升级

在案例和阶段级别定义SLA （服务级别协议）以及升级规则，以实施基于时间的预期。

SLA 级别

级别	描述	示例
案例级别 SLA	案例解决从创建到关闭的总体目标。	在 48 个工作小时内解决索赔。
阶段级别 SLA	特定阶段的本地化到期时间。	在 4 小时内完成 FNOL 导入；经理在 24 小时内审核。

SLA 状态

状态	描述
进展顺利	案例或阶段未在规定时间内完成。
有风险	SLA 即将达到限值（例如已达到分配时间的 80%）。
违规	已超出 SLA 时间限制。

SLA 状态以徽章的形式在案例应用程序的案例列表和详细信息视图中显示。

升级规则

触发器	描述	典型操作
有风险的升级	当 SLA 接近其限制时触发。	通知案例所有者和主管。
违规升级	超过 SLA 时触发。	重新分配给高级工作器，通知管理员，创建优先级标志。

暂停和继续

SLA 计时器不会自动暂停。等待外部输入（例如客户响应）的案例会继续累积 SLA 时间，直到操作员显式暂停案例实例。

暂停案例实例会停止其 SLA 计时器。继续案例将从中断的位置重新启动。

---

案例管理器

案例管理器使用确定性规则编排案例生命周期。规则处理已知、可预测的模式。

案例管理器的工作方式

1. 收到事件— 触发器触发并创建（或更新）案例实例。
2. 规则评估— 案例管理器评估所有阶段的进入条件，以确定应激活哪些阶段。
3. 任务激活— 在活动的阶段中，评估任务的进入条件以开始适当的工作。
4. 监控— 任务完成时，案例管理器会评估完成条件（正常完成）和退出条件（提前解保）。
5. 案例完成— 完成所有必需阶段后，案例将关闭。

规则作用域

可以在三个级别定义规则（进入、完成、退出）：

• 案例级别— 监管整个案例生命周期（案例何时完成？）。
• 阶段级别— 控制阶段转换（此阶段何时激活、完成或退出？）。
• 任务级别— 控制单个任务的激活和完成。

基于规则的案例管理器与智能体案例管理器

	基于规则	智能体
编排逻辑	由案例开发者定义的确定的进入/完成/退出条件。	AI 智能体将决定要运行的任务、要转换的阶段以及案例的解决方式。
配置	阶段级别和任务级别的规则（请参阅条件）。	具有已定义输入和输出合同的智能体（请参阅案例管理器输入和输出合同）。
何时使用	已知、可预测的模式。	基于判断的编排，不会简化为固定规则。

规则和智能体不是两个独立的选择——当案例计划同时使用两者时，规则对每个事件都会优先进行评估。智能体推荐的决策作为上下文传递给智能体，Maestro 以智能体自己的决策为依据。

案例管理器配置

设置	描述
model	为智能体提供支持的 LLM（例如 claude-3.5-sonnet、gpt-4o）。
userPrompt	用于定义智能体角色、策略和约束的系统指令。
tools	智能体可以执行的操作（例如，转移阶段、升级、发送通知）。
context	根据执行历史记录自动构建的智能体记忆。智能体会从之前的决策、任务结果和案例状态更改中累积上下文。

有关智能体必须使用的确切输入 ( caseCurrentExecutionState ) 和输出 ( caseManagerDecisions ) 规格，请参阅案例管理器输入和输出合同。有关添加和配置预构建的 Case Manager 智能体、选择其行为模式以及通过评估对其进行测试的信息，请参阅配置和测试 Case Manager 智能体（预览版） 。

备注：

如果案例经理由于数据模糊、规则冲突或场景不符合其策略而无法做出决策，它会自动升级为人工处理。

---

案例角色

案例角色定义了在整个生命周期中与案例交互的人类参与者角色。角色控制谁可以在每个阶段查看并执行操作。角色是为了人，而不是智能体。AI 智能体作为任务类型单独配置。

内置角色类型

角色	角色	典型功能
案例创建者	启动案例 — 提交原始触发器（门户表单、API 调用、电子邮件）。	新建案例实例；查看他们创建的案例的状态；在第一阶段完成之前更新未结案例的能力有限。
案例所有者	负责端到端的案例。通常在创建时分配。	所有阶段的完整案例可见性；可以重新分配任务，覆盖决策（在策略内），重新打开已关闭的案例。
案例工作器	在特定阶段执行分配的人工任务。	查看并完成队列（我的工作）中的任务；更新限定于任务输出的案例字段；仅阶段级可见性。
主管/经理	监督团队的案例组合；处理升级。	查看分配给其团队的所有案例；重新分配任务；批准升级；暂停/恢复 SLA 计时器；访问仪表板和 KPI。
主题专家 (SME)	就需要专业知识的特定案例或阶段进行咨询。	对相关案例数据的读取权限；可以完成 SME 指定的任务；没有广泛的案例管理权限。

除了内置类型外，案例开发者还可以创建自定义角色— 为角色命名，并将其范围限定到一个或多个特定阶段。自定义角色不会自动出现在所有位置。

阶段级别角色权限

对于案例计划中的每个阶段，为每个角色定义两个访问维度：

• 查看访问权限— 哪些角色可以在案例应用程序中查看此阶段的数据、任务和历史记录。
• 行为访问权限— 哪些角色可以在此阶段执行操作（完成任务、添加备注、重新分配、升级、触发转换）。

任务默认会继承阶段的角色设置，但可以进一步缩小允许的角色范围。

分配策略

策略	工作方式	何时使用
静态	在设计时分配固定用户、团队或组。	始终由同一团队负责的任务（例如，财务组始终负责财务审核）。
动态	规则或表达式在运行时解析受分配人。	工作负载平衡分配、区域/地区路由、基于技能的路由。

备注：

案例用户角色和访问权限支持尚不可用。

---

案例应用

案例应用程序是面向业务用户的运行时应用程序，案例工作人员、经理和其他角色可在其中查看、跟踪实时案例实例并对其执行操作。

企业用户看到的内容

视图	描述
案例列表/队列	所有案例实例的可筛选视图，包含状态、优先级和 SLA 指标（正常、有风险、违约）。
案例详细信息视图	当前阶段、任务状态、事件时间线和完整的审核追踪记录。
任务收件箱（我的工作）	等待操作的待处理人工任务：表单、审批、审核。
操作	基于角色和当前阶段的上下文操作：完成、重新打开、升级、重新分配、添加备注、请求信息、创建临时任务。
仪表板	汇总 KPI：吞吐量、解决问题的时间、SLA 合规性、瓶颈识别。

配置

通过 Studio Web 中的“案例管理”设置中的“配置案例应用程序”选项配置案例应用程序。可配置的元素包括：

• 案例标题— 在案例列表和详细视图中显示的显示标题。
• 案例详细信息— 案例详细信息视图上显示的字段和布局。

Case 应用程序与 UiPath 应用程序

纵横比	案例应用	UiPath Apps
用途	以案例为中心的自主工作区 — 案例操作的列表、详细信息、任务、故障和 SLA 视图。	通用型低代码生成器，用于完全自定义或组合业务应用程序。
何时使用	使用开箱即用的视图快速操作案例。	案例操作以外的自定义用户界面要求。

人工任务表单继续使用Action 应用程序构建，并由案例任务引用。

---

案例实例管理

案例实例管理是操作控制台，流程运算符可在其中监控和管理所有正在运行的案例实例。

运算符操作

操作	描述
暂停	暂时停止正在运行的案例实例。SLA 计时器暂停。在恢复之前不会激活任何任务。
继续	重新启动已暂停的案例。SLA 计时器从其停止的位置恢复。
取消	永久终止案例实例。将停止所有正在运行的任务。
迁移	将实时案例实例移动到较新版本的案例计划（例如，在修复错误或更新计划后），并保留其当前状态和数据。
重试	重新执行失败的任务或转换，以从暂时性错误中恢复。
更新变量	修改正在运行的实例的案例变量值，以解除阻止处理的情况。

案例事件

当案例实例进入错误状态（例如，任务失败、集成超时或案例卡住）时，它将成为案例事件。流程运营商使用“迁移” 、 “重试”和“更新变量”来解决事件。

---

事件触发器

事件触发器是案例的入口点。它们定义了案例的启动内容以及数据的来源。一个单案例计划可以有多个触发器。

触发器类型	来源	示例
表单/门户	用户通过网页表单提交。	员工通过门户提交费用报告。
电子邮件	已解析传入的电子邮件以获取数据。	转发的收据电子邮件会创建一个新案例。
API	外部系统调用案例创建端点。	ERP 系统触发保单事件的索赔案例。
队列/事件	来自队列或事件流的消息。	Kubernetes 主题发布新订单事件。
已计划	基于时间的触发器。	每日检查会为过时项目创建后续案例。
Data Fabric 实体事件	Data Fabric 实体或 VDO 上的行级别事件（例如，“已创建行”）。	主页声明实体中的新行会触发案例。
等待连接器	来自 Integration Service 的连接器事件（例如，发布的 Microsoft Teams 频道消息）。	Teams 消息触发“已撤消”阶段条目。

每个触发器都将传入数据映射到案例字段。

---

账单和消耗品

• 无需单独计费 Maestro Case管理
• 在案例内运行的工作会消耗所用任务类型的原生消耗品：
  • AI 智能体
  • Maestro 智能体流程（BPMN 流程）
  • RPA 工作流
  • API 工作流/集成

---

词汇表

条款	定义
临时任务	当需要执行计划外操作时，由人类用户在运行时（不是原始案例计划的一部分）创建的任务。
Case 分支	表示需要解决（索赔、争议、调查、异常）的真实业务情况的 runtime 实例。由案例键标识。
案例应用	面向业务用户的应用程序，人员可在其中查看、跟踪实时案例实例并对其执行操作。
案例注释	开箱即用的对象存储通过不可变的 caseID 链接的备注、批注和通信线程。
Case Documents	开箱即用的对象，存储与案例相关的文件和附件，通过不可变的 caseID 链接。
案例事件	需要运算符干预的案例实例中的错误状态（任务失败、集成超时、卡住的案例）。
案例实例管理	Maestro 中的操作控制台，流程运算符可在其中查看所有正在运行的案例实例并执行操作：暂停、继续、取消、迁移、重试。
案例键	案例实例的唯一标识符。可以是系统生成的值，也可以是外部/客户定义的值。
案例管理器	使用确定性规则的编排引擎。
案例角色	限定于特定阶段的人类参与者角色。内置类型：案例创建者、案例所有者、案例工作器、主管/经理、SME。开发者可以创建自定义角色。
案例计划	定义阶段、任务、触发器和规则的可视化蓝图。描述可能的路径，而非固定顺序。在 Studio Web 中设计。
完成条件	在正常情况下，确定阶段或任务何时完成的条件。
进入条件	为激活阶段或任务必须满足的条件。
事件触发器	创建或影响案例实例的入口点。将传入数据映射到案例字段。
退出条件	提前退出条件。满足该条件时，即使未满足完成规则，阶段或任务也会立即终止。
初级阶段	案例正常路径进度上的阶段。
重新进入条件	允许案例返回到之前已完成的阶段以进行返工的条件。
必填	标记阶段和任务。必须完成必需的阶段才能关闭案例。必须完成所需的任务才能让该阶段完成。
在重新进入时运行	用于控制在上次完成后重新进入时是否重置并重新执行阶段或任务的标志。
次要阶段	表示从主要流程中分支出来的异常路径的阶段。可能返回原点或达到极限。
跳过规则	阶段上的可选条件，当条件为 True 时，完全绕过该阶段。
SLA	服务级别协议。案例或阶段基于时间的预期完成情况，状态为：正常、有风险、违约。
阶段	案例生命周期中的一个已命名阶段，用于对相关任务进行分组。由进入、完成、退出和重新进入条件监管。
任务	阶段中的不连续工作单元。十种设计时类型：人类、智能体、外部智能体、RPA、连接器、API 工作流、智能体流程、子案例、等待计时器、等待事件。临时任务在运行时创建。

---

相关资源

• 案例管理教程— 从头开始构建案例的端到端演练。
• Studio Web 中的案例计划设计器— 可视化设计画布的参考。
• Action 应用文档— 如何为案例任务引用的人工任务构建表单。