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 types

Arkdock supports two types of knowledge sources:

Type	Description
Documents	Uploaded files (PDFs, text documents, and similar formats).
Websites	Web pages crawled and indexed from a URL.

Both types are chunked and indexed so the simulated user can draw on their contents when forming conversation turns.

---

Documents

Navigate to Knowledge and select the Documents tab.

Uploading a document

Click Upload Document and select a file from your computer. Once uploaded, the document is processed and made available to attach to scenarios.

Each document entry in the list shows:

• Document name
• Upload date
• Processing status (Pending, Processing, Ready, Failed)

Viewing a document

Click any document row to view its content and metadata. Documents that fail to process show an error message with guidance on supported formats.

Deleting a document

Open the document detail page and use the delete action. Deleting a document removes it from the knowledge base. Scenarios that reference the deleted document will lose access to its content for future simulations.

---

Websites

Navigate to Knowledge and select the Websites tab.

Adding a website

Two buttons are available on the Websites tab:

• Add Domain — Crawl a domain and index content from multiple pages. Enter the domain URL and set a maximum page count (1–1,000). Use this for multi-page documentation sites or knowledge bases where you want Arkdock to follow links and extract content from many pages.
• Add Link — Index a single URL or YouTube video. Use this when you have one specific page or video to add.

Each website entry shows:

• The URL
• When it was added
• Processing status

Viewing a website

Click any website row to view the indexed content and metadata.

Deleting a website

Open the link detail page and use the delete action.

---

Attaching knowledge to scenarios

Once documents or websites are in the knowledge base, you can attach them to individual scenarios on the scenario detail page.

A simulated user with attached knowledge documents will reference their contents when relevant during a conversation. This is particularly useful for:

• Faithfulness testing — verifying that the agent’s responses align with what a knowledgeable user would expect based on documented facts.
• Grounded evaluation — ensuring agents don’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 can reveal gaps in agent knowledge.

---

FAQ

What file formats are supported for document uploads?

Commonly supported formats include PDF, TXT, and DOCX. If a document fails to process, check that it is not password-protected and is within the supported file size limit.

Does adding a website crawl linked pages?

It depends on which option you use. Add Domain crawls a domain and indexes content from multiple pages up to the maximum page count you configure. Add Link indexes only the single URL or YouTube video you provide.

How current is the indexed website content?

Content is indexed at the time you add the URL. Arkdock does not automatically re-crawl URLs when the source page changes. Delete and re-add the URL to refresh the indexed content.

Can I share knowledge items across multiple scenarios?

Yes. A single document or website can be attached to as many scenarios as needed. Updating the source document does not affect simulations that have already been run.