Como usar multi-agentes e orquestração
Nível: Avançado
Tempo de leitura: 10 min
Plano necessário: Pro ou Ultra
O que é orquestração de agentes
Orquestração é a capacidade de ter múltiplos agentes especializados trabalhando juntos, coordenados por um agente central: o orquestrador.
Em vez de ter um único agente tentando fazer tudo (atendimento, vendas, suporte, agendamento), você cria agentes especializados em cada função e usa um orquestrador para direcionar cada cliente ao agente certo.
Por que usar multi-agentes
Um agente tentando fazer tudo fica genérico. O prompt fica grande, às vezes contraditório, e a qualidade das respostas em cada área é inferior.
Agentes especializados são melhores. Um agente de vendas pode ter um prompt otimizado para qualificação e persuasão. Um agente de suporte pode ter a base de conhecimento técnica completa. Um agente de agendamento pode estar integrado diretamente com o calendário.
A separação também facilita a manutenção. Quando a política de trocas muda, você atualiza só o agente de suporte, não o prompt de um agente monolítico que mistura tudo.
Estrutura típica de multi-agentes
Cliente (WhatsApp / Site)
|
Orquestrador
(analisa intenção)
/ | \
Vendas Suporte Agendamento
Agente orquestrador
- Recebe todas as mensagens iniciais
- Analisa a intenção do cliente com base no contexto
- Roteia para o agente especialista adequado
- Mantém o contexto entre as transferências
O prompt do orquestrador é focado em classificação e roteamento:
Você é o assistente principal da Empresa X. Sua função é entender
o que o cliente precisa e direcioná-lo ao time certo.
Se o cliente quer comprar ou tem dúvidas sobre produtos → passe para Vendas
Se o cliente tem problema com pedido ou produto → passe para Suporte
Se o cliente quer agendar uma visita ou reunião → passe para Agendamento
Se não tiver certeza → pergunte mais uma vez antes de redirecionar
Agentes especialistas
Cada um com seu próprio prompt, base de conhecimento e integrações:
| Agente | Prompt foco | Base de conhecimento | Integrações |
|---|---|---|---|
| Vendas | Qualificação, benefícios, fechamento | Catálogo de produtos, tabela de preços | Google Sheets (CRM) |
| Suporte | Resolução de problemas, empatia | Manual técnico, política de trocas | Webhook sistema de tickets |
| Agendamento | Eficiência, confirmação | Regras de disponibilidade | Google Calendar |
Como configurar na Wevi
Passo 1: Crie os agentes especialistas
Crie cada agente especialista individualmente. Configure prompt, base de conhecimento e integrações de cada um como se fossem agentes independentes. Teste cada um separadamente antes de integrá-los ao orquestrador.
Passo 2: Crie o agente orquestrador
Crie um novo agente e configure seu prompt com as regras de roteamento. No prompt, liste claramente:
- Os critérios para cada redirecionamento
- O que fazer quando não tiver certeza
- Como se apresentar ao cliente antes de redirecionar
Passo 3: Configure o roteamento
No agente orquestrador, abra a aba Identidade e localize a seção Tipo de agente. Selecione Orquestrador e preencha o campo Instruções de roteamento com os critérios para cada especialista. Depois, clique em "Editar fluxo visual →" para conectar o orquestrador aos sub-agentes no editor gráfico:
- Para cada sub-agente, adicione a conexão e defina o label da rota (ex:
suporte,vendas) - O label deve ser único e descritivo — o orquestrador usa esse nome ao acionar o roteamento
Passo 4: Defina o canal de entrada
O canal (WhatsApp, site, widget) aponta para o orquestrador. O cliente nunca interage com os especialistas diretamente; sempre pelo orquestrador.
Passagem de contexto
Quando o orquestrador transfere para um especialista, o contexto da conversa é passado junto. O especialista recebe:
- Todo o histórico da conversa até o momento
- A intenção identificada pelo orquestrador
- Dados coletados (nome, e-mail, descrição do problema)
O cliente não precisa se repetir. A experiência é contínua.
Transferência de volta ao orquestrador
Após o especialista resolver o problema, ele pode devolver a conversa ao orquestrador. Isso é útil quando:
- O cliente tem um segundo assunto diferente
- A sessão do especialista foi concluída (ex: agendamento confirmado) e o cliente tem outras perguntas
No prompt do especialista, inclua:
Quando resolver a solicitação do cliente, pergunte se há mais alguma coisa
que você pode ajudar. Se a resposta envolver outro assunto, devolva ao
orquestrador.
Exemplo real: clínica médica
Cenário: uma clínica com 3 especialidades, equipe de agendamento e time de atendimento.
Orquestrador: "Clínica Bem Estar"
Recebe todas as mensagens no WhatsApp
├── Agente "Informações"
│ Responde sobre especialidades, médicos, planos aceitos
│ Base de conhecimento: site da clínica + FAQ
│
├── Agente "Agendamento"
│ Agenda, reagenda e cancela consultas
│ Integração: Google Calendar
│
└── Agente "Pós-consulta"
Tira dúvidas após consultas, encaminha resultados de exames
Base de conhecimento: procedimentos pós-consulta
Quando o cliente envia "quero marcar uma consulta", o orquestrador identifica a intenção e transfere para o Agente de Agendamento. Se depois da confirmação o cliente perguntar "quais documentos preciso levar?", o Agente de Agendamento responde com base no prompt, ou devolve ao orquestrador se for um assunto de informações gerais.
Limites e boas práticas
Não crie orquestração sem necessidade. Para negócios com 1 a 3 casos de uso simples, um único agente bem configurado é mais eficiente. A orquestração adiciona complexidade que só vale a pena quando os casos de uso são realmente distintos.
Teste cada camada separadamente. Antes de ligar tudo junto, verifique que cada especialista funciona corretamente de forma independente.
Monitore as transferências. O painel mostra quantas vezes o orquestrador transferiu para cada agente. Se 95% vai para Suporte e 5% para Vendas, pode ser que o roteamento precise de ajuste.
Evite loops. Se o especialista pode devolver ao orquestrador, certifique-se de que o orquestrador não vai mandar o cliente de volta para o mesmo especialista imediatamente.