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.

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-iaCriar um agente de IA no builder). Bases se criam a partir da edição de um agente
  • Um provedor de IA cadastrado (veja configurar-provedor-iaConfigurar 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

  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-agente-iaCriar 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-provedor-iaConfigurar 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