O orquestrador é a porta de entrada do seu projeto na Botmaker e o coração da versão 3.0. Recebe as mensagens que chegam pelos seus canais e é quem realmente conversa com o usuário: tem a voz e o tom, decide como responder e coordena a sua equipe de Agentes de IA. Lê a intenção de cada mensagem, escolhe o agente (ou os agentes) adequado para resolvê-la e sintetiza uma única resposta a partir do que cada um contribui. Os Agentes de IA nunca falam diretamente com o usuário; quem fala é sempre o orquestrador.

Você pode:

• Criar um ou mais orquestradores para o seu projeto.
• Conectar e desconectar canais de entrada em tempo real.
• Associar os Agentes de IA entre os quais ele distribui as conversas (e reutilizar um mesmo agente em vários orquestradores).
• Definir o tom e o estilo da conversa: tom, extensão da resposta, personalidade e idioma.
• Definir restrições que ele deve respeitar ao interagir com os usuários.
• Testar o comportamento e revisar o histórico de execuções com o raciocínio de cada conversa.

Por enquanto, a Botmaker 3.0 funciona em canais de chat (por exemplo, webchat, WhatsApp, Instagram e Facebook). O atendimento por voz e por e-mail está em desenvolvimento.

Conceitos-chave

Orquestrador: camada coordenadora que recebe as mensagens dos canais, conversa com o usuário e encaminha cada consulta ao Agente de IA correspondente conforme a intenção. Pode combinar vários agentes em uma mesma resposta.

Canal: meio pelo qual entram e saem as mensagens (webchat, WhatsApp, Instagram, Facebook etc.). É a cara do negócio diante do usuário.

Agente de IA: unidade que resolve um tipo de tarefa ou consulta. O orquestrador escolhe para qual agente encaminhar lendo a descrição (ativação) de cada um.

Descrição (ativação) do agente: frase breve em linguagem natural que indica quando o agente deve ser usado. Convém que seja concisa, de cerca de 10 a 15 palavras.

Tom e estilo: definição de como o orquestrador conversa (tom, extensão, personalidade, idioma). Configura-se no orquestrador, não nos agentes.

Restrições: limites e comportamentos que o orquestrador deve respeitar ao interagir com os usuários.

Memória por canal: o orquestrador lembra o contexto da conversa dentro de um mesmo canal, mas não identifica sozinho o mesmo usuário entre canais distintos.

Como configurar o seu orquestrador

Passo 1: Crie ou abra um orquestrador

Acesse a seção onde você projeta seus Agentes de IA. No menu lateral esquerdo, em Orquestradores, clique no botão + para criar um novo (ou use Criar orquestrador se o projeto estiver vazio), ou selecione um já existente para editá-lo. Ao criá-lo, dê um nome; depois você poderá renomeá-lo pelo lápis ao lado do título.

Passo 2: Conecte um canal

No bloco Orquestrador, na coluna CANAIS, clique em + Adicionar canal e escolha o canal a conectar. A partir desse momento, todas as mensagens que entrarem por esse canal serão recebidas e encaminhadas por este orquestrador. Você pode conectar ou desconectar canais a qualquer momento.

Observação: um canal se associa a um único orquestrador (relação 1:1), para que as conversas não se misturem. Um mesmo orquestrador, por sua vez, pode ter vários canais. Se você conectar uma caixa de e-mail, a vinculação é feita pelo Mailbot e depois você volta para Agentes de IA para continuar.

Passo 3: Associe seus Agentes de IA

Na coluna AGENTES, clique em + Adicionar agente e selecione os agentes entre os quais ele distribuirá as conversas. Você não precisa programar a lógica de encaminhamento: o orquestrador decide lendo a descrição (ativação) de cada agente. Um mesmo agente pode ser reutilizado em diferentes orquestradores.

Observação: se o orquestrador não tiver nenhum agente associado, ele receberá as mensagens do canal, mas não terá para quem encaminhá-las.

Passo 4: Defina o tom e o estilo

Na seção Tom e estilo você define como o orquestrador conversa: o tom (formal, informal, próximo), a extensão das respostas, a personalidade e o idioma. O orquestrador adapta o idioma ao do usuário. Você também pode habilitar botões dinâmicos.

Observação: escreva em linguagem natural —na 3.0 não é preciso "prompt engineering"— e mantenha o texto breve.

Passo 5: Defina as restrições

Na seção Restrições, descreva os limites que o orquestrador deve respeitar (por exemplo: não mencionar a concorrência, não dar valores nem cotações, ou não responder consultas alheias ao negócio).

Passo 6: Teste e revise as execuções

Use o botão Testar para simular conversas e ver o raciocínio do orquestrador. Em Execuções você revisa o histórico de conversas reais com seu raciocínio. Quando tudo estiver pronto, publique as alterações dos seus agentes com o botão Publicar.

Execucoes:

Testar:

Histórico de Publicacoes:

Publicar:

Observação: durante os testes você pode digitar @reset para limpar o contexto. As alterações são salvas automaticamente e o orquestrador permite edição colaborativa em tempo real.

Um orquestrador por canal

Você pode criar vários orquestradores que reutilizem os mesmos Agentes de IA, mas conversem de forma diferente conforme o canal. Por exemplo, um para Instagram com tom descontraído e emojis, e outro para e-mail mais formal, sem duplicar o trabalho dos seus agentes.

Lembre-se de visitar nossa Central de Ajuda para obter mais informações.