# What Are Squads

Squads are a way to **group multiple Agents** under a shared goal. Instead of having isolated Agents, you can organize them to collaborate, specialize, and delegate interactions.

#### 🔹 Key Concepts

* **Container of Agents** → A Squad groups Agents into a single unit.
* **Collaboration Modes** → Decide how Agents coordinate:
  * **Hierarchical** → one Manager orchestrates and delegates.
  * **Horizontal** → all Agents can pass conversations among themselves, with a Principal as fallback.
* **Shared Resources** → Squads can access **Tables, Knowledge Bases, and Workflows** directly.
* **Native Routing** → Handovers between Agents are seamless to the user, based on Roles and Prompts.

#### 🔹 Management Modes

* **Hierarchical Mode**:
  * One **Manager Agent** acts as the orchestrator.
  * Delegates user requests to the right specialist Agent.
  * Recommended for **structured triage** (e.g., first-line support routing to Sales, Billing, or Technical).
* **Horizontal Mode**:
  * All Agents collaborate equally.
  * A **Principal Agent** is chosen as the safety fallback.
  * Recommended for **peer-based expertise** (e.g., product, pricing, logistics).

#### 🔹 Why Use Squads?

* Organize Agents by **domain** (Support, Sales, R\&D).
* Handle **complex conversations** where multiple specialties may be needed.
* Scale gradually — start with a Manager + 2 Specialists, then expand.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zaia.app/squads/what-are-squads.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.