Builder tour
By the end of this page you will know where every router setting lives, and how saving, publishing and deploying relate to each other.
Prerequisites
- A system created (Create a MAS).
- Admin or Developer role.
The builder at a glance
The router builder is a full-screen editor with three panes. Drag the dividers to resize them.
| Pane | What’s in it |
|---|---|
| Left | The configuration panel. Its contents change with the pill you select on the router card. |
| Centre | The router card (a summary plus the mode pills) and Connected Agents below it. |
| Right | The live chat preview. |
The header
From left to right:
- Back — returns to the Agent Systems list.
- Configure Router, with the system name beneath it.
- Badges — a MAS badge, plus version state: New (nothing saved yet),
v2 • DRAFT(an unpublished draft), Prod: v1 (the live published version), and Unsaved whenever you have pending changes. - The chat preview toggle (Show Chat Preview / Hide Chat Preview).
- Save, Publish, Deploy, and — once a draft exists over a published version — an overflow ⋮ menu with Discard Draft.
Each action unlocks the next one:
| Action | Enabled when | Tooltip when disabled |
|---|---|---|
| Save | You have unsaved changes | — |
| Publish | Everything is saved and a draft version exists | ”Save changes before publishing” / “Save first to create a version” |
| Deploy | A published production version exists | ”Publish a production version first” |
The router card and its pills
The router card sits at the top of the centre pane. It shows the router name (or Untitled Router until you set one) and a summary of the current Default action, Handoff behaviour, and LLM Config.
Its two pills drive the left panel:
| Pill | Left panel shows |
|---|---|
| Config | System Name, Router Name, Default Action and Handoff, and the collapsible LLM Configuration section. |
| Router Prompt | The Router Prompt editor, with AI Assist. |
Connected Agents
Below the card, Connected Agents (N) lists the specialists, each on its own card with its skills, few-shot overrides, and chat-display settings. Add Agent opens the picker. See Connect agents.
The chat preview
The right pane is a live chat against the current configuration, headed Agent Preview. Until the system has been saved once it shows “Save the router to enable preview.”
The preview reflects your saved configuration, not your unsaved edits — save before testing a change. See Test the MAS for the full workflow.
Saving
Everything in the builder is staged locally — including adding and removing agents. Nothing reaches the server until you click Save.
Save writes the whole configuration in one step: the router settings and the member list together. It creates a draft version, or updates the existing draft. On success you get the toast “Router configuration saved” and the Unsaved badge clears.
Publishing that draft is a separate step — see Publish.
Common issues
- Save does nothing — There are no pending changes; the button is disabled unless the Unsaved badge is showing.
- The preview ignores my change — The preview runs the saved configuration. Save, then send a new message.
- The preview says “Save the router to enable preview.” — The system has never been saved. Click Save.
- The system name changed everywhere — The System Name field in the Config panel updates both the internal name and the display name when you save. Rename deliberately if anything already calls the system by name.
Next
- Connect agents — add your specialists.