Skip to main content

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.

📹 VÍDEO — Passo a passo completo: abrir o passo Conhecimento de um agente, criar uma base em Nova base, indexar um texto colado e um arquivo enviado, e reindexar. Cole o embed do YouTube neste ponto.

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 buildercriar-agente-ia) — 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)configurar-provedor-ia) — 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 PRINTjanela —lista Janelatodas Basesas debases conhecimento,da abertaconta, ae partir do passo Conhecimentomais de um agente,agente compode usar a listamesma de bases do tenant e o botão Nova base.base.

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

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

  3. Escolha o Provedor (obrigatório, exceto no tipo Tabela, que usa consulta exata) e clique em Criar base.

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

🖼️ PRINT — Editor de uma base do tipo Grupo de arquivos, com o campo Colar texto, os botões Adicionar texto e Enviar arquivo, e a lista de Arquivos com a contagem de trechos.

    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 buildercriar-agente-ia).

    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)configurar-provedor-ia).
    • 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