Skip to main content

Process Orchestration

Process Orchestration provides enterprise-grade multi-phase workflows with human-in-the-loop approvals, external participant management, and RAID-based responsibility assignment. It is designed for complex deployments that span days or weeks and involve multiple stakeholders.

Why Process Orchestration?

Complex enterprise deployments require:

  • Multi-phase execution -- Structured phases with gates and dependencies
  • Human oversight -- Customer stakeholders approve critical decisions
  • External participants -- Magic link authentication for non-users
  • RAID model -- Clear responsibility assignment
  • Team coordination -- Multiple agents working together with shared context
  • Audit trail -- Complete history of decisions and actions

Process Orchestration vs Workflows

FeatureWorkflowsProcess Orchestration
PurposeTask automationEnterprise deployments
PhasesSequential nodesNamed phases with gates
Human involvementOptional approval nodesRequired external stakeholders
ResponsibilityImplicitExplicit RAID model
Team supportSingle agent focusMulti-agent team templates
DurationMinutes to hoursDays to weeks

Core Concepts

Phases

Phases group related activities. Each phase has an order, a set of tasks, optional approval requirements, and an estimated duration. Phases can run their tasks in parallel or sequentially.

Tasks

Tasks are the atomic units of work within a phase. Each task has an assignee (agent or human), optional dependencies on other tasks, required approvals, and expected output artifacts.

Gates

Gates are checkpoints between phases. They can be:

Gate TypeDescription
ApprovalRequires human sign-off before the next phase
ConditionProceeds only if a condition is met
ManualRequires explicit manual advancement

The RAID Model

The RAID model extends RACI for AI-driven processes:

RoleDescriptionTypical Actor
ResponsibleExecutes the workAI Agent
ApproverMust approve before proceedingCustomer stakeholder
InformedNotified of progressProject managers
DelegatorCan assign work to othersInternal support

External Participants

External participants are customer stakeholders who interact via magic links -- no full platform account required. They can view process status, approve or reject requests, add comments, and upload documents, all through a secure portal.

See External Participants for details.

Best Practices

Clear Phase Boundaries

Define phases with clear entry and exit criteria. Each gate should have explicit approval requirements so nothing falls through the cracks.

Reasonable Approval Timeouts

Standard business approval: 48 hours. Urgent security decision: 4 hours with 2-hour escalation. Complex compliance review: 7 days with reminders at 24 and 72 hours.

Comprehensive Shared Context

Ensure agents have the context they need by defining thorough onboarding properties: business context (customer name, contract tier), technical context (IDP type, integrations), and deployment context (target go-live date, stakeholder contacts).

Graceful Error Handling

Handle task failures without blocking the entire process. Configure retry with escalation so that if an agent fails, the issue is surfaced to the deployment lead before the process stalls.


Next: Learn about Teams for configuring multi-agent collaboration.