Documentos de conhecimento do agente (RAG): vincular, criar, ordenar, formatos

Aprenda a carregar documentos na Base de conhecimento, vinculá-los ao seu agente de IA e ordená-los para que ele responda com informações reais do seu negócio.

Jun 26, 2026

Veja este passo no vídeo · A base de conhecimento: URLs e arquivos

Os documentos de conhecimento dão ao seu agente de IA informações concretas do seu negócio (preços, políticas, manuais, FAQs) para que ele responda com dados reais em vez de inventar. A Omnifox usa RAG: quando chega uma pergunta, ela busca os trechos mais relevantes dos seus documentos e os entrega ao agente como contexto.

Isso serve quando você quer que o agente cite suas condições de garantia, explique um produto ou siga um roteiro sem precisar colar tudo nas Instruções.

Antes de começar

  • A Base de conhecimento é do workspace: um mesmo documento pode ser vinculado a vários agentes.
  • Você precisa de permissão para editar agentes e a base de conhecimento.

Passo 1: Crie o documento na Base de conhecimento

  1. Abra a Base de conhecimento pelo menu (ou o botão Criar novo artigo dentro do agente, que a abre em uma nova aba).
  2. Escolha como carregá-lo:
    • Enviar arquivo: PDF, TXT, MD, CSV, DOC, DOCX, PNG, JPG ou WEBP (máx. 25 MB por arquivo).
    • Add URL: cole um endereço web e a Omnifox extrai o texto da página.
    • FAQ: escreva à mão uma pergunta e sua resposta.
  3. Salve. O documento entra em Processing enquanto é processado e os embeddings são gerados.
  4. Aguarde até ficar Ready. Apenas documentos em Ready são usados nas respostas.

Passo 2: Vincule o documento ao agente

  1. Vá em Agentes de IA e abra seu agente.
  2. Entre na aba Conhecimento.
  3. Na lista de documentos do workspace, ative os que quiser vincular. Eles aparecem em Artigos vinculados.
  4. Salve o agente.

Passo 3: Ordene por prioridade

Na aba Conhecimento, arraste os documentos vinculados para priorizá-los. Quando dois documentos se contradizem ou o contexto é limitado, o agente dá mais peso aos que estão mais acima. Coloque primeiro o mais atual e específico (lista de preços vigente, política vigente).

Verificação

  • Na Base de conhecimento, filtre por Ready e confirme que seu documento aparece.
  • Abra a aba Sandbox do agente e faça uma pergunta cuja resposta esteja no documento. Ele deve responder com esse dado.

Se não funcionar

  • Travado em Processing ou foi para Failed: verifique se o arquivo não está protegido por senha nem é um PDF escaneado sem texto. Envie novamente.
  • O agente ignora o dado: confirme que o documento está vinculado ao agente (não apenas criado) e em Ready.
  • Responde com info antiga: atualize ou substitua o documento; os embeddings são regerados ao salvar.

Dicas

  • Documentos curtos e por tema recuperam melhor do que um PDF gigante.
  • Para imagens (PNG/JPG/WEBP) a Omnifox extrai o texto visível; úteis para capturas de tabelas ou folhetos.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp