> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatzy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

### What Are Squads?

A **Squad** is a team of multiple Conversational AI Agents that work together to handle complex workflows and multi-step processes.\
Instead of relying on a single generalist agent, a Squad divides tasks among specialized agents each with its own role, expertise, and knowledge base, ensuring faster, more accurate, and scalable automation.

### Best For

* Multi-stage customer workflows (lead → booking → support)
* Departmental automation (sales, support, operations)
* Escalation and handoff between specialized agents
* AI-driven collaboration for context-rich conversations

### Key Strengths

* **Collaborative Intelligence:** Multiple agents coordinate to complete end-to-end workflows.
* **Role-Based Specialization:** Each agent focuses on a defined domain - e.g., Lead Qualification, Booking, Support.
* **Shared conversation history:** When the conversation is getting transfered between persitent agents, they share the conversation history.

***

If your workflow is large and involves multiple API calls, there’s a good chance users may ask questions that fall outside the responsibility of the current agent. In such cases, **Squad** is an ideal solution.

For example, imagine you run a car-rental business with an AI **Sales** agent that handles pricing, introductions, and general sales queries, and a separate **Service** agent that manages billing and onboarding. If, during onboarding, the user suddenly asks to change the car, the conversation needs to be handed back to the Sales agent. **Squad automatically manages this kind of agent handoff**, ensuring the user is always routed to the right agent without manual intervention.

### Squad Architectures

You can choose from the following multi-agent architectures, depending on your use case and workflow design

**Network**

<Frame>
  <img src="https://mintcdn.com/chatzyai/JwGa80Xm1UIls5vs/ai-agents/squads/squad1.png?fit=max&auto=format&n=JwGa80Xm1UIls5vs&q=85&s=1335c74c5f9ccc9acb8741d89bb20a2d" width="1410" height="791" data-path="ai-agents/squads/squad1.png" />
</Frame>

***

**Supervisor**

<Frame>
  <img src="https://mintcdn.com/chatzyai/JwGa80Xm1UIls5vs/ai-agents/squads/squad3.png?fit=max&auto=format&n=JwGa80Xm1UIls5vs&q=85&s=2c589101711f58b1bc6da0449e3d5c24" width="1367" height="766" data-path="ai-agents/squads/squad3.png" />
</Frame>

***

**Custom**

<Frame>
  <img src="https://mintcdn.com/chatzyai/JwGa80Xm1UIls5vs/ai-agents/squads/squad2.png?fit=max&auto=format&n=JwGa80Xm1UIls5vs&q=85&s=52553d57dc48b3dbdde7373a69abe8eb" width="1302" height="570" data-path="ai-agents/squads/squad2.png" />
</Frame>

| **Architecture** | **Description**                                                                                                 |
| ---------------- | --------------------------------------------------------------------------------------------------------------- |
| **Network**      | All agents communicate freely with each other, ideal for collaborative brainstorming or multi-domain reasoning. |
| **Supervisor**   | A central controller agent assigns tasks to others and consolidates results, ensuring structured flow.          |
| **Custom**       | Build your own connection graph between agents to match unique process logic and data flow.                     |

***

<Card title="Create a Squad" icon="users" href="https://app.chatzy.ai/squads">
  Build your first Squad and enable collaborative AI workflows.
</Card>

***

Before creating the Squad, you must properly configure all the required Conversational AI agents and clearly specify in their prompts the conditions under which a conversation should be transferred from one agent to another. For example:

<Columns cols={2}>
  <Frame>
    <img src="https://mintcdn.com/chatzyai/JwGa80Xm1UIls5vs/ai-agents/squads/prompt1.png?fit=max&auto=format&n=JwGa80Xm1UIls5vs&q=85&s=38cda734f98592f8e7e9201aed902f6a" alt="Inbound Webhook Setup" className="rounded-lg" width="1214" height="697" data-path="ai-agents/squads/prompt1.png" />
  </Frame>

  <Frame>
    <img src="https://mintcdn.com/chatzyai/JwGa80Xm1UIls5vs/ai-agents/squads/prompt2.png?fit=max&auto=format&n=JwGa80Xm1UIls5vs&q=85&s=03ea93bba65cdf00cc397a0b3ea65ac3" alt="Webhook Mapping" className="rounded-lg" width="1310" height="704" data-path="ai-agents/squads/prompt2.png" />
  </Frame>
</Columns>

In both the Sales and Support AI agents, the prompts include the conditions that determine when the conversation should be handed off to the other agent.

***

Once you create a Squad, you’ll see the following screen:

<Frame>
  <img src="https://mintcdn.com/chatzyai/aFP56ESnfLOdqUzW/ai-agents/squads/overview.png?fit=max&auto=format&n=aFP56ESnfLOdqUzW&q=85&s=f1efc8d88b3905b9024f1f215971de64" width="1701" height="999" data-path="ai-agents/squads/overview.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/chatzyai/aFP56ESnfLOdqUzW/ai-agents/squads/overview2.png?fit=max&auto=format&n=aFP56ESnfLOdqUzW&q=85&s=28a39e7194e90251e0279194b25b13f4" width="1671" height="991" data-path="ai-agents/squads/overview2.png" />
</Frame>
