# Creating Squads

This guide focuses on the **practical steps and management actions** involved in creating and maintaining Squads inside Zaia Endless.

If you’re looking for conceptual explanations about what Squads are and when to use each mode, refer to the previous article.

***

### Step 1: Create a Squad

1. Go to **Builder → Squads**
2. Click **New Squad**
3. Choose a **Management Mode**:
   * **Hierarchical**
   * **Horizontal**
4. Define a **Name**
5. Optionally add a **Description** (internal use, up to 1000 characters)
6. Assign:
   * a **Manager** (Hierarchical mode), or
   * a **Principal Agent** (Horizontal mode)
7. Save the Squad

***

### Step 2: Add Agents to the Squad

Once the Squad is created, you can add Agents in two ways:

* **Link an existing Agent**\
  Use the *link* icon to attach an Agent to the Squad.
* **Create a new Agent**\
  Use the **+** button to create a new Agent that is automatically linked to the Squad.

Each Squad can contain multiple Agents, but only **one Manager or Principal** at a time.

***

### Promoting an Agent to Manager / Principal

You can change leadership at any time.

* In the Squad’s **Agents list**, open the Agent’s options menu
* Select **Promote to Manager** (or Principal)
* The previous Manager/Principal is replaced automatically

This is useful when:

* Reorganizing responsibilities
* Testing different orchestration strategies
* Iterating on Squad behavior without recreating it

***

### Copying the Squad ID

Each Squad has a unique identifier.

* Open the Squad’s options menu
* Click **Copy ID**

The **Squad ID** is useful for:

* Advanced inspection and debugging
* API-based interactions
* Referencing Squads in external systems or logs

> 💡 Tip: Keep the Squad ID handy when working with APIs or internal diagnostics.

***

### Managing Squads Over Time

Best practices for ongoing management:

* Keep Squad descriptions updated to reflect their real purpose
* Avoid adding Agents without a clear role
* Regularly review who acts as Manager/Principal
* Prefer **small Squads** with clear responsibilities


---

# 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/creating-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.