Create a MAS

By the end of this page you will have created a Multi-Agent System and arrived in the router builder, ready to connect agents.

Prerequisites

Starter Starter plan or above.
Admin or Developer role.
At least two AI Agents in the project, each Active and each with skills. See Create an AI Agent and Skills.

ℹ️

Member agents don’t need to be published to be added to a system — only to be deployed with it. You can build and test a system against active agents, then publish them before you ship.

The MAS Systems list

Open Agentic Workspace → MAS Systems in the project sidebar. The screen is titled Agent Systems and lists every system in the project: name, short ID, pattern, state, member count, and when it was last modified.

You can search by name or description, filter by state (Draft, Ready, Published), sort, and page through the results. Each card opens the builder, and carries edit and delete actions if your role allows them.

The Agent Systems list showing a Conversation Router card with its state, pattern, and member count

Create the system

Click New System

The form is titled Create Agent System, with Conversation Router shown beneath it. A banner confirms the pattern: “Route requests to specialized agents based on intent. You’ll configure agents and routing after creation.”

Every system uses the Conversation Router pattern, so there’s nothing to choose here.

The Create Agent System form with the Conversation Router banner, System Name, Display Name, Description, and Tags fields

Fill in the details

Field	Notes
System Name (required)	At least 2 characters. Lowercase with hyphens — it’s used in API calls. Spaces are converted to hyphens for you.
Display Name	The human-readable name shown in the UI. Defaults to the System Name.
Description	What this system does. Shown on the list card and searchable.
Tags	Type a tag and click Add. Tags are lowercased; remove one with its ×.

Click Create System

Create System stays disabled until the name is long enough. On success you see the toast “System Created” and land straight in the router builder.

The system starts with no members and no version. Nothing is published yet.

Common issues

Create System stays greyed out — The System Name is shorter than 2 characters.
“Failed to create system” — Usually a duplicate name within the project. Try a different name.
MAS Systems isn’t in the sidebar — The section is hidden on the Free plan, and creating or editing systems requires the Admin or Developer role.

Builder tour — find your way around the router builder.