| sidebar_position | 1 |
|---|---|
| title | Overview |
The Pattern Builder is a visual editor for creating orchestration patterns using a drag-and-drop interface. Build complex multi-agent workflows without writing YAML.
- Drag-and-drop interface - Create patterns visually
- Real-time YAML preview - See the generated configuration
- 15+ example patterns - Start from proven templates
- Export to YAML or Prism - Deploy anywhere
- Validation - Catch errors before deployment
flowchart LR
subgraph UI["Pattern Builder UI"]
Toolbar["Toolbar\nFile | Edit | Examples | Export | Help"]
subgraph Workspace["Workspace"]
Palette["Node Palette\nInput | Agent | Vote | Output"]
subgraph Canvas["Canvas"]
In["Input"] --> Agent["Agent"] --> Vote["Vote"] --> Out["Output"]
end
Preview["YAML Preview\nname: ...\nversion: ...\ninput: ..."]
end
end
Palette --> Canvas
Canvas --> Preview
Navigate to builder.parallaxai.dev or click "Pattern Builder" in the navigation.
Click Examples in the toolbar and select a template:
| Example | Description |
|---|---|
| Multi-Agent Voting | Basic voting pattern |
| Quality-Gated Analysis | Consensus with retry |
| Entity Extraction | Merge-based extraction |
| Translation Verification | Back-translation pattern |
| Prompt A/B Testing | Compare prompt variants |
- Drag an Input node onto the canvas
- Drag an Agent node and connect it to the input
- Add aggregation (Vote, Consensus, or Merge)
- Add an Output node
- Configure each node in the properties panel
Click any node to edit its properties:
- Input Node: Define input fields and types
- Agent Node: Set capabilities and count
- Aggregation Nodes: Configure strategy and thresholds
- Output Node: Map result variables
The YAML preview updates in real-time. When ready:
- Click Export
- Choose format (YAML or Prism)
- Copy or download the configuration
| Shortcut | Action |
|---|---|
Cmd/Ctrl + S |
Save pattern |
Cmd/Ctrl + Z |
Undo |
Cmd/Ctrl + Shift + Z |
Redo |
Delete / Backspace |
Delete selected |
Cmd/Ctrl + D |
Duplicate selected |
Cmd/Ctrl + A |
Select all |
Space + Drag |
Pan canvas |
Scroll |
Zoom in/out |
F |
Fit to screen |
- Pan: Hold
Spaceand drag, or use scroll wheel + Shift - Zoom: Scroll wheel, or use zoom controls in toolbar
- Fit: Press
For click "Fit" button
- Single: Click a node
- Multiple: Cmd/Ctrl + Click, or drag selection box
- All: Cmd/Ctrl + A
- Move: Drag selected nodes
- Connect: Drag from output handle to input handle
- Delete: Select and press Delete
- Duplicate: Cmd/Ctrl + D
Begin with the simplest pattern that could work:
- Input → Agent → Output
- Test it works
- Add aggregation
- Add validation
- Add complexity as needed
The example patterns demonstrate best practices:
- Proper node connections
- Appropriate aggregation strategies
- Quality gate placement
- Output variable mapping
The builder shows validation errors:
- Red border: Missing required configuration
- Warning icon: Potential issues
- Error panel: Detailed error messages
Export and test your pattern at each stage:
# Test locally
parallax pattern validate my-pattern.yaml
# Dry run
parallax pattern execute my-pattern.yaml --dry-run- Drag Input node to canvas
- Click to select
- Add field:
contentwith typestring
- Drag Agent node to canvas
- Connect Input → Agent
- Configure:
- Capabilities:
classification - Min agents:
3
- Capabilities:
- Drag Vote node to canvas
- Connect Agent → Vote
- Configure:
- Method:
majority - Min votes:
2
- Method:
- Drag Output node to canvas
- Connect Vote → Output
- Map variables:
category:$vote.resultconfidence:$vote.confidence
- Click Export → YAML
- Copy the generated YAML:
name: content-classifier
version: 1.0.0
input:
content: string
agents:
capabilities: [classification]
min: 3
execution:
strategy: parallel
aggregation:
strategy: voting
method: majority
minVotes: 2
output:
category: $vote.result
confidence: $vote.confidence- Verify compatible types (output → input)
- Check that the source node has an output handle
- Ensure the target node has an input handle
- Ensure at least Input and Output nodes exist
- Check for validation errors
- Verify all required fields are configured
- Read error messages in the error panel
- Check required node configurations
- Ensure all connections are complete
- Nodes - Detailed node reference
- Connections - Connection rules
- Exporting - Export formats and options