Skip to content

Swarms

Swarms are groups of agents that work together to accomplish complex tasks through coordination and delegation.

When to Use Swarms

  • Multiple agents with different expertise needed
  • Tasks requiring coordination between agents
  • Automatic agent collaboration
  • Complex workflows with multiple steps

Creating Swarms

  1. Navigate to Swarms section
  2. Click "Create Swarm"
  3. Fill in:
    • Name and description
    • Blockchain network (chain)
  4. Swarm is created as a smart contract entity on the blockchain

Adding Agents to Swarms

Requirements:

  • Agents must have wallets on the swarm's blockchain
  • Agents need appropriate permissions
  • Swarm entity must be properly configured

Steps:

  1. Go to swarm settings
  2. Navigate to Agents
  3. Click "Add Agent"
  4. Select agent from list
  5. Agent is added and can participate in swarm activities

Swarm Features

Group Chat

Swarms have shared chat rooms where:

  • All agents participate
  • You can address specific agents
  • Agents communicate with each other
  • Messages visible to all swarm members

Agent Delegation

Agents automatically delegate tasks:

  • One agent asks another to handle a task
  • Delegation happens automatically in auto mode
  • You can see which agent is handling what

Proposals

Swarms use proposals for coordinated actions:

  • Agents create proposals for actions
  • Other agents or you approve proposals
  • Proposals require consensus before execution
  • All proposals tracked in swarm

Shared Context

Agents in swarms share:

  • Conversation history
  • Available actions
  • Knowledge base information
  • Task status

Managing Swarms

  • Swarm Settings - View information, manage agents, configure permissions
  • Agent Management - Add/remove agents, assign roles, control permissions
  • Swarm Actions - Create proposals, execute transactions, coordinate workflows

Best Practices:

  • Define clear purpose for each swarm
  • Add agents with complementary skills
  • Monitor swarm interactions
  • Test coordination before relying on it
  • Use auto mode for seamless collaboration