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 uma Squad

Vá em Builder → Squads
Clique em Nova Squad
Escolha o Modo de gestão:
- Modo hierárquico
- Modo horizontal
Defina um Nome
Opcionalmente adicione uma Descrição
Em Agente responsável pela Squad, escolha:
- um Gerente (modo hierárquico), ou
- um Principal (modo horizontal)
Clique em Criar Squad

Etapa 2: Adicionar Agentes à Squad

Depois que a Squad é criada, você pode adicionar Agentes de duas formas:

Vincular um Agente existente
Use o ícone de link para anexar um Agente à Squad. O diálogo é Vincular Agente a uma Squad; confirme com Vincular.
Criar um novo Agente
Use o botão + para criar um novo Agente que é automaticamente vinculado à Squad.

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

Promovendo um Agente a Gerente / Principal

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

Na lista Agentes da Squad, abra o menu de opções do Agente
Selecione Promover para Gerente (no modo hierárquico) ou Promover a Principal (no modo horizontal)
O Gerente/Principal anterior é substituído automaticamente

Isso é útil quando:

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

Desvincular um Agente da Squad

Use Desvincular quando um especialista não deve mais atender as conversas daquela Squad.

Vá em Builder → Squads e abra a Squad
Na lista Agentes, abra o menu do Agente
Clique em Desvincular
Confirme no diálogo Desvincular Agente da Squad com Desvincular

A plataforma mostra Agente desvinculado com sucesso.

Na próxima mensagem do contato, as conversas que estavam com esse Agente passam a ser respondidas pelo Gerente (modo hierárquico) ou pelo Principal (modo horizontal).

O Gerente / Principal não tem Desvincular no menu. Para trocar a liderança, promova outro Agente da lista. A Squad precisa ficar com pelo menos um Agente.

Se você está substituindo um especialista, vincule o novo Agente antes de desvincular o antigo.

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 da Squad atualizadas para refletir seu propósito real
Evite adicionar Agentes sem uma função clara
Revise regularmente quem atua como Gerente/Principal
Quando um especialista sair da Squad, use Desvincular — as conversas dele voltam para o Gerente ou Principal
Prefira Squads pequenos com responsabilidades claras