Knowledge Base Upload

Supported formats

You can upload to the knowledge base:

• MD;
• MDC;
• TXT;
• DOCX;
• PDF;
• CSV;
• XLSX;
• PNG, JPEG, GIF, WebP, BMP, SVG, AVIF images;
• ZIP.

A ZIP archive up to 500 MB is imported as folders and files from the archive. If the archive is larger than 500 MB, the cabinet will show a size error.

CSV and XLSX

CSV and XLSX on the "Upload" tab are saved as knowledge base documents: rows and sheets are converted to text/Markdown so the agent can search their content like a regular material.

If you need an editable sheet with rows, columns, import, and separate agent permissions for changing tables, use the "Table" tab instead of a regular file upload.

To transfer folders and related files, use ZIP import.

How to upload

• Select the Settings gear button to the right of the project name, then open Knowledge Base under Project data.
• Click Add.

• Select the Upload tab.
• In the upload form, drag files to the highlighted area or select them on your computer.

• Check the selected files.
• If the selected files include images or ZIP archives, choose an image recognition mode.
• When recognition is enabled, select the description language: RU or EN.
• If you selected “Estimate first,” click Estimate and choose a suitable mode from the result.

• Click Upload.

Recognition modes, description language, and cost estimation are covered in image recognition.

Background loading

After start, the background upload panel shows:

• current file;
• stage "Uploading", "Saving" or "Creating files from the archive";
• number of processed files inside the archive;
• percentage of progress;
• result "Upload completed" or "Upload with error".

On a computer, the arrow button collapses or expands the operation details. After uploading finishes, the cross button removes it from the panel; the uploaded materials remain in the knowledge base.

On a phone, the panel appears during uploading or when an error occurs, and disappears automatically after successful completion. While files are being transferred from the device, the upload window temporarily blocks other cabinet actions.

Transfer of a regular file to the server runs in the current session. Once the file is saved and appears in the knowledge base with the Processing status, you may close the page: text extraction and search indexing continue on the server. A short service restart does not require another upload because unfinished processing resumes automatically.

While a material has the Processing status, it is not yet included in knowledge-base search or used by the agent in replies. Wait for a ready status. Upload the file again only after a Processing error, not because the page was reloaded or the service restarted temporarily.

Frequent errors

• “Important file storage is full” — knowledge-base materials use the important file share in project storage. Check its free space: free space in the incoming share is not used for this upload automatically. Increase the important file share or total storage capacity, then retry the upload.
• “The file could not be uploaded. Check your connection and try again” - there may be a network problem or a temporary failure.
• “The server returned an incorrect response after uploading” - refresh the material list and check whether the file appeared before starting another upload.
• “The archive upload stopped before the server accepted the file” - select the same ZIP and start the upload again.
• “The archive could not be processed” - the server ended the operation with an error; review the details, fix the reported file or structure, and retry the import.
• “Processing” hangs for a long time - the file is saved, but its text is still being extracted or indexed; it is not included in search or agent replies until this completes.
• "Processing error" - the text could not be prepared; it is worth checking the format, size and contents of the file.

Retrying an Upload

For a single file, retry after a completed failure and check its size. For an archive, first check import status and replacement rules. If the name is already used, choose renaming, replacement, or cancellation; inspect a folder before replacing it.