Alimentar a base de conhecimento (upload de documentos / RAG)

Ensine o agente com os seus próprios materiais: cole textos ou envie arquivos (FAQ, manual, catálogo) e o AtendeBot indexa tudo para o agente consultar durante o atendimento.
🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.
Objetivo
Criar uma base de conhecimento e alimentá-la com textos e documentos para o agente responder com base neles (RAG).
Pré-requisitos
Perfil Administrador
Módulo Agentes Inteligentes ativo
Um agente criado, mesmo que Rascunho (veja Criar um agente de IA no builder). Bases se criam a partir da edição de um agente
Um provedor de IA cadastrado (veja Configurar seu provedor de IA (chave própria)), obrigatório para indexar o conteúdo, exceto no tipo Tabela
Acesse pelo computador: esta tela não está disponível no celular
Tempo estimado
10 minutos.
Caminho de acesso
Bots → Agentes IA → edite um agente → passo Conhecimento → Nova base
Passo a passo
Edite um agente (existente ou recém-criado) e vá ao passo Conhecimento. Clique em Nova base. Abre a janela Bases de conhecimento; clique em Nova base de novo, agora dentro da janela, para abrir o formulário de criação.
A janela lista todas as bases da conta, e mais de um agente pode usar a mesma base.
Preencha o Nome e escolha o Tipo: Grupo de arquivos, Perguntas e Respostas ou Tabela. O tipo não muda depois de criada a base.
Em Quando usar, descreva quando o agente deve consultar esta base (ex.: "Use para responder sobre preços e disponibilidade de produtos"). Esse texto vira a descrição da ferramenta que o agente usa para decidir quando abrir a base.
Escolha o Provedor (obrigatório, exceto no tipo Tabela, que usa consulta exata) e clique em Criar base.
Com a base salva, o editor de conteúdo aparece embaixo do formulário e muda conforme o Tipo: em Grupo de arquivos, cole um texto no campo Colar texto e clique em Adicionar texto, ou clique em Enviar arquivo para subir um documento (txt, md, csv, pdf, docx); em Perguntas e Respostas, adicione pares de pergunta e resposta; em Tabela, monte colunas e linhas à mão ou clique em Importar csv/xlsx.
Confira a lista Arquivos (ou Perguntas e respostas/a tabela, conforme o tipo), que mostra quantos trechos foram indexados. Para reprocessar tudo após mudanças num Grupo de arquivos, clique em Reindexar.
Feche a janela Bases de conhecimento e, de volta ao passo Conhecimento do agente, marque a base na lista para vinculá-la a ele. Para um Grupo de arquivos ou uma Tabela, o atalho Upload rápido (DOCX ou CSV) cria a base, indexa o arquivo e já vincula ao agente num só passo.
Resultado esperado
Cada texto ou arquivo indexado aparece na lista com o número de trechos, e a base passa a constar na lista de Bases de conhecimento, disponível para qualquer agente do tenant. Deixe a base com Status Ativo e confirme que ela está marcada no passo Conhecimento do agente (veja Criar um agente de IA no builder).
Erros comuns
Sintoma: aparece "Selecione um provedor de IA para indexar o conteúdo". Solução: escolha um Provedor antes de criar a base. Bases de arquivos e de perguntas e respostas dependem dele para indexar.
Sintoma: aparece "Este provedor não tem chave configurada". Solução: cadastre ou corrija a chave em Provedores (veja Configurar seu provedor de IA (chave própria)).
Sintoma: o agente não usa o conteúdo da base. Solução: confira se a base está com Status Ativo, se foi marcada no passo Conhecimento do agente e se o texto de Quando usar descreve bem a situação de uso.
Artigos relacionados
Configurar seu provedor de IA (chave própria)
Criar um agente de IA no builder
Escrever boas instruções (prompt) para o agente
Monitorar uso e custos do agente