# 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](/books/agentes-de-ia/page/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)](/books/agentes-de-ia/page/configurar-seu-provedor-de-ia-chave-propria)), 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 1. 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. 2. 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. 3. 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. 4. Escolha o **Provedor** (obrigatório, exceto no tipo **Tabela**, que usa consulta exata) e clique em **Criar base**. 5. 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**. 6. 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**. 7. 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](/books/agentes-de-ia/page/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)](/books/agentes-de-ia/page/configurar-seu-provedor-de-ia-chave-propria)). - **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)](/books/agentes-de-ia/page/configurar-seu-provedor-de-ia-chave-propria) - [Criar um agente de IA no builder](/books/agentes-de-ia/page/criar-um-agente-de-ia-no-builder) - [Escrever boas instruções (prompt) para o agente](/books/agentes-de-ia/page/escrever-boas-instrucoes-prompt-para-o-agente) - [Monitorar uso e custos do agente](/books/agentes-de-ia/page/monitorar-uso-e-custos-do-agente)