> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.arklex.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Knowledge
> Manage documents and websites that simulated users can reference during a simulation.
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:
| Type | Description |
| ------------- | ----------------------------------------------------------- |
| **Documents** | Uploaded files (PDFs, text documents, and similar formats). |
| **Websites** | Web pages crawled and indexed from a URL. |
***
## Add documents
Navigate to **Knowledge** and select the **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:
Crawl and index a domain across linked pages. Set a domain URL and page limit (1–1,000).
Index a single URL or YouTube video. Best when you have one specific page or video to add.
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.