O agente de IA é um atendente automático que conversa com seu cliente, entende o que ele quer e resolve o que estiver ao alcance dele. Este artigo mostra como criar o seu, campo por campo.
Onde ficam os agentes
No menu lateral, abra Automações → Agentes de IA. Repare que não é dentro de Atendimento — é em Automações, junto com o Construtor de fluxo.
A lista mostra todos os seus agentes com o setor, o limite de tokens e as ferramentas que cada um tem liberadas. As etiquetas em vermelho são as ferramentas sensíveis, que executam ações mais delicadas.
Para começar, clique em + Novo agente no canto direito.
No topo da tela existe um indicador de porcentagem. Clicando nele você vê quanto de crédito de IA ainda tem e um atalho para recarregar. Vale conferir antes de criar o primeiro agente: sem crédito, ele não responde.
Nome do agente
Escolha um nome curto e fácil de reconhecer. Ele é de uso interno, aparece na sua lista e nas notas da equipe — o cliente não vê.
Dar nome de pessoa ajuda a equipe a se organizar: “Agente Leo”, “Sofia — Odontologia”. Mas o nome que o cliente vai ver na conversa é o que você escrever dentro do prompt, não este campo.
Setor de atendimento
Aqui você escolhe em qual departamento (fila) esse agente vai atuar. Esse campo é obrigatório — sem ele o agente não é salvo.
Se a lista aparecer vazia, é porque você ainda não criou nenhum departamento. Crie um antes de voltar aqui.
Prompt principal
É o campo mais importante da tela: onde você escreve quem o agente é, como ele fala e até onde pode ir. Também é obrigatório.
Escrever bem o prompt é o que separa um agente que atende bem de um que responde estranho — por isso ele tem um artigo dedicado, com estrutura pronta e exemplos.
Para criar o agente agora, escreva algo simples: quem ele é, o que a empresa faz e como deve falar. Você refina depois, com o agente já funcionando.
Configuração de IA
Este bloco define qual inteligência artificial vai pensar pelo agente e quem paga por ela.
Provedor de IA
Duas opções: OpenAI ou Google Gemini. As duas funcionam bem para atendimento; a escolha costuma ser por preferência e por custo.
Modelo
Cada provedor tem seus modelos, e a lista muda conforme o provedor escolhido.
Uma regra prática para escolher: os modelos com Mini ou Lite no nome são mais rápidos e mais baratos, e dão conta da maioria dos atendimentos. Os modelos maiores raciocinam melhor em situações complexas, mas custam mais por mensagem.
Comece com um modelo Mini ou Lite. Se o agente estiver errando em situações que exigem mais raciocínio, aí sim vale testar um modelo maior — sabendo que o consumo de crédito sobe.
Modo de uso de IA
Aqui você define quem paga pelo uso da inteligência artificial. São três opções:
- Créditos do plano — usa somente os créditos da plataforma (se disponível em seu plano). Se você tiver uma chave própria cadastrada, ela é ignorada.
- Minha chave API — usa a sua chave do provedor. Você paga direto para a OpenAI ou o Google, e não consome crédito da plataforma.
- Automático — usa primeiro o crédito do plano e depois sua própria chave de API.
Cuidado com o Automático. Nesse modo, os créditos da plataforma têm prioridade — ou seja, ele consome seu crédito mesmo que você tenha cadastrado uma chave própria. Se a sua intenção é pagar direto no provedor, escolha Minha chave API.
No modo Minha chave API, o campo da chave passa a ser obrigatório. Sem a chave preenchida, o agente simplesmente não funciona.
Parâmetros de resposta
Três ajustes que mudam o jeito de o agente responder. Os valores padrão funcionam bem — mexa neles quando o comportamento não estiver do jeito que você quer.
Sensibilidade (temperatura)
Controla o quanto o agente é criativo, numa escala de 0 a 2. Perto de 0 ele é mais previsível e direto. Perto de 2 ele varia mais as respostas e improvisa.
Para atendimento, valores entre 0,4 e 0,8 costumam ser o ponto certo: natural sem inventar. Se o seu agente está criando informação que não existe, baixe esse número.
Máx. tokens de saída
O tamanho máximo de cada resposta, entre 50 e 4000. Token é mais ou menos um pedaço de palavra, então esse número é um teto de comprimento, não de caracteres exatos.
Respostas longas custam mais crédito e não combinam com WhatsApp. Se o agente está mandando textão, o caminho não é só reduzir este número — é pedir mensagens curtas no prompt. Cortar aqui pode truncar a resposta no meio da frase.
Máx. mensagens no histórico
Quantas mensagens recentes o agente relê antes de responder. É a memória dele dentro da conversa. O recomendado é 20.
Número baixo faz o agente esquecer o que foi combinado e repetir perguntas. Número alto melhora a memória mas encarece cada mensagem, porque todo esse histórico é reenviado à IA a cada resposta.
Salvar e o que vem depois
Clique em Salvar agente. Com esses campos preenchidos ele já está criado — mas ainda não faz nada além de conversar.
As outras três abas do agente é que dão poder a ele:
- Ferramentas — as ações que ele pode executar: enviar produto, aplicar tag, transferir atendimento, registrar no CRM. Tudo começa desligado.
- Conhecimento — imagens, PDFs e links com informações da sua empresa, para o agente consultar.
- Regras de saída — quando ele deve parar e passar a conversa para uma pessoa.
Não precisa configurar tudo de uma vez. Um agente com nome, setor e prompt já responde. Vá ligando as ferramentas conforme for precisando.
Perguntas frequentes
Preciso de uma chave de API para criar o agente?
Só se você escolher o modo Minha chave API. Nos outros dois modos, o agente usa os créditos de IA do seu plano.
Qual provedor e modelo devo escolher?
Comece com um modelo Mini ou Lite de qualquer um dos dois provedores. São mais rápidos e mais econômicos, e atendem bem a maioria dos casos.
Cadastrei minha chave própria mas o crédito da plataforma está sendo consumido.
O modo está em Automático, e nele os créditos da plataforma têm prioridade. Troque para Minha chave API.
O agente está inventando informação. O que ajusto?
Baixe a sensibilidade (temperatura) e, no prompt, escreva de forma explícita que ele nunca deve inventar dado, preço ou disponibilidade.
O agente esquece o que o cliente já disse e repete perguntas.
Aumente o máximo de mensagens no histórico. Se já estiver em 20 ou mais, o problema provavelmente está no prompt.
Posso ter mais de um agente?
Sim. É até recomendado: um agente por assunto — vendas, suporte, agendamento — funciona melhor que um agente tentando fazer tudo.
Criei o agente e ele não respondeu nada.
Confira três coisas: se há crédito de IA disponível, se o modo de uso está compatível com o que você tem configurado (chave preenchida, no caso da chave própria) e se o agente foi vinculado à conexão que recebe as mensagens.