Squads e Multi-Agente

Em vez de um agente único tentando cobrir tudo, você pode montar um squad: vários agentes especializados, com um orquestrador que recebe a conversa e transfere para o especialista certo. É o padrão recomendado quando o escopo do atendimento cresce.

Quando usar squad vs. agente único

Use agente único quando:

• o escopo é estreito (ex.: só suporte de um produto);
• o prompt cabe sem ficar gigante;
• não há necessidade de especialização por área.

Use squad quando:

• você precisa atender áreas diferentes (vendas, suporte, financeiro);
• o prompt de um agente único ficaria longo demais e contraditório;
• você quer modelos diferentes para tarefas diferentes (um barato para triagem, um forte para resolver);
• algumas conversas precisam ir para um humano em pontos específicos.

Padrão orquestrador + especialistas

A montagem mais comum:

1. Agente orquestrador — recebe a conversa, identifica a intenção do usuário e transfere para o especialista certo. Costuma ser um modelo barato com prompt curto focado em triagem.
2. Agentes especialistas — cada um cuida de uma área (ex.: Suporte Técnico, Vendas, Financeiro). Cada um tem suas próprias ferramentas, bases de conhecimento e tom.
3. Intervenção humana (opcional) — qualquer especialista pode entregar a conversa para uma pessoa via webhook quando o caso sair do escopo.

Como funcionam as transferências

A transferência entre agentes é feita pela ferramenta nativa Transferir para agente.

1. Abra o agente que deve transferir (geralmente o orquestrador).
2. Vá em Ferramentas → + Adicionar Ferramenta.
3. Escolha Transferir para agente.
4. Ative o switch e marque os agentes de destino na lista — só agentes ativos da mesma organização aparecem (e o próprio agente em edição não aparece, para evitar transferir para si mesmo).
5. As mudanças persistem automaticamente.

Detalhes em Transferir para Agente.

Quando a tool é chamada:

• a conversa muda de dono — o novo agente assume e responde a partir daquele ponto;
• o histórico fica preservado e o novo agente enxerga tudo que já foi dito;
• a transferência é unidirecional — se quiser voltar, o agente de destino precisa ter a tool também.

Intervenção humana

Para entregar a conversa para uma pessoa real, ative a ferramenta nativa Intervenção Humana no agente. Ela exige uma URL de webhook HTTPS — sua organização recebe um POST com o contexto da conversa quando o agente chama a tool.

Após o handoff, o agente para de responder na conversa (ai_enabled = false) até alguém reativar manualmente pelo painel Conversas ou via API. Útil para integrar com CRM, Zendesk, Slack ou qualquer ferramenta que sua equipe já usa.

Detalhes em Intervenção Humana.

Dicas de design

• Mantenha o orquestrador enxuto. Ele só precisa decidir para onde transferir, não resolver o problema. Prompt curto, modelo barato.
• Dê nomes claros aos especialistas. O orquestrador usa o nome e a descrição do agente de destino para decidir — SDR de Vendas é melhor que Agente 2.
• Evite ciclos. Se A transfere para B e B transfere para A sem critério, você entra em loop. Modele o fluxo como árvore, não como grafo.
• Cada especialista tem suas tools. Não dá tudo pra todo mundo — quanto mais focado, melhor o agente decide.
• Teste em conjunto. Use Testar Agente no orquestrador e simule conversas reais que precisam ir para cada especialista. Verifique se a transferência acontece quando deveria.
• Considere o custo. Cada transferência adiciona uma chamada extra de LLM. Em volume alto, isso conta.