Skip to main content
Agency in Agency Swarm is a collection of agents that can collaborate with one another.

​
Benefits of Using an Agency

Utilizing an Agency consisting of multiple agents offers several benefits:

Fewer Hallucinations

Agents within an agency can supervise each other, reducing mistakes and handling unexpected scenarios more effectively.

Complex Tasks

Adding more agents allows for longer sequences of actions, enabling the completion of more complex tasks before delivering results to the user.

Scalability

Agencies allow you to scale your solutions seamlessly by adding more agents, as the complexity of your system grows.
Start with a minimal number of agents. Fine-tune them to ensure they function correctly before adding more. Introducing too many agents initially can make debugging and understanding interactions challenging.
In the latest version, the Agency class orchestrates a collection of Agent instances based on a defined structure. It provides enhanced thread management, persistence hooks, and improved communication patterns between agents.

​
Agency Parameters

Overview of parameters in the new Agency class:
NameParameterDescription
Entry Points*entry_points_argsPositional arguments representing Agent instances that serve as entry points for external interaction. These agents can be directly messaged by users.
Communication Flows (optional)communication_flowsList of (sender, receiver) tuples defining allowed agent-to-agent message paths. Example: [(ceo, dev), (ceo, va)]. Default: None
Name (optional)nameA name for the agency instance. Default: None
Shared Instructions (optional)shared_instructionsInstructions prepended to all agents’ system prompts in a string format or a path to markdown file. Default: None
Send Message Tool Class (optional)send_message_tool_classFallback SendMessage tool class when a communication_flows entry does not specify its own tool. Prefer configuring SendMessage variants directly through communication_flows. Default: None
Load Threads Callback (optional)load_threads_callbackA callable to load conversation threads for persistence. Default: None
Save Threads Callback (optional)save_threads_callbackA callable to save conversation threads for persistence. Default: None
User Context (optional)user_contextInitial shared context accessible to all agents during runs. Default: None

​
Example

Quick example of how to create an agency with 3 agents using the new structure: 
from agency_swarm import Agency
from .ceo import CEO
from .developer import Developer
from .virtual_assistant import VirtualAssistant

ceo = CEO()
dev = Developer()
va = VirtualAssistant()

# New structure: entry points as positional args, communication flows as keyword arg
agency = Agency(
    ceo, dev,  # Entry points - these agents can interact with users
    communication_flows=[
        (ceo, dev),  # CEO can initiate communication with Developer
        (ceo, va),   # CEO can initiate communication with Virtual Assistant
        (dev, va)    # Developer can initiate communication with Virtual Assistant
    ],
    shared_instructions="./shared_instructions.md",
    user_context={"project_type": "web_application"}
)

​
Next Steps

Make sure to learn more about Communication Flows and Running an Agency.