Skip to main content

O que é um Agente?

Um Agente é uma instância de IA configurada para um propósito específico. Cada agente pode ter:
  • Personalidade e tom de voz próprios
  • Fluxo de atendimento específico
  • Base de conhecimento dedicada
  • Regras de comportamento customizadas
Você pode ter múltiplos agentes para diferentes finalidades: um para vendas, outro para suporte, outro para agendamentos, etc.

Criando um novo agente

1

Clique em 'Novo Agente'

Na barra lateral esquerda do Flow Builder, clique no botão Novo Agente.
2

Escolha como começar

Uma tela será exibida com as opções de criação:

Em Branco

Comece do zero com os 3 blocos essenciais: Início, Prompt Base e Configuração do Agente.

Template

Use um modelo pré-configurado para seu segmento (Hotel, E-commerce, Suporte) com blocos adicionais já conectados.
3

O Flow Builder abre com os blocos iniciais

Após escolher, o editor visual abre com os blocos do seu agente já conectados e prontos para configuração.Se escolheu Em Branco, você verá:
Se escolheu um template, blocos adicionais como Roteador, Cotação e Transferência já estarão presentes.

Exportando um agente

Você pode exportar qualquer agente como arquivo JSON para backup ou para replicar em outra conta.
1

Acesse o Dashboard do Flow Builder

Na lista de agentes, localize o agente que deseja exportar.
2

Abra o menu de opções

Clique no menu de opções (tres pontos) do agente.
3

Clique em Exportar

Selecione Exportar. Um arquivo .json será baixado automaticamente para o seu computador.

O que é exportado e o que não é

Credenciais e bases de conhecimento são removidas propositalmente do arquivo exportado. Isso protege informações sensíveis caso o arquivo seja compartilhado.

Importando um agente existente

Além de criar do zero, você pode importar um agente de um arquivo JSON:
1

Clique em Importar

Na tela inicial do Flow Builder, clique no botão Importar.
2

Selecione o arquivo

Escolha o arquivo .json exportado anteriormente. O limite de tamanho é 5MB por arquivo.
3

Revise os avisos pós-importação

Após o upload, um modal exibe a lista de itens que precisam de reconfiguração — como bases de conhecimento, equipes de atendimento e credenciais de API. Anote esses itens para ajustar depois.
4

Finalize a importação

O agente será criado como rascunho. Abra o editor, reconfigure os itens listados nos avisos e só publique quando tudo estiver pronto.
Caso de uso: redes multi-unidade. Se você gerencia uma rede de hotéis, franquias ou lojas, pode criar um agente base bem configurado, exportá-lo e importar em cada conta. Depois, basta ajustar os detalhes específicos de cada unidade (nome, equipe, base de conhecimento). Isso economiza horas de configuração repetitiva.

Os 3 blocos essenciais

Todo agente possui 3 blocos que formam sua base. Clique em cada bloco no editor para configurá-lo no painel lateral direito.

1. Bloco Início

Bloco Início

Bloco Início com variáveis de contexto

O bloco Início é o ponto de entrada do fluxo e define o contexto da conversa:
O tempo de sessão pode ser configurado para até 24 horas (1440 minutos). Isso é útil para interações longas — como processos de cotação ou negociação — onde o cliente pode demorar para responder, mas você quer que o agente mantenha todo o contexto da conversa.

2. Bloco Prompt Base

Bloco Prompt Base

Bloco Prompt Base com contexto e regras

O Prompt Base é onde você define a inteligência do agente. Este é o bloco mais importante para a qualidade das respostas.

Exemplo de Contexto

Exemplo de Regras

Exemplo de Restrições

3. Bloco Configuração do Agente

Configuração do Agente

Bloco Configuração do Agente

A Configuração do Agente define a personalidade e o comportamento operacional:

Templates disponíveis

Os templates são modelos pré-configurados com blocos adicionais já conectados:
Mesmo usando um template, todos os blocos podem ser editados, removidos ou reorganizados. O template é apenas um ponto de partida que acelera a configuração.

Boas práticas para o Prompt Base

Seja específico

Defina limites claros

Use o campo Restrições para listar o que o agente NÃO deve fazer:

Use exemplos quando necessário

O campo Exemplos aceita pares de pergunta/resposta que guiam o tom do agente:

Vinculando a uma caixa de entrada

Após criar e publicar o agente, você precisa vinculá-lo a uma caixa de entrada para que ele comece a atender. A vinculação é feita no Make Talk, não no Flow Builder.
1

Publique o agente

No Flow Builder, certifique-se de que o agente está com status Publicado. Agentes em rascunho não aparecem para vinculação.
2

Acesse o Make Talk

Vá em Configurações → Caixas de Entrada e selecione a caixa onde deseja ativar o agente.
3

Vá em Configurações do bot

Clique na aba Configurações do bot dentro das configurações da caixa de entrada.
4

Selecione AI Flow Builder

Escolha a opção AI Flow Builder e selecione o agente desejado no dropdown.
5

Salve a configuração

Clique em Atualizar. O agente começará a atender automaticamente.
Uma caixa de entrada pode ter apenas um agente ativo por vez. Se você vincular um novo agente, o anterior será substituído automaticamente.

Guia completo de integração

Veja o passo a passo detalhado com imagens.

Testando o agente

Antes de colocar em produção, teste extensivamente:

Checklist de testes

Perguntas básicas sobre seu produto/serviço
Perguntas fora do escopo (deve responder adequadamente)
Situações que devem transferir para humano
Cliente irritado ou com reclamação
Múltiplas perguntas na mesma mensagem
Mensagens em outros idiomas (se aplicável)

Simulando conversas

Playground de teste

Playground de teste do agente

Use a função de Playground do Flow Builder para simular conversas completas:
  1. Clique em “Testar Agente” (ícone de play)
  2. Digite mensagens como se fosse um cliente
  3. Observe as respostas e o fluxo
  4. Ajuste o prompt ou fluxo conforme necessário

Solução de problemas

Solução: Adicione mais contexto e exemplos específicos no bloco Prompt Base. Inclua informações sobre seus produtos/serviços no campo Contexto ou vincule uma base de conhecimento.
Solução: Adicione nas Restrições: “Se você não souber a resposta, diga ‘Vou verificar essa informação com nossa equipe’ e transfira para um humano.”
Solução: Ajuste o campo Tom no bloco Configuração do Agente e adicione exemplos de resposta no Prompt Base para guiar o estilo de comunicação.
Solução: Liste explicitamente nas Regras do Prompt Base as situações que exigem transferência. Configure também o bloco de Transferência (Handoff) no fluxo.
Solução: Ao importar, recursos como bases de conhecimento, equipes e credenciais de API são específicos da conta. Reconfigure esses itens no editor após a importação.

Próximos passos

Construir um Fluxo

Crie fluxos visuais para seu agente.

Base de Conhecimento

Conecte uma base de conhecimento ao agente.