Agente
O módulo Agente permite criar um assistente de IA autônomo dentro do seu fluxo de chatbot. Com ele, você define as instruções que o agente deve seguir, quais ferramentas ele pode usar e como ele deve responder ao cliente — tudo sem precisar programar nada.
Ao ser ativado no fluxo, o agente interpreta a mensagem recebida, consulta suas instruções e ferramentas configuradas, e age de forma inteligente: respondendo, tomando decisões ou redirecionando o usuário para outro fluxo.
🧭 Como acessar
No menu lateral, clique em Aplicativo.
Selecione Fluxos.
Abra ou crie um fluxo existente.
No canvas do Builder, clique em + para adicionar um novo módulo.
Localize e selecione o módulo Agente.
O módulo será inserido no canvas. Clique duas vezes sobre ele para abrir as configurações.
🔍 Conhecendo a tela
Ao abrir o módulo Agente, você verá uma janela de configuração com cinco abas:
Configurações — define modelo, tom, limites e comportamento geral
Prompt — escreve as instruções que guiam o agente
Ferramentas — adiciona ações que o agente pode executar
Servidores MCP — conecta servidores externos de ferramentas
Habilidades — cria arquivos de instruções especializadas
⚙️ Aba Configurações
Esta é a aba principal. Aqui você define o comportamento geral do agente.
🔀 Modo de execução
O primeiro bloco define como o agente vai operar dentro do fluxo. Você escolhe entre dois modos:
Execução em loop
O agente continua respondendo a cada nova mensagem do cliente até usar uma ferramenta de saída. Ideal para conversas contínuas.
Execução única
O agente responde uma vez e passa o controle para o próximo módulo do fluxo.
Clique no modo desejado para selecioná-lo.
📝 Contexto
Campo opcional para adicionar informações extras que o agente deve considerar ao responder. Use {{ }} para inserir variáveis do fluxo (como nome do cliente ou número do pedido).
Exemplo: O cliente se chama {{ contact.name }} e está em dúvida sobre o pedido {{ order.id }}.
🧠 Modelo
Selecione o modelo de inteligência artificial que o agente vai usar para processar e responder as mensagens. As opções disponíveis são:
GPT-4o — modelo mais avançado, indicado para tarefas complexas
GPT-4o mini — versão mais leve e rápida do GPT-4o
GPT-4 Turbo — alta capacidade de raciocínio
GPT-3.5 Turbo — opção econômica para fluxos simples
Claude 3.5 Sonnet — modelo da Anthropic com excelente equilíbrio entre velocidade e qualidade
Claude 3 Haiku — versão compacta e ágil da Anthropic
Gemini 1.5 Pro — modelo do Google com grande janela de contexto
Gemini 1.5 Flash — versão rápida do Gemini
A disponibilidade de cada modelo pode depender das integrações configuradas no seu ambiente. Caso algum modelo não apareça, consulte o administrador da plataforma.
🌡️ Temperatura
Controla o quanto as respostas do agente variam. Arraste o slider para ajustar:
Próximo de 0 — respostas mais previsíveis e precisas
Próximo de 2 — respostas mais criativas e variadas
O valor padrão é 0,7, que equilibra precisão e naturalidade.
🔢 Máximo de tokens
Define o tamanho máximo da resposta gerada pelo agente. Um token equivale aproximadamente a 4 caracteres em inglês ou 3 em português.
Valor mínimo: 1
Valor máximo: 128.000
Padrão: 1.024
Aumente esse valor se o agente precisar dar respostas mais longas.
💬 Configurações de resposta
Dois campos complementares:
Máximo de caracteres
Limita o tamanho da resposta enviada ao cliente. Digite 0 para sem limite.
Atraso (ms)
Adiciona um tempo de espera em milissegundos antes de o agente enviar a resposta. Útil para simular um tempo de digitação.
🎭 Tom
Selecione um ou mais tons que o agente deve usar ao responder. Clique nos chips para ativar ou desativar:
Amigável
Formal
Empático
Profissional
Casual
🆔 ID do Agente
Exibe o identificador único do agente, gerado automaticamente. Você pode copiá-lo clicando no ícone ao lado — uma mensagem confirmará que foi copiado.
Esse ID pode ser usado para referenciar este agente em outras integrações ou configurações avançadas.
🔧 Configurações avançadas
Expanda esta seção para acessar opções adicionais:
Ignorar mensagens anteriores
O agente começa cada conversa do zero, sem considerar o histórico de mensagens.
Porta de exceção
Cria um caminho alternativo no fluxo para onde o agente é redirecionado caso ocorra um erro durante a execução.
✍️ Aba Prompt
Aqui você escreve as instruções principais que definem o comportamento do agente. É como orientar um colaborador antes de atender um cliente.
O editor suporta formatação de texto e uso de variáveis com {{ }}.
Exemplo de instrução:
Você é um assistente de suporte da empresa Exemplo. Seu objetivo é ajudar clientes com dúvidas sobre pedidos e entregas. Seja objetivo, cordial e use o nome do cliente sempre que possível.
🧰 Aba Ferramentas
As ferramentas definem o que o agente pode fazer além de responder mensagens. Cada ferramenta aparece como uma opção de ação que o agente pode acionar durante a conversa.
➕ Como adicionar uma ferramenta
Clique em Adicionar ferramenta.
A ferramenta será criada com um nome padrão — clique para editá-la no painel à direita.
Escolha o tipo de ferramenta.
Preencha os campos conforme o tipo selecionado.
Clique em Salvar alterações para confirmar.
Para remover uma ferramenta, clique no ícone de lixeira ao lado do nome dela na lista.
📂 Tipos de ferramenta
Ao selecionar uma ferramenta, escolha um dos quatro tipos disponíveis:
1️⃣ Personalizado
Cria uma saída personalizada no módulo para que você possa conectar a qualquer outro módulo manualmente no canvas.
🎯 Propósito Use quando quiser que o agente tome uma ação específica e passe o controle para um módulo definido por você.
✅ Como fazer na tela
Dê um nome à ferramenta (ex: "Encaminhar para humano")
Descreva quando o agente deve usá-la (ex: "Acione quando o cliente pedir para falar com um atendente")
Defina os parâmetros que o agente deve coletar (JSON Schema) — você pode clicar em Gerar com IA e descrever em texto o que precisa
Conecte a saída criada ao módulo desejado no canvas
📌 Resultado esperado Uma porta de saída aparece no nó do agente. Conecte essa porta ao próximo módulo do fluxo.
2️⃣ Pular
Redireciona o fluxo para outro fluxo cadastrado na plataforma quando o agente decidir acionar essa ferramenta.
🎯 Propósito Use para transferir o atendimento para um fluxo específico — por exemplo, fluxo de vendas, cancelamento ou suporte técnico.
✅ Como fazer na tela
Dê um nome à ferramenta (ex: "Ir para Vendas")
Descreva quando o agente deve usá-la
Selecione o fluxo de destino no campo indicado
Configure os parâmetros que o agente deve passar ao fluxo de destino
📌 Resultado esperado Quando acionada, o agente encerra a conversa no fluxo atual e inicia o fluxo de destino selecionado.
O fluxo de destino precisa estar criado e publicado antes de ser selecionado aqui. Acesse Aplicativo > Fluxos, crie o fluxo e volte para concluir a configuração.
3️⃣ Ferramenta
Conecta o agente a uma ferramenta já configurada na plataforma (como consulta a sistemas externos, envio de dados, busca em bases de conhecimento, entre outras).
🎯 Propósito Use para que o agente possa executar ações integradas — buscar informações de um sistema, registrar dados ou consultar uma base de conhecimento.
✅ Como fazer na tela
Clique no campo de seleção e pesquise a ferramenta desejada
Após selecionar, o nome, a descrição e os parâmetros da ferramenta serão exibidos automaticamente
📌 Resultado esperado O agente passa a ter acesso a essa ferramenta durante as conversas e pode acioná-la quando necessário.
As ferramentas disponíveis para seleção precisam estar cadastradas previamente na plataforma. Caso a ferramenta que você precisa não apareça, entre em contato com o administrador.
4️⃣ Saída
Marca o ponto de encerramento do agente no fluxo. Quando o agente acionar essa ferramenta, ele sai do modo de loop e passa o controle para o próximo módulo.
🎯 Propósito Use sempre que o agente precisar finalizar sua atuação e continuar o fluxo — por exemplo, após coletar todas as informações necessárias.
✅ Como fazer na tela
Dê um nome à saída (ex: "Concluído", "Dados coletados")
Descreva quando o agente deve encerrar (ex: "Quando todas as informações forem confirmadas pelo cliente")
Defina o que o agente deve retornar nesta saída (JSON Schema)
📌 Resultado esperado Uma porta de saída é criada no nó. Conecte-a ao próximo módulo para continuar o fluxo após o agente.
🔌 Aba Servidores MCP
Os Servidores MCP permitem conectar o agente a servidores externos que oferecem ferramentas adicionais. Essa é uma configuração avançada para integrações personalizadas.
➕ Como adicionar um servidor MCP
Clique em Adicionar servidor MCP.
Preencha o Nome do servidor (ex: "Meu servidor de ferramentas").
Informe a URL de acesso ao servidor (ex:
https://mcp.exemplo.com).Para remover um servidor, clique no ícone de lixeira no card correspondente.
A URL do servidor MCP precisa ser fornecida pelo time técnico responsável pela integração. Não altere essa configuração sem orientação adequada.
📚 Aba Habilidades
As habilidades são arquivos de instruções especializadas que ampliam as capacidades do agente. Pense nelas como "manuais internos" que o agente consulta para lidar com situações específicas.
➕ Como criar uma habilidade
Clique em Adicionar novo arquivo.
No painel à direita, preencha:
Nome — o nome da habilidade (o sistema adiciona
.mdautomaticamente)Descrição — explique quando o agente deve usar essa habilidade (2 a 3 linhas)
Conteúdo — escreva as instruções detalhadas no editor de texto
Clique em Salvar alterações.
Para remover uma habilidade, clique no ícone de lixeira ao lado do nome na lista.
💾 Salvando as configurações
Após configurar todas as abas necessárias, clique em Salvar alterações no rodapé da janela. As configurações serão aplicadas ao módulo e a janela será fechada.
O nó no canvas será atualizado mostrando um resumo visual das configurações: modelo selecionado, quantidade de servidores MCP, habilidades, arquivos e uma prévia do prompt.
📌 Dicas úteis
Comece pelo Prompt. A qualidade das instruções é o fator mais importante para o bom desempenho do agente. Seja claro sobre quem o agente é, o que ele pode e o que ele não deve fazer.
Use o modo Execução única quando o agente precisar apenas responder uma pergunta e passar o controle adiante — isso evita que o fluxo fique em loop desnecessariamente.
Combine ferramentas do tipo Personalizado e Saída para criar fluxos com caminhos diferentes dependendo da decisão do agente.
A função "Gerar com IA" nos parâmetros de ferramentas ajuda a criar esquemas JSON sem precisar conhecer a sintaxe — basta descrever em português o que você precisa.
O ID do Agente pode ser útil ao reportar um problema ou ao configurar integrações — guarde-o em um lugar acessível.
💡 Caso de uso
Cenário: Uma empresa de e-commerce quer que o agente identifique automaticamente se o cliente está com dúvida sobre rastreamento de pedido ou troca de produto e direcione para o fluxo correto.
Configuração principal:
Modo de execução: Loop — o agente continua respondendo até identificar a intenção do cliente.
Modelo: GPT-4o mini — velocidade e custo adequados para alto volume de atendimentos.
Prompt: "Você é um assistente de suporte da Loja Exemplo. Seu objetivo é entender se o cliente quer rastrear um pedido ou solicitar uma troca. Pergunte o número do pedido quando necessário. Não resolva outros assuntos — apenas identifique o motivo do contato e acione a ferramenta correta."
Ferramentas configuradas:
Pular → Fluxo de Rastreamento (acionada quando o cliente menciona entrega, prazo ou localização do pedido)
Pular → Fluxo de Trocas (acionada quando o cliente menciona troca, defeito ou produto errado)
Saída → Outros assuntos (acionada para qualquer outro tipo de solicitação)
Resultado esperado no fluxo: O agente conversa com o cliente, identifica a intenção e redireciona automaticamente para o fluxo adequado — sem necessidade de menus ou botões de seleção manual. O atendimento fica mais natural e eficiente.
📝 Resumo
O módulo Agente adiciona um assistente de IA autônomo ao seu fluxo, capaz de interpretar mensagens e tomar decisões.
Configure o comportamento na aba Configurações (modelo, temperatura, tom e modo de execução) e escreva as instruções na aba Prompt.
Use a aba Ferramentas para definir o que o agente pode fazer: redirecionar fluxos, acionar integrações ou criar saídas personalizadas.
O modo em loop mantém o agente ativo até ele acionar uma ferramenta de saída; o modo único faz o agente responder uma vez e seguir o fluxo.
As abas Servidores MCP e Habilidades oferecem recursos avançados para ampliar as capacidades do agente com integrações externas e instruções especializadas.
Last updated