Knowledge
Document Uploads
Document uploads let you attach files to your workspace as knowledge sources. Agents can then use that content when answering questions.
Supported File Types
The current UI supports uploading common document formats like:
- plain text
- Markdown
- JSON
What Happens After Upload
After you upload a document, KriyaOS:
- stores the original file for audit and preview
- converts the content into canonical, editable Markdown
- indexes the canonical Markdown for agent retrieval
- marks the source as ready when indexing is complete
Open a ready document source to compare the original file with its Knowledge Markdown. You can correct the Markdown and choose Save & re-index to replace the content agents retrieve.
If AI cleanup is unavailable, KriyaOS indexes deterministic Markdown and shows a warning so you can review it. The original file is never overwritten.
To upload a newer version of a document, open the source and use Replace original on the Original document tab. KriyaOS re-runs normalization on the new file and re-indexes it. Replacing the original discards any prior Markdown edits, since the canonical content is regenerated from the new file.
Tip
Use a clear source name (e.g. “Pricing & Packages 2026-04”) so you can confidently attach it to multiple agents.
If You See "Pending Upload"
Some environments require an explicit “complete upload” step after the file upload finishes. If your UI shows this state, complete the upload so ingestion can start.