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