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