Knowledge Base
How Diska stores and retrieves knowledge for agents.
The Knowledge Base (KB) enables agents to answer based on documents, web pages and manual text.
Concept
- An organization can have multiple KBs.
- Each KB has its own instruction that guides retrieval.
- Each KB contains documents.
- An agent can have multiple KBs assigned.
Source types
| Type | Description |
|---|---|
manual | Text entered directly in the platform. |
pdf | Uploaded PDF; text is extracted and split into chunks. |
url | Imported web page. |
Site crawl is an ingestion method: it walks a domain and creates url documents, one per page.
Document lifecycle
- pending: waiting for processing.
- uploading: upload in progress (PDF).
- processing: extraction and chunking.
- indexing_pending: ready, waiting for indexing.
- ready: document available for retrieval.
- failed: processing error.
Indexing
After processing, chunks are embedded and indexed. The state can be:
pendingindexing_pendingindexedfailedskipped
Retrieval
At runtime, the agent can use retrieval modes:
retrieval: relevant chunks.full_doc_fallback: the full document when the chunk is not sufficient.instructions_only: only the KB instruction is used.empty: no documents included.
Assign to an agent
- Open the agent.
- Go to the Knowledge tab.
- Choose the KBs to enable.
- Save and test with the KB diagnostic tool.
Citations
When the KB is used, the runtime can return citations indicating which document and chunk originated the response.
Next
After configuring the Knowledge Base, validate the agent in the Test Center.

