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-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údoconteú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 InteligentesIA → abaedite um agente → passo Base de conhecimentoConhecimento → Nova base

Passo a passo

  1. AbraEdite um agente (existente ou recém-criado) e vá ao passo Conhecimento. Clique em Nova base — abre a abajanela BaseBases de conhecimento e; clique em Nova base. de novo, agora dentro da janela, para abrir o formulário de criação.

🖼️ PRINT — AbaJanela BaseBases de conhecimento, aberta a partir do passo Conhecimento de um agente, com a lista de bases do tenant e o botão Nova base destacado no topo direito..

  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, noo tipoeditor de conteúdo aparece embaixo do formulário e muda conforme o Tipo: em Grupo de arquivos, aparece o editor de conteúdo. Colecole 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 dade 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.

  1. 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,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 o card daa base mostrapassa oa totalconstar na lista de "trechosBases indexados".de conhecimento, disponível para qualquer agente do tenant. Deixe a base com Status Ativo e vincule-aconfirme aoque agenteela 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