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.
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
- Abra a Base de conhecimento pelo menu (ou o botão Criar novo artigo dentro do agente, que a abre em uma nova aba).
- 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.
- Salve. O documento entra em Processing enquanto é processado e os embeddings são gerados.
- Aguarde até ficar Ready. Apenas documentos em Ready são usados nas respostas.
Passo 2: Vincule o documento ao agente
- Vá em Agentes de IA e abra seu agente.
- Entre na aba Conhecimento.
- Na lista de documentos do workspace, ative os que quiser vincular. Eles aparecem em Artigos vinculados.
- 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
Artigos relacionados
-
Crie seu primeiro agente de IA
Aprenda o que um agente de IA faz no Omnifox, como dar instrucoes, conecta-lo a um canal e testa-lo no sandbox antes de falar com clientes reais.
-
Como escrever boas instruções para seu agente de IA
Aprenda a redigir instruções claras para que seu agente de IA responda com o tom, os limites e as ações corretas.
-
Guia completo dos Agentes de IA
Os Agentes de IA a fundo, em 65 capítulos: criar, instruções, ferramentas, conhecimento, comportamento, teste, caixa de entrada, fluxos, análise e consumo, com cada opção explicada.
-
Conectar seu agente de IA ao WhatsApp, Instagram, Messenger e chat do site
Um agente sem canais não atende ninguém. Conecte-o ao seu WhatsApp, Instagram, Messenger ou ao chat do seu site na seção Conexões e ative-o para ele começar a responder.
-
Comece aqui: os Agentes de IA em 8 minutos
O essencial dos Agentes de IA em um vídeo curto: criar um agente, as instruções, ferramentas, conhecimento, canais, o teste, o horário e a passagem para uma pessoa.