Construir um agente recepcionista que direciona para outros agentes de IA

Um agente recepcionista não resolve casos: ele cumprimenta, identifica o que o cliente precisa e passa a conversa para o agente de IA correto (ou para um humano, quando necessário). É o padrão ideal quando você tem vários agentes especializados (Vendas, Suporte, Faturamento) e quer um único ponto de entrada.

Requisitos

• Pelo menos dois agentes de IA ativos no mesmo workspace: o recepcionista e os agentes especializados de destino.
• Os agentes de destino precisam ter nomes claros e distintos (o recepcionista os referencia pelo nome).

Passos

1. Crie um novo agente de IA e chame-o, por exemplo, de "Recepção".
2. Na aba Instruções, use "Usar modelo" e escolha a categoria Recepcionista como ponto de partida — ela já traz o fluxo de saudação + categorização.
3. Adapte a seção de categorização aos seus próprios agentes especializados, indicando o NOME exato de cada um (ex.: "Vendas Omnifox", "Suporte Omnifox").
4. Na aba Ações personalizadas, ative "Transferir para outro agente de IA" (transfer_to_ai_agent) junto com "Atribuir a pessoa ou equipe" (para os casos que precisam de um humano diretamente).
5. Conecte o canal (WhatsApp, Webchat, etc.) para que este agente Recepção seja o agente de IA principal do canal.

Como funciona transfer_to_ai_agent

• O recepcionista identifica o agente de destino pelo nome (target_agent_name, ex.: "Suporte") e pode opcionalmente informar um reason.
• O agente de destino assume a conversa e responde no próximo turno diretamente — o cliente não percebe uma transferência manual, apenas muda quem responde.
• O idioma detectado do cliente é propagado automaticamente para o agente de destino, para que ele responda no mesmo idioma desde a primeira mensagem.
• Proteção anti-loop embutida: cada conversa tem um limite de 2 saltos entre agentes de IA. Ao ultrapassar esse limite, a ferramenta se recusa a transferir de novo e o agente atual precisa direcionar para uma equipe humana com assign_to_user_or_team em vez disso — isso evita que o cliente fique quicando entre bots indefinidamente.
• Só é possível transferir para outro agente de IA do MESMO workspace.

Exemplo

Um cliente escreve "quero saber quanto custa o plano Pro". O recepcionista identifica a categoria "vendas" e executa !transfer_to_ai_agent target_agent_name="Vendas Omnifox" reason="pergunta sobre preço do plano Pro". O agente de Vendas assume o próximo turno e responde diretamente com o preço, sem o cliente precisar repetir a pergunta.

Dicas

• Sempre deixe claro no prompt quando usar transfer_to_ai_agent (passar para OUTRO BOT especializado) versus assign_to_user_or_team (passar para um HUMANO) — são casos diferentes e o modelo precisa de critérios explícitos.
• Mantenha os nomes dos seus agentes especializados estáveis; se renomear um, atualize também o prompt do recepcionista.
• Teste o percurso completo no Sandbox, incluindo o que acontece se o cliente pedir algo fora do tema de novo depois do primeiro direcionamento (para não esbarrar no limite de 2 saltos).

Solução de problemas

• "Não encontra o agente de destino": confirme que o nome coincide (ou é muito parecido) com o nome real do agente e que esse agente está ativo.
• "Para de transferir depois do segundo direcionamento": é o limite anti-loop de 2 saltos por conversa — a partir daí, a conversa precisa ir para uma equipe humana.