Squads
Montando um squad de agentes
Agentes especializados que trabalham juntos, com handoff automático entre eles
Atualizado em
Um squad é um grupo de agentes que cobrem diferentes funções de um mesmo fluxo. Em vez de criar um super-agente que faz tudo (e acaba medíocre em tudo), você cria agentes especializados e define como eles passam conversa entre si.
Exemplo num time de software: o agente de Triagem entende o pedido → se for erro em produção, passa para o de Diagnóstico (com Sentry e GitHub); se for sobre a sprint, passa para o de Andamento (com Jira). No módulo Atendimento, o mesmo mecanismo serve para um fluxo comercial: SDR → Vendedor → Pós-venda.
Por que usar squad
- Cada agente tem prompt otimizado para o seu pedaço — melhor performance.
- Você vê cada handoff — sabe exatamente em que ponto o cliente foi passado.
- Pode ter aprovação humana em transições sensíveis (ex.: "só vai para o comercial se humano confirmar").
Passo 1: criar os agentes individuais primeiro
Squad não cria agentes — orquestra os que já existem. Então:
- Crie cada agente do squad em Meus Agentes → Novo Agente.
- Dê um nome com o papel: "Nina SDR", "Marcos Vendedor", "Lia Pós-venda".
- Ative cada um.
Passo 2: criar o squad
Dashboard → Squads → Novo Squad.
- Nome — o nome do fluxo todo ("Pipeline Comercial", "Atendimento Clínica").
- Descrição — anotação interna sobre o propósito.
Você pode também partir de Templates de Squad: Comercial PME, Suporte L1/L2, Financeiro/Cobrança. Cada template vem com papéis e transições pré-definidas — você só associa os seus agentes.
Passo 3: adicionar membros
Na tela do squad, clique Adicionar agente. Para cada agente:
- Selecione qual agente seu quer adicionar.
- Role label — rótulo do papel ("SDR", "Vendedor", "Pós-venda").
- Entry point — marque o agente que vai atender primeiro quando o lead chegar. Pode ter mais de um (ex.: entry por canal diferente).
Passo 4: configurar transições
Transição é a regra de quando um agente passa a conversa para outro. Clique Nova transição:
- De → Para — quais agentes se conversam.
- Trigger — como a transição acontece:
| Trigger | O que ativa |
|---|---|
tool_call | O agente atual chama uma tool específica (ex.: transferir_para_vendedor). |
keyword | Certa palavra ou frase aparece na resposta do agente atual. |
handoff | O agente atual decide explicitamente via prompt. |
manual | Só acontece quando um humano clica no Inbox. |
- Requer aprovação humana? — se marcado, a transição vai para o Inbox como pending, para um operador aprovar antes de acontecer.
Passo 5: conversar com o squad
Na tela do squad, abra o chat: a conversa começa no agente entry point e as transições rolam conforme as regras, dentro do chat interno do time.
Se você usa o módulo Atendimento, também pode associar o squad a um canal — uma instância de WhatsApp, por exemplo. Quando uma mensagem chega naquele número, o squad assume do mesmo jeito.
Acompanhar em tempo real
- Inbox — aba "Squads" mostra todas as conversas em andamento com indicador do agente atual.
- Analytics — Squads → [seu squad] → Ver analytics mostra handoffs por dia, distribuição de carga entre agentes, tool usage.
Boas práticas
- Comece simples — 2 agentes com 1 transição é suficiente para validar. Expanda depois.
- Não tente cobrir 100% dos casos — transição
manualpara operador humano pegar é um curinga poderoso. - Use aprovação humana em dinheiro — qualquer transição que possa virar venda ou cobrança, passe com aprovação na primeira versão. Remova a trava só quando confiar nos dados.