Criando Squads

Este guia se concentra nas etapas práticas e ações de gerenciamento envolvidas na criação e manutenção de Squads dentro da Zaia Endless.

Se você está buscando explicações conceituais sobre o que são Squads e quando usar cada modo, consulte o artigo anterior.

---

Etapa 1: Criar um Squad

1. Vá em Builder → Squads
2. Clique em New Squad
3. Escolha um Management Mode:
   • Hierarchical
   • Horizontal
4. Defina um Name
5. Opcionalmente adicione uma Description (uso interno, até 1000 caracteres)
6. Atribua:
   • um Manager (modo Hierarchical), ou
   • um Principal Agente (modo Horizontal)
7. Salve o Squad

---

Etapa 2: Adicionar Agentes ao Squad

Depois que o Squad é criado, você pode adicionar Agentes de duas formas:

• Vincular um Agente existente
  Use o ícone de link para anexar um Agente ao Squad.
• Criar um novo Agente
  Use o botão + para criar um novo Agente que é automaticamente vinculado ao Squad.

Cada Squad pode conter múltiplos Agentes, mas apenas um Manager ou Principal por vez.

---

Promovendo um Agente a Manager / Principal

Você pode trocar a liderança a qualquer momento.

• Na lista de Agentes do Squad, abra o menu de opções do Agente
• Selecione Promote to Manager (ou Principal)
• O Manager/Principal anterior é substituído automaticamente

Isso é útil quando:

• Reorganizando responsabilidades
• Testando diferentes estratégias de orquestração
• Iterando sobre o comportamento do Squad sem recriá-lo

---

Copiando o Squad ID

Cada Squad possui um identificador único.

• Abra o menu de opções do Squad
• Clique em Copy ID

O Squad ID é útil para:

• Inspeção avançada e depuração
• Interações baseadas em API
• Referenciar Squads em sistemas externos ou logs

💡 Dica: Mantenha o Squad ID à mão ao trabalhar com APIs ou diagnósticos internos.

---

Gerenciando Squads ao Longo do Tempo

Boas práticas para gerenciamento contínuo:

• Mantenha as descrições do Squad atualizadas para refletir seu propósito real
• Evite adicionar Agentes sem uma função clara
• Revise regularmente quem atua como Manager/Principal
• Prefira Squads pequenos com responsabilidades claras