Documents & Knowledge
A central document library with folders, visibility scopes and preview – plus per-chat document knowledge (RAG) for grounded, cited answers.
The Documents area is where you store your files centrally, organize them into folders and subfolders, and decide who may see them. Most importantly, these documents become a knowledge base for the chat: you add selected files per chat, and the AI answers your questions from their content – with source citations. Kasimir automatically picks the right processing strategy (whole document in context, or targeted excerpt retrieval) depending on size and model.
What this area does
Upload and manage files – PDFs, Office and OpenDocument files, text, CSV, Markdown, HTML, XML, JSON and images.
Organize in folders – arbitrarily nested folders with emoji, color and description.
Control visibility –
Private(only you) orCompany-wide(everyone in the company).Preview – PDFs and images right in the browser; Office files are converted to a PDF preview server-side.
Use as chat knowledge – add documents per chat on purpose; the AI answers from them and cites the passages.
Uploading documents
Open the Documents area from the sidebar.
Click
Uploadat the top right and pick a file from your device.The file uploads and is processed immediately (text is extracted). The status moves from
ProcessingtoReady– or toFailedif no text could be obtained.
Each upload processes one file. The maximum file size is 25 MB.
Supported file types
Category | Formats |
|---|---|
| |
Microsoft Office |
|
OpenDocument |
|
Text & data |
|
Images |
|
Images are "read". On upload, a vision-capable AI model describes the image once as structured text (caption, recognized text/OCR, key elements). That text is stored and flows into chat knowledge just like a normal document – the original image stays available for viewing.
Visibility on upload
When uploading outside a folder you can choose between Private (the default – only you see the file) and Company-wide (everyone in the company).
When you upload inside a folder, the new file automatically inherits the folder's visibility – no separate choice needed. The active tab also sets the default: on the Shared tab uploads become company-wide, otherwise private.
Folders & organization
Tabs, search and view
Above the file list you'll find:
Tabs
All·Shared·Private– filter folders and files by visibility.Search – filters the current level by file and folder names.
View – toggle between Grid (with thumbnail) and List (with details and an actions menu).
Creating a folder
Click
Folder.Give it a name, optionally an icon (emoji) and a description.
Choose the visibility (
PrivateorShared).When a folder is open, new subfolders and uploads automatically land inside it (shown in the breadcrumb at the top).
Deleting a folder also deletes its subfolders, but the documents are kept (they move out of the folder). Deletion requires confirmation.
Managing files
In List view, the three-dot menu per file offers these actions:
Change visibility – switch between
PrivateandShare company-wide. Only the uploader or an admin may do this.Move to – into another folder or back to
General(no folder).Delete – with a confirmation prompt.
Project documents are managed inside their respective project and carry a Project label. They cannot be moved into folders here.
Preview
Clicking a file (status Ready or Failed) opens the preview:
PDFs and images are embedded and shown directly.
Office / OpenDocument files are converted to a PDF preview server-side and shown the same way.
All other formats offer a download of the original.
The preview also shows file size, type and a Download button for the original file.
Recently used (from chats)
At the very bottom – only at the root level and outside the Shared tab – you'll see Recently used (from chats). These are files you attached in chats (strictly private, visible only to you). Per file you can:
use
Save to libraryto keep the file permanently (private) in your documents,or delete it permanently.
Using documents as chat knowledge
This is the heart of the feature: documents become the AI's source of knowledge.
Nothing is loaded automatically. In a normal chat the AI uses only the documents you explicitly add for that chat. This protects context and tokens and keeps answers predictable.
Step by step
Open a chat. In the composer bar click the
Documentsbutton.The picker is grouped:
Private– your own private documents.Project– the current project's documents (only in a project chat).Company-wide– company documents, grouped by folder.
Tick the documents you want. The button's counter shows how many are selected. Only documents with status
Readyappear here.Ask your question. The AI answers from the selected content.
The selection is remembered per conversation.
Citations
When the AI falls back to targeted excerpt retrieval, it marks used passages inline with [1], [2], …. Below the answer you'll find the Sources panel with filename, page/section and a text excerpt. That makes every statement traceable – important for safety-critical or standards-related topics.
The AI is instructed to stay honest: if the provided documents don't cover a question, it says so explicitly. General knowledge is – if used at all – clearly labeled as such and not passed off as document content.
Assistants
In an Assistant chat, knowledge works differently: the knowledge assigned to the assistant is used automatically (linked company-wide documents and the assistant's own uploads) – independent of the manual picker. That is the assistant's own knowledge base.
How the AI processes your documents (strategies)
Depending on the size of the added documents and the context window of the chosen model, Kasimir automatically selects one of several strategies:
Strategy | Behavior | When |
|---|---|---|
Full context | The complete document texts are placed into the prompt. | When the sum of all tokens is below the threshold. |
RAG (excerpt retrieval) | Documents are split into sections, embedded, and only the most relevant passages are retrieved for the question. | When the documents are too large for full context. |
Hybrid | Small documents are inlined in full, large ones retrieved via excerpt search. | Optional power-user mode. |
Auto (default) | Automatically chooses between full context and RAG based on the token sum. | Default for normal chats. |
The default threshold is 50,000 tokens.
The threshold is additionally capped by the model's context window (minus a safety reserve of ~14,000 tokens for the system prompt, history, tools and answer). This way even a small-window model never overflows.
When switching to excerpt retrieval, documents not yet indexed are split and embedded on demand. While that happens you see a brief status note in the chat.
German-optimized search. Excerpt retrieval combines semantic similarity with a substring search that accounts for German compound words – so "Sockel" is also found inside "Sockelhöhe", for example. Both are fused and scoped to your added documents before the selection is cut.
Setting the strategy per project
In project chats the strategy can be fine-tuned. Inside the project, under the document strategy tab, you'll find:
Three tiles
Auto·Full·RAG(Hybrid + a manual threshold live underAdvanced).A capacity meter that compares your documents' token usage against the active model's usable budget (including a rough page estimate, ~600 tokens/page).
A breakdown of "in project" vs. "company-wide" plus the number of already indexed documents.
A
Reindexbutton that embeds documents still pending.
This setting controls only how added documents are processed – it does not load any documents into the chat automatically. Normal (project-less) chats always use Auto.
Visibility at a glance
Scope | Who sees it | Note |
|---|---|---|
Private | only you | Default when uploading outside a folder. |
Company-wide / Shared | everyone in the company | via the upload choice or the actions menu. |
Project | project members | managed inside the project. |
From chats | only you | private chat attachments; optionally promotable to the library. |
Limits & good to know
Maximum file size: 25 MB. Larger files are rejected.
Pure images as company knowledge only work via the image description (text is derived from them); pixels without text yield little.
Status
Failedusually means no text could be extracted (e.g. a scanned PDF without an OCR layer). The file can still be opened/downloaded but is not usable as a knowledge base.Changing visibility is restricted to the uploader or admins.
Token values are estimates; the actual strategy may vary slightly by model.
Search on the overview page filters file/folder names only (not full text) – content search happens in the chat via excerpt retrieval.