Agent knowledge documents (RAG): link, create, order, formats
Learn how to add documents to the Knowledge Base, link them to your AI agent, and order them so it answers with real information from your business.
Watch this step in the video · The knowledge base: URLs and files
Knowledge documents give your AI agent concrete information about your business (pricing, policies, manuals, FAQs) so it answers with real data instead of guessing. Omnifox uses RAG: when a question comes in, it retrieves the most relevant chunks from your documents and feeds them to the agent as context.
Use this when you want the agent to quote your warranty terms, explain a product, or follow a script without you pasting everything into the Instructions.
Before you start
- The Knowledge Base belongs to the workspace: one document can be linked to several agents.
- You need permission to edit agents and the knowledge base.
Step 1: Create the document in the Knowledge Base
- Open Knowledge Base from the menu (or the Create new article button inside the agent, which opens it in a new tab).
- Pick how to add it:
- Upload a file: PDF, TXT, MD, CSV, DOC, DOCX, PNG, JPG, or WEBP (max 25 MB per file).
- Add URL: paste a web address and Omnifox extracts the page text.
- FAQ: type a question and its answer by hand.
- Save. The document goes to Processing while it is parsed and embeddings are generated.
- Wait until it turns Ready. Only Ready documents are used in answers.
Step 2: Link the document to the agent
- Go to AI Agents and open your agent.
- Open the Knowledge tab.
- In the list of workspace documents, toggle on the ones you want. They move into Linked articles.
- Save the agent.
Step 3: Order by priority
In the Knowledge tab, drag the linked documents to prioritize them. When two documents conflict or context is tight, the agent weighs the ones higher up more heavily. Put the most current, specific content first (live price list, current policy).
Verify
- In the Knowledge Base, filter by Ready and confirm your document is there.
- Open the agent's Sandbox tab and ask something whose answer lives in the document. It should reply with that fact.
If it doesn't work
- Stuck on Processing or went to Failed: make sure the file isn't password-protected or a scanned PDF with no text layer. Re-upload it.
- Agent ignores the fact: confirm the document is linked to the agent (not just created) and Ready.
- Answers with stale info: update or replace the document; embeddings regenerate on save.
Tips
- Short, single-topic documents retrieve better than one huge PDF.
- For images (PNG/JPG/WEBP) Omnifox extracts visible text, handy for screenshots of tables or flyers.
Related articles
Related articles
-
Create your first AI agent
Learn what an AI agent does in Omnifox, how to give it instructions, connect it to a channel and test it in the sandbox before it talks to real customers.
-
How to write good instructions for your AI agent
Learn how to write clear instructions so your AI agent replies with the right tone, limits and actions.
-
AI Agents complete guide
AI Agents in depth, in 65 chapters: creating, instructions, tools, knowledge, behavior, tester, inbox, workflows, analytics and usage, with every setting explained.
-
Connect your AI agent to WhatsApp, Instagram, Messenger and web chat
An agent with no channels serves nobody. Connect it to your WhatsApp, Instagram, Messenger or website chat from the Connections section, then switch it on so it starts replying.
-
Start here: AI Agents in 8 minutes
AI Agents essentials in a short video: creating an agent, its instructions, tools, knowledge, channels, the tester, hours and handing over to a person.