Skip to main content

Create a swarm

Create a swarm to combine several agents and get one report from their work.

Before you start​

You need at least two active agents. See Agents.

Steps​

  1. On the Swarm Builder screen, select Create Swarm. The Create New Swarm page opens.
  2. In Swarm Name, enter a name of up to 100 characters.
  3. In Description, optionally describe what the swarm does, in up to 500 characters.
  4. In Instructions, optionally enter a directive for the final report, such as the sections it needs, its tone, or how to show where agents disagree. You can enter up to 4,000 characters.
  5. Under Select Agents, select between two and five agents. Use Filter agents in the active tab to find an agent. Selected shows how many you have picked.
  6. Select Create Swarm.

Select Cancel or Back to Swarms to leave without saving.

What happens next​

The message Swarm "name" created. appears, and the swarm appears in the list.

Troubleshooting​

If the form shows Fix the highlighted fields and try again., correct the fields marked in red:

MessageFix
Swarm name is requiredEnter a Swarm Name.
Name must be 100 characters or fewerShorten the name.
Description must be 500 characters or fewerShorten the description.
Pick at least two agents (LLM and / or master)Select at least two agents.
A swarm can have at most 5 agentsRemove agents until you have five or fewer.
  • Limit reached — deselect an agent to add another. you have five agents selected. Deselect one before you add another.
  • No active LLM agents available. Create one in Agent Studio first. create an agent first. See Create an agent.