Overview
Workflows let you wire sub-agents into a directed graph that runs multi-step work deterministically — fan out tasks, evaluate results, loop on revisions, and pause for human input. Build and edit them visually in Settings → Extensions → Workflows.Node Kinds
| Node | What it does |
|---|---|
| Worker | Runs an agent to perform a task. No verdict — it just hands off to the next node. |
| Evaluator | Runs an agent that emits a verdict (pass or revise) the engine routes on. |
| Join | A convergence point: runs once after all incoming branches complete, aggregating their outputs. |
| Manager | A router: picks one outgoing node to run next. |
Edges & Routing
Edges connect nodes and carry a condition:| Condition | When it’s taken |
|---|---|
| Always | Unconditional handoff (typical for workers) |
| Pass | When the source evaluator returns pass |
| Revise | When the source evaluator returns revise |
Deterministic Checks
A node can run a tool check — a named tool (for example,test_app) that must succeed for the node to pass. If the tool errors, the check fails. This grounds a workflow in real signals like a passing build or test run, not just model opinion.
Breakpoints (Human-in-the-loop)
| Breakpoint | Behavior |
|---|---|
| Before run | Pause before a node runs — review or edit the task, skip it, or abort |
| After verdict | Pause after an evaluator’s verdict — accept it, override it, or abort |
Building & Running
Create a workflow
In Settings → Extensions → Workflows, add nodes (workers, evaluators, joins, managers) and connect them with edges.
Add checks and breakpoints
Attach deterministic tool checks where you need hard gates, and breakpoints where you want to steer.
Run it
Start the workflow from the context picker in chat. It executes the graph and reports progress.
Related
Sub-agents
The agents that power workflow nodes.
Tools
Deterministic checks call the same tools the agent uses.