Skip to main content
The Knowledge section manages documents and websites that simulated users can reference during a simulation. Attaching knowledge to a scenario gives the simulated user access to specific content — useful for testing whether your agent responds faithfully to its source material.
Knowledge grounds what the simulated user knows and asks about — not the agent’s answers. Attaching the same material your agent relies on is a good way to test whether the agent stays faithful to it.

​
Knowledge types

Arklex supports two types of knowledge sources, both chunked and indexed so the simulated user can draw on their contents when forming conversation turns:

​
Add documents

Navigate to Knowledge and select the Documents tab.
Knowledge documents tab
Upload — Click Upload Document and select a file. Once uploaded, it’s processed and made available to attach to scenarios. Each entry shows its name, upload date, and processing status (Pending, Processing, Ready, or Failed). View — Click any row to see the document’s content and metadata. A document that fails to process shows an error with guidance on supported formats. Delete — Open the document’s detail page and use the delete action. Scenarios that reference it lose access to its content for future simulations.

​
Add websites

Navigate to Knowledge and select the Websites tab. Two options are available:

Add Domain

Crawl and index a domain across linked pages. Set a domain URL and page limit (1–1,000).

Add Link

Index a single URL or YouTube video. Best when you have one specific page or video to add.
Knowledge websites tab
Each website entry shows its URL, when it was added, and its processing status. Click any row to view the indexed content and metadata, or open its detail page to delete it.

​
Attach knowledge to scenarios

Once documents or websites are in the knowledge base, attach them to individual scenarios on the scenario detail page. A simulated user with attached knowledge references its contents when relevant during a conversation — which powers three kinds of testing:
  • Faithfulness testing — verifying the agent’s responses align with what a knowledgeable user would expect from documented facts.
  • Grounded evaluation — ensuring the agent doesn’t hallucinate information that contradicts the documents the user has access to.
  • Edge-case coverage — giving simulated users specific product specs, pricing tables, or policy details that reveal gaps in agent knowledge.

​
FAQ

Commonly supported formats include PDF, TXT, and DOCX. If a document fails to process, check that it isn’t password-protected and is within the supported file size limit.
It depends on the option. Add Domain crawls a domain and indexes multiple pages up to the maximum page count you set. Add Link indexes only the single URL or YouTube video you provide.
Content is indexed when you add the URL. Arklex doesn’t automatically re-crawl when the source page changes — delete and re-add the URL to refresh it.
Yes. A single document or website can be attached to as many scenarios as needed. Updating the source document doesn’t affect simulations that have already run.