> ## 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 um agente de IA > Passo a passo do construtor do agente: ativação, modelo, persona, conhecimento, coleta de dados, ações, teste e versões. O agente de IA conversa com seus clientes pelo WhatsApp: tira dúvidas, qualifica, coleta dados e executa ações (transferir, aplicar etiqueta, enviar para outro sistema). Quando precisa, passa a conversa para a equipe. Abra em **Atendimento → AI Agent**. A tela tem **Meus Agentes**, **Conversas**, **Métricas** e **Logs**. Clique em **Criar Agente**. Para começar mais rápido, copie os textos de um dos [modelos prontos](https://docs.brainchat.app/atendimento/agente-ia/modelos-prontos.md) (SDR, cobrança, atendimento). Se o limite de agentes do plano foi atingido, o botão leva a **Solicitar ao comercial**. > [!NOTE] > > O agente usa a **chave do Google** da sua organização: o custo dos tokens é pago direto ao Google e não desconta créditos de IA. Veja [Chave do Google](https://docs.brainchat.app/atendimento/agente-ia/chave-google.md). ![Lista de agentes de IA com modelo, conversas, saúde e status de cada agente](https://mintcdn.com/stegia/H1B-GpiWPsLe8SyG/images/atendimento/agentes-lista.png?fit=max\&auto=format\&n=H1B-GpiWPsLe8SyG\&q=85\&s=33b8d405710145c60c068d4a765640d9) Lista de agentes ## Abas do construtor ![Construtor do agente com as abas Configurações Iniciais, API & Modelo, Persona, Recursos Úteis, Conhecimento, Coleta de Dados, Ações, Testar e Versões](https://mintcdn.com/stegia/2sx_YUniIgU9qCdN/images/atendimento/agente-construtor.png?fit=max\&auto=format\&n=2sx_YUniIgU9qCdN\&q=85\&s=97397e6aea2fbc7d4a51c84ce0d07d3d) Construtor do agente, aba Configurações Iniciais ### Configurações Iniciais * **Nome do agente (no painel)** e **Nota interna** (só para organizar; não vai para o agente). * **Canais em que atua**: o mesmo agente pode responder em vários números da organização. * **Ativação**: quando o agente responde. Use **Tags de Ativação**, **Validar sentença na primeira mensagem** (com **Testar mensagem**) e **Tag de Bloqueio**. Em **Prioridade em conflito**, escolha **Bloqueio vence** ou **Ativação vence**. * **Ignorar Grupos** e **Prioridade** (com vários agentes no mesmo canal, o de menor número responde primeiro). * **Mensagem de Boas-vindas** (opcional). * **Pausar quando operador responder**, com a **Duração da pausa**. Veja [Intervenção humana](https://docs.brainchat.app/atendimento/agente-ia/intervencao-humana.md). * **Horário de Funcionamento** próprio do agente, **Idioma de atendimento** e **Mensagem de Espera**. * **Se o agente falhar**: só enviar a mensagem de erro ou executar uma ação (ex.: transferir para humano) com **Aviso ao cliente**. Veja mais em [Comportamento e coleta](https://docs.brainchat.app/atendimento/agente-ia/comportamento.md). ### API & Modelo Escolha a **Chave da API Google Gemini** (do cofre do canal) e use **Testar conexão**. Depois defina **Modelo**, **Nível de raciocínio**, **Tamanho das respostas**, **Esperar o cliente terminar de escrever**, **Atraso antes de responder**, **Temperatura**, **Contexto de conversa (mensagens)** e **Memória entre conversas** (**Contínua** ou **Isolada**). Veja [Modelos](https://docs.brainchat.app/atendimento/agente-ia/modelos.md). ### Persona ![Aba Persona com Identidade, Missão, Comportamento e Voz](https://mintcdn.com/stegia/H1B-GpiWPsLe8SyG/images/atendimento/agente-persona.png?fit=max\&auto=format\&n=H1B-GpiWPsLe8SyG\&q=85\&s=13b1ba33aa9ba8698d7de79462fb7b12) Aba Persona Quatro blocos: * **Identidade**: nome usado nas conversas, função, nome e descrição da empresa, produtos e serviços. * **Missão**: objetivo principal, **Prioridades de Atuação** (arraste para ordenar) e **Guardrails (Proibições)**. * **Comportamento**: **Tom de Voz**, **Estilo de Comunicação**, **Nível de Humanização** e **Instruções Personalizadas**. * **Voz**: para respostas em áudio. Dicas de escrita em [Instruções do agente](https://docs.brainchat.app/atendimento/agente-ia/instrucoes.md). ### Recursos Úteis Links, e-mails, telefones, imagens e PDFs que o agente compartilha quando faz sentido. Imagens e PDFs vão como mídia no WhatsApp; links de agendamento são sugeridos ao marcar reuniões. ### Conhecimento * **Arquivos**: envie documentos (**Upload**) ou **Colar texto**. * **Sites**: importe páginas de um site (usa créditos de IA por página lida). * **Tabelas**: tabelas que o agente pode consultar. * **API Externa**: variáveis que chegam por integração. * **Profundidade da busca nos documentos**: **Precisa**, **Equilibrada** (recomendado) ou **Ampla**. ### Coleta de Dados ![Aba Coleta de Dados com os campos nome, empresa e usuários](https://mintcdn.com/stegia/H1B-GpiWPsLe8SyG/images/atendimento/agente-coleta.png?fit=max\&auto=format\&n=H1B-GpiWPsLe8SyG\&q=85\&s=5d7c122f9675aac41fdeec5f7440aa5f) Aba Coleta de Dados Campos que o agente pede ao cliente durante a conversa: **Telefone**, **Nome** e **E-mail** são preenchidos automaticamente quando já existem; adicione **Texto**, **Texto Longo**, **CPF**, **Data**, **Número**, **Seleção**, **Escolha Única**, **Múltipla Escolha** ou **Sim/Não**. ### Ações O que o agente faz sozinho, como transferir, aplicar etiqueta ou enviar os dados para outro sistema. Veja [Ações do agente](https://docs.brainchat.app/atendimento/agente-ia/acoes.md). ### Testar Converse com o agente antes de ligar no canal. ### Versões e Insights **Versões** guarda o histórico de alterações. **Insights** (em agentes já salvos) mostra conversas, desempenho e tokens usados. ## Ligar o agente Depois de salvar, deixe o agente **ativo** e confira os **Canais em que atua**. As conversas atendidas pela IA aparecem em **Conversas → Atendidas por IA**. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.