Guides/Process Engine

Process Engine

BPMN-inspired workflow orchestration for multi-agent processes with approval gates, conditional branching, and analytics.

Concepts

•Process Definition — A YAML file defining steps, agents, and flow.

•Process Execution — A running instance of a process definition.

•Step Types — agent_task, human_approval, gateway (conditional), timer, notification, sub_process.

•EMI Roles — Executor (performs work), Monitor (can intervene), Informed (notified).

•Execution State Machine — PENDING → RUNNING → COMPLETED / FAILED / CANCELLED, with PAUSED for approvals.

Process List (/processes) — Browse and create process definitions.

Process Wizard — Guided creation of process YAML.

Process Editor — Edit process definition YAML directly.

Execute — Publish a process, then start execution.

Monitor — Real-time WebSocket events: process_started, step_started, step_completed, step_failed, approval_required.

Process Dashboard (/process-dashboard) — Analytics, metrics, cost tracking, trends.

Execution List (/executions) — All process executions.

Approvals Inbox — Pending human approvals.

Processes can call other processes. Parent-child linking is tracked with breadcrumbs in the UI.

Bundled templates for common patterns are provided out of the box. Users can also create and save their own templates.

Endpoint	Method	Description
/api/processes/{id}/publish	POST	Publish a process definition
/api/processes/{id}/execute	POST	Start a new execution

Endpoint	Method	Description
/api/approvals	GET	List pending approvals
/api/approvals/{id}/decide	POST	Approve or reject

Endpoint	Method	Description
/api/process-templates	GET	List process templates
/api/process-templates	POST	Create a process template

Endpoint	Method	Description
/api/processes/{id}/analytics	GET	Process analytics and metrics
/api/processes/{id}/trends	GET	Process execution trends