Creating and Running a Swarm Workflow
Build multi-agent workflows on the Swarm Canvas, connect nodes, auto-save, and deploy to production.
The Swarm Canvas is FuseIQ's visual workflow builder for multi-agent pipelines. Use the left Arsenal to drag nodes, connect edges, add Custom Connector or Code Step nodes, configure triggers, and orchestrate production runs — with cloud auto-save and browser backup.
1. Open the Swarm Canvas
Navigate to Swarm Canvas from the sidebar. You'll see an empty canvas with the Arsenal toolbox on the left.
2. Node Arsenal — core node types
The Arsenal groups agents, actions, triggers, integrations, and control nodes. Common types:
- Source Node — The entry point that receives initial input
- Processing Node — Transforms or analyzes data using an agent
- Output Node — Produces the final result or triggers an action
- Decision Node — Branches the workflow based on conditions
- Delay Node — Introduces a timed pause in the workflow
- Approval Node — Pauses execution pending human approval
3. Connecting Nodes
Connect nodes by dragging from the golden handle on one node to a port on another. Each connection creates a data edge between nodes. Edges feature quantum conduitvisual effects — animated particles flow along the connection line, giving you real-time visibility into data movement.
4. Configure Triggers
Every workflow needs a trigger. Click the trigger node to configure:
- Webhook — External API call starts the workflow
- Schedule — Cron-based recurring execution
- Event — FuseIQ internal event (agent status change, approval outcome, etc.)
- Manual — Triggered from the Ops Kanban board
5. Simulation Mode
Before deploying, run a simulation to test your workflow:
6. Approval Gates
Add approval gates to your workflow by inserting an Approval Node. When execution reaches the gate, the workflow pauses and a pending approval request appears in the Approvals dashboard. Execution continues only after approval.
7. Cloud save & browser backup
Edits auto-save to the cloud (⌘S / Ctrl+S also works). The server stores a definition blob plus nodes/edges. If the network fails, a local snapshot stays under fuseiq_swarm_autosave so work is not lost.
8. Long runs & time-budget checkpoints
Serverless runs are capped (~300s). Large graphs pause near the limit into an Approvals checkpoint — approve/resume to continue instead of a hard timeout kill. Multi-minute factory graphs are supported this way.
9. Custom Connector & Code Step
From the Arsenal, add a Custom Connector (any HTTP/curl-style call) or a sandboxed Code Step for light transforms — n8n-class flexibility without leaving Swarm. See Custom Connector & Code Step.
10. Run History
Every workflow execution is recorded in Run History / Executions. Each entry shows:
- Execution timestamp and duration
- Per-node input/output snapshots
- Cost breakdown per node
- Latency metrics
- Error logs (if any)
8. Export and Deploy
Keyboard Shortcuts
Speed up your canvas work with these shortcuts:
- Space + Drag — Pan the canvas
- Delete — Remove selected node
- Ctrl/Cmd + D — Duplicate selected node
- Ctrl/Cmd + A — Select all nodes
- Ctrl/Cmd + Z — Undo
- F — Fit view to canvas
- T — Compact view
- 1/2/3 — Zoom presets
- Esc — Deselect all
- ⌘K — Command palette