# 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.

<p class="callout warning">🧩 Este recurso faz parte do módulo <strong>Agentes Inteligentes</strong>. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).</p>

<p class="callout success">📹 <strong>VÍDEO</strong> — Passo a passo completo: criar uma base em <strong>Nova base</strong>, indexar um texto colado e um arquivo enviado, e reindexar. Cole o embed do YouTube neste ponto.</p>

## 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 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
- Acesse pelo computador — esta tela não está disponível no celular

## Tempo estimado
10 minutos.

## Caminho de acesso
**Bots → Agentes Inteligentes** → aba **Base de conhecimento** → **Nova base**

## Passo a passo
1. Abra a aba **Base de conhecimento** e clique em **Nova base**.

<p class="callout info">🖼️ <strong>PRINT</strong> — Aba <strong>Base de conhecimento</strong> com o botão <strong>Nova base</strong> destacado no topo direito.</p>

2. Preencha o **Nome** e escolha o **Tipo**: **Grupo de arquivos**, **Perguntas e Respostas** ou **Tabela**.
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, no tipo **Grupo de arquivos** aparece o editor de conteúdo. 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).

<p class="callout info">🖼️ <strong>PRINT</strong> — Editor da base com o campo <strong>Colar texto</strong>, os botões <strong>Adicionar texto</strong> e <strong>Enviar arquivo</strong>, e a lista de <strong>Arquivos</strong> com a contagem de trechos.</p>

6. Confira a lista **Arquivos**, que mostra quantos trechos foram indexados. Para reprocessar tudo após mudanças, clique em **Reindexar**.

## Resultado esperado
Cada texto ou arquivo indexado aparece na lista com o número de trechos, e o card da base mostra o total de "trechos indexados". Deixe a base com **Status** **Ativo** e vincule-a ao agente no passo **Conhecimento** (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)