Como criar um agente de IA e treinar com a base de conhecimento

O agente de IA dá a primeira resposta aos seus clientes no WhatsApp, Instagram e Messenger, usando as informações que você ensina a ele. Quando não sabe responder ou o cliente pede uma pessoa, ele passa a conversa para o seu time.

Criar o agente

1. Abra AI Studio › Agentes de IA.
2. Clique em + (Novo agente) para começar do zero, ou em Modelos para partir de um pronto: Agente de suporte, SDR ou Recepcionista.
3. Dê um Nome (por exemplo, "Atendimento Bella Moda") e uma Descrição, e clique em Criar agente.

O editor do agente abre em seguida. Ele salva sozinho enquanto você edita.

Escrever as instruções

Na aba Instruções, escreva como o agente deve se comportar. É aqui que você define o tom, o que ele pode responder e quando deve chamar uma pessoa. Por exemplo:

Você é a assistente da Bella Moda. Fale de forma simpática e direta. Responda dúvidas sobre produtos, trocas e entregas usando a base de conhecimento. Se a cliente quiser falar com uma pessoa, transfira para o departamento Vendas.

Dicas:

• Use Inserir variável dinâmica para dar ao agente a data e a hora atuais. Útil para instruções como "fora do horário comercial, avise que o time responde a partir das 9h".
• O botão Otimizar com IA reescreve suas instruções de forma mais clara e consome 1 crédito.

Escolher o que o agente pode fazer

Na aba Ações, ligue em Habilitar o que ele pode fazer e explique quando usar cada ação:

• Encerrar conversas
• Atribuir ao agente ou à equipe: é assim que ele passa a conversa para uma pessoa.
• Adicionar comentários
• Atualizar etiquetas do contato
• Atualizar campos do contato
• Atualizar pipeline

Em Ferramentas personalizadas você conecta o agente a sistemas externos por webhook. Por exemplo, para consultar o status de um pedido.

Criar a base de conhecimento

A base é onde ficam as informações que o agente consulta: políticas, preços, perguntas frequentes.

1. Abra AI Studio › Base de conhecimento.
2. Clique em + (Nova fonte), dê um Nome (por exemplo, "Política de trocas") e descreva em Descrição quando essa fonte deve ser usada. O agente lê essa descrição para decidir quando consultar a fonte.
3. Clique em Criar fonte.
4. Abra a fonte, clique em + (Novo documento) e escolha o Tipo:
   • Texto: cole o conteúdo.
   • FAQ: uma pergunta e a resposta.
   • Arquivo: PDF, DOCX, TXT, CSV, MD ou XLSX, até 20 MB.
5. Clique em Salvar documento.

O documento passa por Processando e fica Pronto em instantes. O agente só usa documentos prontos.

Vincular a base ao agente

1. Volte ao editor do agente, aba Conhecimento.
2. Clique em Adicionar e escolha as fontes.

Testar antes de colocar no ar

O editor tem um playground à esquerda. Converse com o agente na aba Conversa como se fosse um cliente. Na aba Campos do contato você simula os dados do cliente e vê o que o agente alteraria.

• Cada mensagem no playground consome 1 crédito.
• Ações como etiquetas e campos são só simuladas.
• Ferramentas personalizadas chamam o seu sistema de verdade, também no teste.

Colocar o agente para atender

1. Ative o agente pela chave no card dele. Agentes desativados não respondem.
2. Defina quando ele assume as conversas:
   • Agente de IA padrão, no topo de AI Studio › Agentes de IA: o agente assume as conversas novas sem responsável, em toda a organização ou só em alguns canais.
   • Manualmente na Inbox: no menu de atribuição da conversa, use Atribuir Agente de IA.
   • Por workflow: com uma ação de atribuição.

Depois que o agente transfere a conversa para uma pessoa, ele para de responder nela.

Créditos de IA

Veja o saldo e o extrato em Configurações › Créditos de IA.

Se os créditos acabarem, o agente para de responder, deixa um comentário interno e devolve a conversa para a fila do time. Documentos novos ficam como Aguardando créditos e são treinados sozinhos quando entrar saldo.

O que o agente não faz

• Não tem horário de atendimento próprio nem configuração de tom fora das instruções. Escreva isso nas Instruções.
• Não lê sites nem links automaticamente. A base aceita texto, FAQ e arquivos.
• Ele segue as suas instruções e a base, mas pode errar. Acompanhe as primeiras conversas e ajuste as instruções.

Quem pode criar agentes

Proprietários e Administradores. O perfil Agente não acessa o AI Studio.

Problemas comuns

• O agente não responde: confira se ele está ativado, se foi atribuído à conversa (ou definido como Agente de IA padrão para aquele canal) e se há créditos.
• "Nenhuma fonte disponível." ao vincular conhecimento: crie uma fonte em Base de conhecimento primeiro.
• Documento com status Erro: o arquivo pode estar vazio ou ilegível (por exemplo, PDF só com imagens). Envie uma versão com texto.
• "Os créditos de IA da sua empresa acabaram.": compre mais em Configurações › Créditos de IA.