Guides
Start typing to search…

How to create and manage a multi-agent

Before you start

  • Multi-Agents must be enabled on your account (Enterprise plan). If you do not see the Multi-Agent option on the Create page, contact your account manager.
  • You need at least one existing agent to attach as a child agent (you can also add agents after the multi-agent is created).
  • Only team members with edit access to agents can attach or detach child agents.

Create a multi-agent

  1. Click New agent.
New agent button on the ledt side pane of customgpt dashboard
  1. In the Most Popular section, click Multi-Agent. It is also available in the Connectors section at the end of the Build page.
Multi-agent card on the pick data soucres for your agent page
  1. In the pop-up window, select the agents you want to attach as child agents.
Pop-up window with a selection of agents to add to the Master agent
  1. Click Create Multi-agent.
Create multi-agent button on the pop-up window
🚧

If Multi-Agents is not enabled, clicking Multi-Agent opens an upsell prompt. Contact Sales to enable it.

You cannot chat with a multi-agent until at least one child agent is attached.

Add child agents to an existing multi-agent

  1. On your multi-agent, click the three vertical dots.
  1. In the dropdown, click Build.
Build option in the dropdown on the master agents
  1. Click Add agents.
Add agents button on the build multi-agents page
  1. In the pop-up, select the agents you want to add. Agents already attached to this multi-agent are hidden from the list.
Agent selection to add to master agent
  1. Click Create Multi-Agent to confirm your selection.
Create multi-agent button on the add agents to the multi-agent pop-up window
🚧

Each multi-agent supports up to 10 child agents. To raise this limit, contact Sales.

If a child agent is set to private, it will not appear in the end-user dropdown when the multi-agent is deployed publicly. Only agents set to public are visible to end-users.

Remove a child agent

  1. On your multi-agent, click the three vertical dots
3 vertical dots on the master agent
  1. In the dropdown, click Build.
Build option in the dropdown of master agent
  1. Find the child agent in the table and click on the bin icon to remove from multi-agent.
Bin icon on the build multi-agent page

Removing an agent detaches it from the multi-agent but does not delete it. It can still be deployed independently or added to another multi-agent.

Edit a child agent's settings

  1. On your multi-agent, click the three vertical dots
3 vertical dots on the master agent
  1. In the dropdown, click Build.
Build option in the dropdown of master agent
  1. Click the gear icon next to a child agent to configure the child agent.
Configure agent option on a child agent to personalize

This opens the child's Personalize page where you can adjust its persona, intelligence, data sources, and tools.

Personaize page of child agent

Adjust multi-agent settings

  1. On your multi-agent, click Personalize.
Personalize button on the master agent
  1. Select the tab you want to configure: General, Conversation, Citations, Advanced, or Security.
Personalize options for master agent
  1. Make your changes and click Save Settings.
save settings button on master agent's personalize page

Settings here control the look and feel of the chat interface across all agents. AI behavior (persona, intelligence, data sources) is configured on each agent individually - these settings don't appear on the multi-agent.

Deploy a multi-agent

Go to Deploy on your multi-agent. Supported: Share Link, Embed, Live Chat, Website Copilot, and Instant Viewer.

Deploy button on master agent
🚧

API and MCP deployment are not available on multi-agent. Child agents retain their own API and MCP access.

If you already have agents deployed separately

Attaching existing agents to a multi-agent doesn't remove or change their current deployments. Once you've set up the multi-agent, decide what to do with the existing standalone links:

  • Keep both running - end-users can still access individual agents directly and through the multi-agent. Useful if some users need a specific agent without the selector.
  • Swap with multi-agent - replace existing share links or embed codes with the multi-agent's deployment link. Use this if you want all users to go through the unified interface.
📘

There is no automatic redirect from individual agent links to the multi-agent. You need to update links manually.

Related articles


Updated about 2 hours ago