Criando seu agente de IA do zero (persona, tom e comportamento)

Um agente de IA no Autopilot é um vendedor virtual que conversa com seus clientes no WhatsApp usando modelos Claude (Anthropic). Ele não é um robô de menu: ele lê a conversa, entende o contexto e responde como uma pessoa do seu time responderia — só que 24 horas por dia. E antes de qualquer resposta sair, ela passa pelos guarda-corpos da plataforma, que verificam se o que a IA disse bate com os dados reais da sua empresa. Nesta página você monta o primeiro agente do zero.

Passo a passo: criando o agente

• Nome e descrição: dê um nome que seu time reconheça (ex: "Vendas — Produto X"). A descrição é interna, só pra organização.
• Instruções (system prompt): é aqui que você define quem o agente é, o que ele vende e como ele age. Escreva como se estivesse treinando um funcionário novo: "Você é atendente da [empresa], vende [produto], seu objetivo é [fechar a venda / tirar dúvidas]". Até 10.000 caracteres.
• Tom de voz: escolha entre Profissional (PROFESSIONAL), Amigável (FRIENDLY), Descontraído (CASUAL), Formal (FORMAL), Empático (EMPATHETIC), Assertivo (ASSERTIVE) ou Personalizado (CUSTOM). Pra venda no WhatsApp brasileiro, FRIENDLY costuma converter bem.
• Modelo: Sonnet é o mais inteligente (recomendado pra vendas); Haiku é mais rápido e barato (bom pra triagem e dúvidas simples).
• Temperatura (0 a 1): controla a criatividade. Perto de 0, respostas mais previsíveis e fiéis ao script; perto de 1, mais variadas. Pra vendas, algo entre 0.3 e 0.7 funciona bem.
• Capacidades: o que o agente PODE fazer — responder texto, buscar na base de conhecimento, enviar mídia, disparar fluxos, adicionar/remover tags, transferir de departamento, escalar pra humano, enviar PIX de recuperação etc. Agente novo já vem com um conjunto padrão seguro.
• Palavras-chave: até 50 palavras que ativam o agente automaticamente quando o cliente as envia (ex: "preço", "quero comprar").
• Regras de escalação: quantas mensagens ou minutos o agente segura sozinho antes de chamar um humano (detalhes no artigo de escalação).

Dica de operador: não tente escrever o system prompt perfeito de primeira. Crie o agente, converse você mesmo com ele pelo WhatsApp fingindo ser cliente, e vá ajustando as instruções a cada resposta estranha. Três rodadas de teste valem mais que uma hora escrevendo prompt no escuro.

Problemas comuns

• Agente não ativa: confira se ele está ativo (isActive) e se as palavras-chave batem com o que o cliente realmente digita — inclua variações com erro de digitação.
• Respostas genéricas demais: o system prompt está vago ou a base de conhecimento está vazia. A IA só é tão boa quanto o que você cadastrou — veja o artigo sobre base de conhecimento.
• Respostas longas demais: limite o tamanho no campo de tokens máximos por resposta e peça no prompt "respostas curtas, estilo WhatsApp".