- Introduction
- Overview
- What you get with Maestro
- Who should use Maestro
- How Maestro fits into UiPath
- Maestro BPMN vs. Maestro Case: when to use case management
- The Maestro Case lifecycle: from event trigger to app experience
- Maestro feature availability
- Getting started
- Process modeling with BPMN
- Process modeling with Case Management
- Designing a persistent case entity schema
- Defining case keys (system vs. external)
- Establishing task I/O and write-back contracts
- Exit rules and early stage termination
- Modeling primary and secondary stages
- Triggering a case from Data Fabric
- Implementing stage-level personas and permissions
- Setting SLAs and automated escalation rules
- Configuring a rework loop (re-entry)
- Managing live case instances: pause, migrate, and retry
- Maestro case management component dictionary
- Process implementation
- Debugging
- Simulating
- Publishing and upgrading agentic processes
- Common implementation scenarios
- Extracting and validating documents
- Process operations
- Process monitoring
- Process optimization
- Reference information
Maestro user guide
Overview
Maestro supports two orchestration models: Maestro BPMN (sequential, BPMN-based workflows) and Maestro Case (stage-based, goal-driven orchestration for case management). Choose Maestro BPMN when work follows a predictable, repeatable sequence every time. Choose Maestro Case when work is long-running, exception-heavy, and requires dynamic routing between stages based on evolving data and human judgment.
This document provides a decision framework to help automation architects, business analysts, and solution engineers determine which model fits a given business scenario — or whether both should work together.
Audience: Intermediate to Advanced — Automation Architects, Solution Engineers, Business Analysts
The problem: not all work is linear
Traditional process orchestration excels when the flow of work is predictable and repeatable. A purchase order approval, a scheduled data extraction, or a notification pipeline follows the same path every time. Maestro BPMN models these flows efficiently.
However, many business scenarios do not follow a single, predetermined path. They may span days or weeks, involve multiple teams, and require decisions that depend on what just happened — not on a fixed sequence defined at design time. In these situations, exceptions are not rare — they are expected.
Consider an insurance claim: it starts with intake, moves to investigation, then assessment, then settlement. But along the way, an adjuster might request additional documentation, sending the case back to an earlier phase. A fraud signal might terminate the process mid-stream. A customer might withdraw the claim at any point. No single flowchart can capture every path.
These scenarios need an orchestration model that provides structure without rigidity — one that allows automation and AI to handle routine work while enabling humans to step in when judgment or policy decisions are required.
Two orchestration models
Maestro offers two distinct models for orchestrating work. Each model addresses a different class of problem.
Maestro BPMN
Maestro BPMN is a BPMN-based workflow that defines a specific sequence of steps. It runs from start to finish along a path determined at design time. Maestro BPMN supports branching, parallel execution, and human-in-the-loop tasks, but the overall structure is a directed flow.
Use Maestro BPMN when:
- The sequence of steps is known and repeatable.
- The work completes in a single, relatively short execution.
- Exceptions are infrequent and can be handled with simple branching logic.
- There is no need to return to earlier phases for rework.
Maestro Case
Maestro Case orchestrates long-lived, goal-driven work about a specific situation — a case. A case holds data, policies, tasks, and history to drive an auditable outcome (for example, a refund, a claim decision, or an investigation closure). Instead of a fixed sequence, a case plan defines stages (named phases) and the rules that govern transitions between them. The actual path through the plan is determined dynamically at runtime based on case data.
Use Maestro Case when:
- Work cannot be fully defined upfront.
- Multiple stages involve frequent decision points and collaboration between roles or systems.
- Progress depends on evaluating outcomes and deciding what should happen next.
- The process is long-running, exception-heavy, and requires human judgment at key moments.
Decision framework
The following comparison highlights the structural and behavioral differences between the two models. Use it to evaluate which model matches the characteristics of your scenario.
| Dimension | Maestro BPMN | Maestro Case |
|---|---|---|
| Flow structure | Directed, sequence-based (BPMN) | Stage-based with dynamic, rule-driven transitions |
| Path determination | Defined at design time | Determined at runtime by rules and Case Manager agent decisions |
| Duration | Short-lived (minutes to hours) | Long-lived (hours to weeks) |
| Exception handling | Branching and error handlers | Re-entry rules, secondary stages, ad-hoc tasks |
| Rework support | Requires explicit loop modeling | Built-in re-entry with selective task re-execution |
| Data model | Process variables scoped to instance | Case variables scoped to instance + Persistent case entity [Coming Soon] — single source of truth across all stages |
| SLA tracking | Not natively stage-aware | Case-level and stage-level SLAs with escalation rules |
| Lifecycle controls | Start, cancel | Pause, resume, reopen, migrate |
| Human collaboration | Task assignment within the flow | Role-based access scoped to stages (Case Workers, Case Managers) |
| AI agent role | Executes as tasks within the flow | Executes as tasks within the flow + Orchestrates the entire case lifecycle (Case Manager agent) |
| Business user experience | Monitoring dashboard | Dedicated Case App with case lists, detail views, task inboxes, and dashboards |
| Audit trail | Process instance log | Full case history — every stage transition, task outcome, decision, and entity change |
When case management adds value
Case management adds the most value when work is long-running, exception-heavy, and human-centric. It allows automation and agents to handle routine tasks while ensuring that humans are involved at the right moments. This approach reduces delays caused by manual follow-ups and helps teams maintain visibility and control across the entire lifecycle of a case.
The following characteristics signal that case management is the right choice:
- Non-linear progression. The next step depends on what just happened, and no single flowchart can capture every path.
- Multiple stages with distinct ownership. Different teams or roles are responsible for different phases (for example, intake handled by operations, review handled by adjusters, settlement handled by finance).
- Frequent rework loops. Cases routinely return to earlier stages when information is incomplete, decisions are contested, or new evidence surfaces.
- SLA-driven operations. The business requires time-based tracking and escalation at both the overall case level and individual stage level.
- Persistent case data. A central business record (the case entity [Coming Soon] ) accumulates information over time as tasks enrich it, and downstream decisions depend on upstream outputs.
- Multiple entry channels. The same type of case can originate from different sources — portals, emails, API calls, or external events — and all must converge into the same lifecycle.
- Audit and compliance requirements. Regulators or internal governance require a complete trail of who did what, when, and why.
Illustrative scenarios
| Scenario | Why Maestro Case |
|---|---|
| Insurance claims | Long-running, multi-party (claimant, adjuster, inspector), frequent exceptions (missing documents, disputes), SLA-driven |
| Disputes and chargebacks | Back-and-forth between parties, evidence gathering, escalation paths, non-linear progression |
| Loan origination | Multiple review stages (credit, compliance, underwriting), conditional paths based on risk scores, regulatory requirements |
| KYC/AML remediation | Document collection across stages, regulatory decision points, audit trail requirements |
| Customer escalations | Tiered resolution, re-entry when a fix does not hold, SLA commitments, multi-team handoffs |
| Order fulfillment exceptions | Exception-heavy (backorders, partial shipments, returns), multi-system coordination, SLA tracking |
| Vendor onboarding | Multi-stage vetting (legal, compliance, finance), conditional stages based on vendor type, document collection |
| Investigations and referrals | Ad-hoc approvals, cross-department coordination, policy-dependent routing |
When case management is not required
Not every process needs case management. If a process is short-lived, predictable, and follows the same sequence every time, Maestro BPMN is simpler and more efficient. Introducing case management in those situations adds unnecessary complexity.
Stick with Maestro BPMN when:
- The workflow follows the same path for every execution with minimal variation.
- There is no need to return to earlier phases.
- The work completes in a single session (minutes to hours, not days).
- A single team or role handles the work end to end.
- There is no requirement for stage-level SLA tracking or escalation.
- The data model is simple and does not accumulate across multiple phases.
Examples: invoice data extraction, scheduled report generation, single-approval purchase orders, notification pipelines, and batch data migrations.
Quick test: If the next step depends on what just happened and no single flowchart can capture every path, consider Maestro Case. If the process follows the same path every time, use Maestro BPMN.
What makes it "agentic"
Traditional case management relies on human knowledge workers to make routing decisions, handle exceptions, and drive cases forward. Maestro Case replaces that bottleneck with AI agents at two levels:
Case Manager agent — the orchestrator
The Case Manager is the event-driven orchestrator of a case. It uses two complementary methods: rules first (deterministic CMMN rules from the case plan resolve the high-volume happy paths) and agent reasoning as fallback (an LLM-based Case Manager Agent reasons over case state, the case plan, and configured policies to handle gaps, exceptions, and judgment calls). If neither rules nor the agent can resolve a decision — due to ambiguous data, conflicting policies, or a scenario outside the agent's authority — the Case Manager escalates to a human.
This hybrid approach provides both reliability (deterministic rules for every scenario you can anticipate) and flexibility (AI reasoning for everything rules do not cover).
Agent tasks — the workers
Individual tasks within a stage can be assigned to AI agents — alongside human tasks, API calls, RPA bots, and connectors. An agent task might categorize expenses, flag anomalies, draft a response, or extract data from unstructured documents. Maestro supports both UiPath Agents and External Agents for these tasks.
Agents are the mechanism that powers faster resolution, higher throughput, and fewer manual touches. The value proposition is the business outcome: streamlined exception-heavy processes, improved KPIs, and end-to-end visibility. Agents are an input to the solution, not the output.
Using both models together
Maestro BPMN and Maestro Case are not mutually exclusive. A case task can invoke a Maestro BPMN via the Maestro Agentic Process task type — the BPMN runs with its own orchestration logic and returns a result to the parent case. This pattern is useful when a specific stage within a case contains a well-defined, linear subprocess (for example, a multi-step audit workflow) that benefits from BPMN modeling. The reverse is also supported: a Maestro BPMN can invoke a Maestro Case as one of its task types.
Similarly, a case can spawn a Child Case — another case definition with its own lifecycle, stages, and tasks — linked to the parent via case ID. This supports scenarios where a parent case (such as a claim) needs to trigger a subordinate investigation with its own independent progression.
Key concepts at a glance
For teams evaluating case management, the following core concepts define the model:
- Case entity — the persistent, structured data object that lives for the entire lifetime of the case. Every stage, task, and transition condition reads from and writes to this single source of truth.
- Stages — named phases of the case (for example, Intake, Review, Settlement). Maestro Case supports primary stages (the main lifecycle) and secondary stages (exception or alternative paths).
- Rules — entry, complete, exit, and re-entry rules (WHEN / IF / ACTION) that control lifecycle movement. These rules evaluate against events and case entity data.
- Tasks — units of work inside a stage. Supported types include Human action, RPA Workflow, API Workflow, Execute Connector, AI Agent (UiPath), External Agent, Maestro Agentic Process, Child Case, Wait for Timer, and Wait for Connector Event. Every task runs in one of three execution modes: sequential, event-driven, or ad-hoc.
- SLAs and escalations — time-based expectations at case and stage levels, with configurable escalation rules for at-risk and breached states.
- Case App — a role-based, business-ready workspace where case workers and managers view cases, complete tasks, and track progress without requiring developer tools.
- Case Instance Management — an operations console where process operators monitor running instances and perform lifecycle actions (pause, resume, migrate, retry).
For detailed definitions of all constructs, refer to the Maestro Case core concepts reference.
Summary: choosing the right model
| Choose Maestro BPMN when… | Choose Maestro Case when… |
|---|---|
| The path is fixed and repeatable | The path depends on runtime decisions and data |
| Work completes in one session | Work spans days or weeks |
| Exceptions are rare | Exceptions are expected and frequent |
| One team handles the work | Multiple teams collaborate across phases |
| No rework loops are needed | Cases routinely return to earlier stages |
| Simple variable tracking suffices | A persistent case entity [Coming Soon] accumulates data over time |
| No stage-level SLA tracking required | SLA tracking and escalation are business-critical |
Next steps
- Maestro Case core concepts — reference documentation for all constructs (stages, tasks, rules, SLAs, personas).
- How to create your first case management project — step-by-step guide to building and deploying a case plan in Studio Web.
- How to configure stage transitions and re-entry — guide to modeling non-linear case flows.
- Case management tutorial: property insurance claims — end-to-end tutorial using the sample package.
- Overview
- The problem: not all work is linear
- Two orchestration models
- Maestro BPMN
- Maestro Case
- Decision framework
- When case management adds value
- Illustrative scenarios
- When case management is not required
- What makes it "agentic"
- Case Manager agent — the orchestrator
- Agent tasks — the workers
- Using both models together
- Key concepts at a glance
- Summary: choosing the right model
- Next steps