Uploading Files¶
The Knowledge Base lets you upload documents that enhance AI responses with context about your work. When you chat with AI in a project, it can reference these files.
Accessing the Knowledge Base¶
- Open a project.
- Click the Knowledge Base tab (📎).
Uploading Files¶
Editor or Admin required
You need the Editor or Admin role to upload files.
Click to Upload¶
- Click the upload area ("Click to upload or drag and drop").
- Select one or more files from your computer.
Drag and Drop¶
- Drag files from your desktop or file explorer.
- Drop them onto the upload area.
Files are uploaded and processed immediately. A progress bar shows the upload status.
Supported File Types¶
| Category | Extensions |
|---|---|
| Documents | .pdf, .txt, .md |
| Code | .py, .js, .ts, .jsx, .tsx, .html, .css, .json, .yaml, .yml, .xml, .sql, .sh, .java, .c, .cpp, .h, .go, .rs, .rb, .php |
| Data | .csv |
Maximum file size: 10 MB per file.
You can upload multiple files at once.
How Files Are Processed¶
When you upload a file, Ogadu:
- Reads the file content.
- Splits it into smaller chunks (shown as "chunk count" in the file list).
- Creates embeddings — mathematical representations that allow the AI to search and reference the content.
This process uses credits (the "Embedding" operation type on your billing page).
File List¶
After uploading, each file appears in the list showing:
| Info | Description |
|---|---|
| Icon | 📄 PDF, 💻 Code, 📝 Markdown, ⚙️ Config/Data |
| Filename | The original file name. |
| Size | File size (in KB or MB). |
| Chunks | Number of text chunks created from the file. |
| Date | Upload date. |
Downloading Files¶
Click the download icon on any file to download the original.
Deleting Files¶
Admin only
Only project admins can delete files from the Knowledge Base.
- Click the delete icon on the file.
- Confirm the deletion.
Warning
Deleting a file removes it and its embeddings permanently. The AI will no longer reference this file in future conversations.
Budget Impact¶
File uploads consume credits because of the embedding process. If your project has a budget limit and it's been reached, uploads will be blocked until the budget is increased or reset.
See Budget Caps for more information.