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.
O que é o orquestrador?
É a porta de entrada do seu projeto e o coordenador da equipe de Agentes de IA. Recebe as mensagens dos canais, conversa com o usuário e decide qual agente resolve 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 parecida com a do Masterbot, mas ampliada: além de encaminhar, conversa, mantém o tom, pode combinar vários agentes em uma mesma resposta e até alternar 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.
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; 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 deve ser usado. Não é preciso programar a lógica de encaminhamento.
Cada "caixinha" do Funnel é um agente?
Não. Cada caixinha é um estado (um passo) do mesmo agente. Um agente é um agente; seus estados internos não são agentes diferentes.
Quais seções um estado tem?
Quatro: (1) Informação do passo (nome e breve descrição), (2) Quais dados são exigidos ao chegar a este estado?, (3) Quem resolve neste passo? e (4) Instruções para o agente (opcional).
Qual é a diferença entre a "breve descrição" do estado e as "instruções para o agente"?
A breve descrição (máx. 140 caracteres) é apenas um rótulo para que a sua equipe entenda o Funnel; não é um prompt. As instruções para o agente são o que o agente realmente segue ao conversar nesse passo.
Como vejo o Funnel?
Como diagrama ou como quadro, com a opção Ver Kanban. Você também tem Ajustes do funnel e controle de zoom.
Como coleto os dados do usuário?
Na seção 2 do estado, "Quais dados são exigidos ao chegar a este estado?". O agente vai pedindo esses dados para poder continuar, e eles ficam salvos e disponíveis para os próximos passos do Funnel.
Posso evitar que ele peça os dados como um formulário?
Sim. Se você preferir que ele os peça um a um, de forma conversacional, indique isso no tom e estilo do orquestrador.
Preciso criar variáveis para guardar o que o usuário diz?
Não para o conversacional: o bot tem memória e os dados exigidos são salvos sozinhos. As variáveis ficam reservadas para integrações e ações de código.
Quem pode resolver um estado?
Você escolhe entre três opções na seção 3 do estado: Agente de IA (autônomo), Human in the Loop (o agente resolve sob supervisão humana) ou Agente humano (uma pessoa do início ao fim, sem IA).
Como escolho quem atende?
Em Human in the Loop e em Agente humano é habilitado o seletor "Quem atende?", onde você escolhe uma equipe de atendimento ou um agente (pessoa) específico.
Quando cada modo é mais indicado?
Human in the Loop para aprovações, reclamações ou casos delicados (a IA avança e a pessoa valida); Agente humano quando o passo deve ser resolvido inteiramente por uma pessoa.
A pessoa atende a conversa diretamente?
Nesta etapa ela participa principalmente 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?
Chegam como cartões na seção de tickets, junto com os tickets de versões anteriores (tickets legacy).
Onde estão as lógicas?
São gerenciadas dentro da seção Capacidades (skills). Você também pode adicionar uma lógica dentro de um estado, a partir de "Instruções para o agente".
Que tipos de lógica posso usar?
Três: instrução (indicar uma tarefa em linguagem natural), condicional (abrir caminhos conforme uma condição) e laço/loop (repetir passos sobre um conjunto de elementos até cumprir uma condição).
Onde conecto integrações como Google Calendar ou Sheets?
Na aba Ferramentas (skills) do agente. Primeiro você integra o serviço ao projeto (vincular a conta) e depois o conecta ao agente, habilitando suas ações.
Qual é a diferença entre "integrar" e "conectar"?
Integrar é vincular a conta de um serviço externo ao projeto (feito uma 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 os agentes utilizarem.
Onde carrego as bases de conhecimento?
Na aba Conhecimento do agente, e você também pode adicioná-las a um estado específico a partir de "Instruções para o agente".
Quais formatos posso carregar?
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 responda sempre com informação atualizada.
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 a sua necessidade.
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 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 manualmente.
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 a partir da opção no final da sua configuração ("excluir orquestrador"). Um agente é excluído a partir do seu perfil, ao lado da visão de Funnel.
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 pode, sim, ter vários canais conectados.
Em que idioma o bot responde?
Isso é definido na seção "Tom e estilo" do orquestrador. Você pode pedir que ele fale um idioma específico ou que se adapte ao idioma em que o usuário escrever (se escreverem em inglês, responde em inglês; se escreverem em espanhol, responde em espanhol). Ele não se guia pelo prefixo do número, e sim por como o usuário fala com ele.
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.
O bot reconhece o mesmo usuário em canais diferentes?
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.
Como testo o meu bot?
A partir do botão Testar do orquestrador. Testar o orquestrador equivale a testar o bot completo. Não é possível testar um agente separadamente; você pode, sim, testar uma lógica de forma isolada.
Posso testar só uma parte do processo?
Sim. Você pode testar uma lógica do Funnel de forma isolada. Para testar o comportamento completo, faça isso a partir do orquestrador.
Onde vejo o raciocínio do orquestrador?
No testador (com "Ver detalhes" você vê para qual agente ele encaminhou) e na seção Execuções. Esse raciocínio não é mostrado 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 e admitem edição colaborativa em tempo real. Colocar as alterações em produção é, sim, uma ação à parte, com o botão Publicar.
Como coloco as alterações em produção?
Com o botão Publicar. Em Histórico você pode consultar versões anteriores.
Posso mudar o modelo de IA?
Sim, você pode selecionar o modelo a partir do orquestrador ou de um agente específico.
Como o uso é faturado?
Por tokens, a unidade com que se mede o processamento do modelo. Você pode revisar o seu consumo na seção Produtos e consumos, na visão de consumo generativo, com detalhe por projeto, por modelo e por função.
Lembre-se de visitar nossa Central de Ajuda para obter mais informações.