Leitura de 10 minutos Atualizada: 18/06/2026 Criado pela: Equipe Botmaker

Perguntas frequentes

Neste artigo respondemos às perguntas mais comuns sobre o Botmaker 3.0, a versão agêntica da plataforma. Elas estão agrupadas por tema para que você encontre rapidamente o que procura.



Conceitos gerais

O que é o orquestrador?

É a porta de entrada do seu projeto e o coordenador de toda a equipe de Agentes de IA. Recebe as mensagens dos canais, conversa com o usuário e decide qual agente deve resolver cada consulta. É quem tem a voz e o tom, e o único que fala com o usuário.

Qual é a diferença em relação ao Masterbot das versões anteriores?

O orquestrador cumpre uma função semelhante à do Masterbot, mas ampliada: além de encaminhar, ele conversa, mantém o tom, pode combinar vários agentes em uma mesma resposta e ir alternando entre eles conforme a conversa.

O que muda em relação ao Botmaker 2.0?

Em vez de montar árvores rígidas de decisões, você define objetivos em linguagem natural e o agente os interpreta. A associação principal passa de "bot + canal" para "canal + orquestrador", e você reutiliza agentes e idiomas sem duplicar bots.

Os Agentes de IA falam com o usuário?

Não. Os agentes resolvem tarefas e devolvem o resultado ao orquestrador; quem responde ao usuário é sempre o orquestrador.

Cada "caixinha" do workflow é um agente?

Não. As caixinhas são os estados (etapas) que um mesmo agente segue para cumprir seu objetivo. Um agente é um agente; suas etapas internas não são agentes distintos.

O orquestrador pode usar vários agentes para uma única resposta?

Sim. Ele pode consultar mais de um agente e sintetizar uma única resposta com o que cada um contribui.

Ele pode mudar de um agente para outro no meio da conversa?

Sim. O orquestrador pode ir alternando entre agentes conforme a conversa evolui; ele não segue um caminho linear fixo.

Como o orquestrador sabe para qual agente encaminhar?

Ele lê a descrição (ativação) de cada agente: uma frase breve em linguagem natural que indica quando ele deve ser usado. Não é necessário programar a lógica de encaminhamento.


Canais

Posso associar mais de um orquestrador a um mesmo canal?

Não. A relação é 1:1: um canal é associado a um único orquestrador, para que as conversas não se misturem. Um mesmo orquestrador, sim, pode ter vários canais conectados.

Como conecto uma caixa de e-mail?

A vinculação do e-mail é feita por meio do Mailbot; depois você volta para Agentes de IA para continuar com a configuração.

Em que idioma o bot responde?

Isso é definido na seção “Tom e estilo” do orquestrador. Você pode solicitar que ele fale um idioma específico ou que se adapte ao idioma em que o usuário escreve: se escreverem em inglês, ele responde assim; se escreverem em espanhol, responde em espanhol, etc. Ele não se guia pelo prefixo do número, e sim pela forma como o usuário fala.

Posso atender em vários idiomas sem duplicar o bot?

Sim. Um mesmo orquestrador pode lidar com diferentes idiomas, sem precisar montar um bot por idioma.


Agentes, orquestradores e reutilização

Um mesmo agente pode ser usado em vários orquestradores?

Sim. Os agentes podem ser reutilizados em vários orquestradores sem duplicá-los, o que evita refazer processos.

Quantos agentes um orquestrador pode ter?

Não há um número máximo: um orquestrador pode ter vários agentes conforme você precisar.

Quando vale a pena ter vários orquestradores?

Quando você quer uma mesma equipe de agentes com comportamentos diferentes conforme o canal (por exemplo, um orquestrador para o Instagram com tom descontraído e outro para e-mail mais formal), ou para separar grandes áreas da sua operação.

Posso copiar ou duplicar um orquestrador ou um agente?

No momento essa função não existe; é uma melhoria prevista. Enquanto isso, a configuração é feita de forma manual.

Como renomeio um orquestrador?

Entrando no orquestrador e usando o lápis que aparece ao lado do título, na parte superior.

Como excluo um orquestrador ou um agente?

O orquestrador é excluído pela opção no final da sua configuração ("excluir orquestrador"). Um agente é excluído pelo seu perfil, ao lado da visualização de workflow.


Workflows e lógicas

