> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brainchat.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Criar Agente de IA
> Como criar e configurar um agente de IA completo para atendimento automático via WhatsApp.
# Criar Agente de IA
Agentes de IA conversam automaticamente com seus clientes via WhatsApp usando Google Gemini. Eles qualificam leads, coletam informações, respondem dúvidas e executam ações — de forma natural e personalizada.
## Casos de Uso
* **Qualificação de leads (SDR)**: Qualificar leads com BANT antes de transferir para humano
* **Cobrança com CNV**: Negociar débitos com comunicação não-violenta
* **Coleta de informações**: Coletar nome, e-mail, interesse de forma conversacional
* **FAQ inteligente**: Responder dúvidas com base em documentos (RAG)
* **Roteamento**: Direcionar para departamento correto (comercial, suporte, financeiro)
* **Atendimento pós-venda**: Resolver dúvidas e encaminhar problemas
Veja exemplos completos prontos para copiar em [Templates de Agentes](/agente-ia/templates).
## Passo a Passo
No dashboard, selecione a instância desejada e clique em **Agente de IA** no menu lateral. Depois clique em **Criar Agente**.
Defina a persona do agente:
| Campo | Descrição | Exemplo |
| ------------------------ | ------------------------------ | ------------------------------------------ |
| **Nome da persona** | Nome que o agente usará | "Ana" |
| **Cargo da persona** | Função que o agente representa | "Consultora Comercial" |
| **Nome da empresa** | Nome da sua empresa | "Brainchat" |
| **Descrição da empresa** | O que sua empresa faz | "Plataforma de automação para WhatsApp" |
| **Produtos/Serviços** | O que você oferece | "Plano Starter, Plano Pro, Plano Business" |
A missão é o **objetivo principal** do agente. Ela é incluída no prompt como "SUA MISSÃO" e guia todo o comportamento da conversa.
Exemplos de missão:
* *"Qualificar leads e agendar reuniões com o time comercial"*
* *"Facilitar a regularização de débitos com empatia e CNV"*
* *"Resolver dúvidas e encaminhar problemas complexos para o suporte"*
A missão é diferente das instruções personalizadas. A missão define **o que** o agente deve fazer; as instruções definem **como** ele deve fazer. Veja [Prompt Engineering](/agente-ia/prompt-engineering).
Selecione como o agente deve se comunicar:
| Tom | Descrição |
| ---------------- | ----------------------------------- |
| **Amigável** | Descontraído e acolhedor |
| **Profissional** | Formal e objetivo |
| **Casual** | Informal e próximo |
| **Técnico** | Preciso e detalhado |
| **Formal** | Linguagem formal e cerimonial |
| **Vendas** | Persuasivo e orientado a resultados |
| **Suporte** | Empático e focado em resolução |
Prioridades definem **em que ordem** o agente deve focar seus esforços na conversa. Cada prioridade tem um nome, descrição e peso (importância relativa).
Exemplo para um agente SDR:
1. **Entender a dor do cliente** (peso 3) — Identificar necessidade real antes de vender
2. **Qualificar BANT** (peso 2) — Budget, Authority, Need, Timeline
3. **Agendar reunião** (peso 1) — Só após qualificar
As prioridades são incluídas no prompt do agente e influenciam como ele direciona a conversa.
Guardrails são **regras que o agente nunca deve violar**. São incluídos no prompt como proibições explícitas.
Exemplos:
* "Nunca fornecer preços ou descontos"
* "Nunca prometer funcionalidades que não existem"
* "Nunca compartilhar dados de outros clientes"
* "Nunca ameaçar ou usar linguagem coercitiva"
Cada guardrail é uma frase curta e direta.
Configure quais informações o agente deve coletar durante a conversa. Cada objetivo tem:
| Campo | Descrição |
| -------------------- | ------------------------------------------------------------------------------- |
| **Nome** | Identificador do campo (ex: `nome`, `email`) |
| **Label** | Nome amigável exibido (ex: "Nome completo") |
| **Tipo** | Tipo de dado (veja tabela abaixo) |
| **Obrigatório** | Se o campo é obrigatório para completar o objetivo |
| **Descrição** | Contexto para o agente sobre como coletar |
| **Opções** | Para tipos `select` e `radio`, as opções disponíveis (formato `{value, label}`) |
| **Lista interativa** | Quando ativado, envia as opções como lista interativa do WhatsApp |
| **Campo automático** | Preenche automaticamente com dados do contato |
### Tipos de campo disponíveis
| Tipo | Descrição | Exemplo |
| ------------------ | -------------------------------- | ------------------------------------------- |
| `text` | Texto livre | Nome, empresa |
| `textarea` | Texto longo | Descrição do problema |
| `email` | E-mail com validação | [joao@empresa.com](mailto:joao@empresa.com) |
| `phone` | Telefone com validação | (11) 99999-0000 |
| `number` | Valor numérico | Orçamento, quantidade |
| `select` | Escolha única entre opções | Interesse: Plano A, Plano B |
| `radio` | Escolha única (visual diferente) | Prioridade: Alta, Média, Baixa |
| `checkbox` | Múltipla escolha | Funcionalidades desejadas |
| `boolean` | Sim ou Não | Confirma os dados? |
| `date` | Data | Data de nascimento |
| `time` | Horário | Horário preferido |
| `file` | Arquivo/documento | Comprovante |
| `interactive_list` | Lista interativa do WhatsApp | Menu de opções |
### Campos automáticos (auto-preenchimento)
Alguns campos podem ser preenchidos automaticamente sem precisar perguntar ao cliente:
| Fonte automática | O que preenche |
| ---------------- | ------------------------------------ |
| `whatsapp_phone` | Número de telefone do contato |
| `contact_name` | Nome do contato (se já registrado) |
| `contact_email` | E-mail do contato (se já registrado) |
Quando um campo é marcado como automático, o agente não pergunta essa informação — ela é preenchida automaticamente a partir dos dados do contato.
### Exemplo de goals (formato real)
```json theme={null}
[
{
"id": "1",
"name": "nome",
"label": "Nome completo",
"type": "text",
"required": true,
"description": "Nome completo do lead"
},
{
"id": "2",
"name": "email",
"label": "E-mail",
"type": "email",
"required": true
},
{
"id": "3",
"name": "telefone",
"label": "Telefone",
"type": "phone",
"required": true,
"isAutomatic": true,
"autoSource": "whatsapp_phone"
},
{
"id": "4",
"name": "interesse",
"label": "Interesse",
"type": "select",
"required": false,
"useInteractiveList": true,
"options": [
{ "value": "starter", "label": "Plano Starter" },
{ "value": "pro", "label": "Plano Pro" },
{ "value": "business", "label": "Plano Business" }
]
},
{
"id": "5",
"name": "confirma",
"label": "Confirma os dados?",
"type": "boolean",
"required": true
}
]
```
O agente coleta essas informações de forma **conversacional**, sem parecer um formulário.
Após configurar, ative o agente. Ele começará a responder automaticamente às mensagens recebidas na instância.
## Configurações Avançadas
| Configuração | Padrão | Descrição |
| ------------------------ | ---------------- | ----------------------------------------------------------------------------------------------------------- |
| Modelo | Gemini 2.0 Flash | Modelo de IA utilizado. Veja [Modelos Disponíveis](/agente-ia/modelos) |
| Max Tokens | 500 | Tamanho máximo da resposta |
| Temperatura | 0.7 | Criatividade (0 = preciso, 1 = criativo) |
| Nível de raciocínio | Desativado | Controla o thinking do modelo (`desativado`, `baixo`, `médio`, `alto`) — veja [Modelos](/agente-ia/modelos) |
| Delay de resposta | 3000ms | Simula digitação para anti-ban |
| Histórico | 10 mensagens | Quantas mensagens anteriores considerar |
| Nível de humanização | 50% | Veja detalhes abaixo |
| Ignorar grupos | Sim | Quando ativado, o agente não responde em grupos do WhatsApp |
| Horário de funcionamento | Desativado | Quando ativado, define horário de início e fim |
| Mensagem fora do horário | — | Mensagem automática quando o agente está fora do expediente |
| Mensagem de fallback | — | Mensagem enviada quando o agente não consegue processar (erro de API, timeout, etc.) |
| Prioridade multi-agente | 0 | Quando há múltiplos agentes na instância, define qual tem prioridade (maior = mais prioritário) |
### Nível de Humanização
O slider de humanização controla o quão "humano" o agente parece nas respostas:
| Faixa | Comportamento |
| -------------------------- | ------------------------------------------------------------- |
| **0-25% (Robótico)** | Respostas diretas, sem emojis, linguagem precisa |
| **26-50% (Equilibrado)** | Tom natural mas profissional, poucos emojis |
| **51-75% (Humano)** | Linguagem informal, emojis moderados, pausas naturais |
| **76-100% (Muito humano)** | Gírias leves, emojis frequentes, erros de digitação simulados |
### Modo de Ativação
O agente pode ser ativado de diferentes formas:
| Modo | Descrição |
| ------------------ | ----------------------------------------------------------------------------------- |
| **Sempre** | Responde a todas as mensagens recebidas (padrão) |
| **Por tag** | Só ativa para contatos que possuem uma tag específica |
| **Novos contatos** | Só ativa para contatos que acabaram de ser criados |
| **Manual** | O agente não ativa automaticamente — só responde quando ativado manualmente no chat |
### Tags de Bloqueio
Você pode configurar tags que **bloqueiam** o agente. Contatos com essas tags não serão atendidos pelo agente, útil para clientes em atendimento humano exclusivo ou contatos VIP.
### Mascaramento de Dados (LGPD)
Configure regras de mascaramento para proteger dados sensíveis nos logs e históricos:
* **CPF**: Mascara automaticamente números de CPF
* **Cartão de crédito**: Mascara números de cartão
* **Personalizado**: Defina regex para mascarar outros padrões
Os dados originais são coletados normalmente nos goals, mas ficam mascarados nos logs de conversa.
### Comportamento Pós-Coleta e Mensagem de Boas-vindas
Configure o que acontece após o agente completar todos os objetivos e a mensagem enviada ao iniciar uma conversa. Veja [Comportamento e Coleta](/agente-ia/comportamento).
O agente convive com o atendimento humano. Quando um operador envia uma mensagem manual, o agente pausa automaticamente. Veja [Intervenção Humana](/agente-ia/intervencao-humana).