Add Stages
Create and order stages in a workflow. Each stage represents a discrete task that one or more agents execute sequentially.
Prerequisites
- An existing workflow assigned to a team (see Create a Workflow)
Steps
1. Open the workflow
Navigate to your project, then open the workflow. You see the three-tab layout: Visual, Stages, and Runs & Triggers.
2. Switch to the Stages tab
Click the Stages tab to see the card-based stage management view. This is the easiest way to create and configure stages.
3. Add a new stage
Click Add Stage. A new stage card appears with default values. Click the card to open the edit drawer.
4. Configure the stage
The stage edit drawer has four tabs:
Main tab:
- Name -- A descriptive name for the stage (e.g., "Research", "Draft Content", "Review")
- Description -- What this stage accomplishes
- Summary Mode -- How the stage's output is summarized for downstream stages (
full,condensed, ornone) - Runtime -- Which runtime environment to use (if the stage needs code execution)
- Capture Protocol -- How agent outputs are captured and stored
- Max Cycles -- Maximum number of agent interaction cycles before the stage terminates
Summary Mode controls what information downstream stages receive. Use full when the next stage needs complete context, condensed for a compressed summary, or none if the output is only used via explicit data passing.
5. Set the stage order
Stages execute in the order defined by their position field. The first stage (position 0) receives the workflow's initial input. Each subsequent stage receives the previous stage's output.
In the Stages tab, stages appear in position order. Reorder them by updating the position values.
6. Add multiple stages
Repeat steps 3-5 for each stage in your workflow. A typical workflow has 2-5 stages, but there is no hard limit.
Example stage sequence for a content pipeline:
| Position | Name | Purpose |
|---|---|---|
| 0 | Research | Gather information from web sources |
| 1 | Draft | Write initial content based on research |
| 2 | Review | Quality check and fact verification |
| 3 | Publish | Format and deliver final content |
7. View stages in the Visual Builder
Switch to the Visual tab to see stages rendered as a vertical flow diagram. Each stage appears as a numbered card with:
- A colored header bar with the stage name and number badge
- Agent assignment ports along the top edge
- Flow connector dots linking to the next stage
- Diamond indicators on the edges if hooks are configured
8. Configure stage settings via the Visual Builder
Click any stage node in the canvas to open the stage edit drawer. The same four-tab form is available (Main, Routing, Hooks, Assignments).
What's next
- Set Up Assignments to assign agents to each stage
- Configure Hooks to add entry and exit hooks
- Use Outcome Routing to add branching logic