Que tipos de lógica posso usar em um workflow?

Três: instrução (indicar uma tarefa em linguagem natural), condicional (abrir caminhos conforme uma condição) e laço (repetir etapas sobre um conjunto de elementos até cumprir uma condição).

Como peço dados ao usuário?

Adicionando dados obrigatórios no estado correspondente do workflow. O agente irá pedindo-os para poder continuar.

Posso evitar que ele peça os dados como um formulário?

Sim. Se você prefere que ele os peça um a um, de forma conversacional, indique isso no tom e estilo do orquestrador.

Posso testar apenas uma parte do processo?

Você pode testar uma lógica do workflow de forma isolada. Para testar o comportamento completo, isso é feito a partir do orquestrador.


Bases de conhecimento

Quais formatos posso carregar em uma base de conhecimento?

Documentos como PDF, DOC, XLSX ou TXT, ou então a URL de uma página web.

Quando ela fica pronta para uso?

O carregamento é processado de forma assíncrona (indexação). A base fica disponível para o agente somente quando seu estado passa para "pronta".

Como atualizo o conteúdo?

Carregando novamente o material de origem quando ele mudar, para que o agente sempre responda com informações atualizadas.


Integrações e MCP

Qual é a diferença entre "integrar" e "conectar"?

Integrar é vincular a conta de um serviço externo ao projeto (feito uma única vez). Conectar é habilitar essa integração dentro de um agente, escolhendo suas ações e descrevendo quando usá-las.

O que acontece se o serviço externo (por exemplo, o calendário) cair?

O agente pode informar que não consegue concluir a ação temporariamente, porque as integrações dependem do serviço externo.

O que é um MCP?

Um servidor externo do catálogo do projeto que expõe ferramentas adicionais para que os agentes as utilizem.


Memória e dados

Preciso criar variáveis para guardar o que o usuário diz?

Não para o conversacional: o bot tem memória e lembra o contexto automaticamente. As variáveis ficam reservadas para integrações e ações de código.

O bot reconhece o mesmo usuário em diferentes canais?

Não por si só: a memória é por canal. Para reconhecer uma pessoa entre canais, você precisa de um sistema externo (CRM ou planilha) que use um dado como identificador.

O ticket muda conforme o agente que intervém?

Não. O ticket é único e vai se movendo ao longo dos processos, não importa qual agente participe.


Pessoas e tickets

Como encaminho uma conversa para uma pessoa?

Adicionando uma etapa de "encaminhar para um humano" no workflow do agente. Não é automático: precisa ser configurado, e pode ser atribuído a um usuário ou a uma equipe.

A pessoa atende a conversa diretamente?

Nesta etapa ela participa como validadora ou aprovadora dentro do processo; a conversa com o usuário continua sendo conduzida pelo Agente de IA. A funcionalidade está em evolução.

Onde aparecem os pedidos de intervenção?

Eles chegam como cartões na seção de tickets, junto com os tickets de versões anteriores (tickets legados).


Testes

Como testo meu bot?

Pelo botão Testar do orquestrador. Testar o orquestrador equivale a testar o bot completo. Não é possível testar um agente separadamente; mas você pode testar uma lógica do workflow de forma isolada.

Onde vejo o raciocínio do orquestrador?

No tester (com "Ver detalhes" você vê para qual agente ele encaminhou) e na seção Execuções. Esse raciocínio não é exibido na conversa que o usuário final vê.

Quem pode ver as Execuções?

Os perfis autorizados do projeto (por exemplo, os responsáveis por desenhar os agentes).

Como reinicio uma conversa de teste?

Escrevendo o comando @reset, que limpa o contexto e permite começar do zero.

Preciso salvar as alterações?

Não, elas são salvas automaticamente. Além disso, várias pessoas podem editar ao mesmo tempo, em tempo real.


Modelo e custos

Posso trocar o modelo de IA?

No momento não: o modelo generativo vem pré-configurado.

Como o uso é cobrado?

Por tokens, a unidade com a qual se mede o processamento do modelo. Você pode revisar seu consumo na seção Produtos e consumos, na visão de consumo generativo, com detalhe por projeto, por modelo e por função.

Como faço para que o consumo seja mais eficiente?

Com designs concisos: um tom e estilo breve e instruções claras fazem com que o modelo processe menos informação.



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