Build

Playground

Compose multiple agents into a swarm, choose how they collaborate, and watch them talk to each other.

Swarm

Name

Type

Agents run one after another; each builds on the previous output.

Task

Rules (optional)

Image URL (optional)Sent as the top-level img field. Use a publicly reachable URL.

Max loops

Agents

#1claude-sonnet-5

#2claude-sonnet-5

Add a task to run the swarm.

Nothing yet

Configure the swarm and your agents on the left, then click Run swarm to see them collaborate.

Request preview

POST /v1/swarm/completions

curl -X POST 'https://api.swarms.world/v1/swarm/completions' \
  -H 'x-api-key: '"$SWARMS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Untitled Swarm",
  "swarm_type": "SequentialWorkflow",
  "max_loops": 1,
  "agents": [
    {
      "agent_name": "Researcher",
      "model_name": "claude-sonnet-5",
      "role": "worker",
      "system_prompt": "You research the topic deeply and provide structured findings.",
      "temperature": 0.7,
      "max_loops": 1,
      "max_tokens": 8192
    },
    {
      "agent_name": "Writer",
      "model_name": "claude-sonnet-5",
      "role": "worker",
      "system_prompt": "You take the research and craft a clear, well-structured response.",
      "temperature": 0.7,
      "max_loops": 1,
      "max_tokens": 8192
    }
  ]
}'