Загрузка файлов в базу знаний

Поддерживаемые форматы

В базу знаний можно загрузить:

MD;
MDC;
TXT;
DOCX;
PDF;
CSV;
XLSX;
изображения PNG, JPEG, GIF, WebP, BMP, SVG, AVIF;
ZIP.

ZIP-архив до 500 МБ импортируется как папки и файлы внутри архива. Если архив больше 500 МБ, кабинет покажет ошибку размера.

CSV и XLSX

CSV и XLSX на вкладке "Загрузить" сохраняются как документы базы знаний: строки и листы преобразуются в текст/Markdown, чтобы агент мог искать по содержимому как по обычному материалу.

Если нужен редактируемый лист со строками, колонками, импортом и отдельными правами агента на изменение таблиц, используйте вкладку "Таблица", а не обычную загрузку файла.

ZIP-архивы

ZIP подходит для переноса целой структуры документации: папок, Markdown-файлов, документов, таблиц и изображений. При импорте архив раскладывается под корневую папку с названием ZIP-файла; если внутри архива уже есть такая корневая папка, лишний дубликат корня не создается.

Ограничения архива:

размер ZIP - до 500 МБ;
суммарный распакованный размер - до 500 МБ;
один файл внутри архива - до 25 МБ;
до 6000 записей, до 3000 файлов и до 2000 папок;
глубина пути - до 12 уровней;
длина сегмента пути - до 255 символов.

Служебные файлы вроде __MACOSX, .DS_Store и Thumbs.db пропускаются. Небезопасные пути, слишком глубокие пути и неподдерживаемые файлы не должны попадать в импортируемую структуру.

Изображения и ссылки Markdown

Изображения можно загрузить отдельными файлами или положить в ZIP рядом с Markdown. В архиве поддерживаются PNG, JPEG, GIF, WebP, BMP, SVG и AVIF. После загрузки такие изображения становятся отдельными материалами базы знаний и могут использоваться в предпросмотре Markdown.

Если Markdown ссылается на файл из той же базы знаний, например ![Схема](assets/schema.png) или [PDF](docs/rules.pdf), кабинет старается связать эту ссылку с загруженным материалом. Так в предпросмотре показываются картинки, а агенту проще понять, что к инструкции относится еще и связанный файл.

Распознавание изображений при загрузке

В форме загрузки можно выбрать режим распознавания изображений для поиска:

«Сначала оценить» — проверить выбранные файлы без импорта и показать для каждого режима количество изображений, примерное время и стоимость. Оценка не списывает кредиты;
«Не распознавать» — загрузить файлы без AI-анализа изображений;
«Только без описания в Markdown» — распознать изображения, у которых нет подписи или текста рядом в Markdown, и пропустить уже распознанные неизменившиеся изображения;
«Только нераспознанные» — не учитывать подписи Markdown, но переиспользовать готовые AI-описания изображений с тем же содержимым;
«Перераспознать все» — заново обработать каждое изображение, даже если для него уже есть AI-описание.

Для любого режима, кроме «Не распознавать», выберите язык AI-описаний: RU или EN. Этот выбор определяет язык текста, который AI добавит в поисковый контекст; язык исходного файла при этом не меняется.

После оценки выберите один из четырех режимов загрузки. Повторно выбирать файл или ZIP не нужно. Если режим выбран сразу, кабинет начинает загрузку без дополнительного подтверждения.

Готовое AI-описание хранится отдельно и не изменяет исходный Markdown. Поиск использует и текст Markdown, и описание изображения. Одинаковое изображение внутри одной базы распознается один раз по содержимому; если на него ссылаются несколько Markdown-файлов, описание помогает найти каждую связанную инструкцию. Отдельно загруженное изображение без Markdown также становится доступно поиску после распознавания.

Распознавание выполняется в фоне. Указанные перед запуском время и кредиты являются приблизительной оценкой. Сама оценка ничего не резервирует и не списывает; фактические кредиты рассчитываются для выполненных AI-вызовов.

Как загрузить

Нажмите кнопку «Настройки» с шестерёнкой справа от названия проекта и перейдите в базу знаний.
Нажмите «Добавить».
Выберите вкладку «Загрузить».
В форме загрузки перетащите файлы в выделенную область или выберите их на компьютере.
Проверьте список выбранных файлов, выберите режим распознавания изображений, а при включённом распознавании — язык описаний: RU или EN.
Если выбрано «Сначала оценить», нажмите «Оценить» и выберите подходящий режим по результату.
Нажмите «Загрузить».

Фоновая загрузка

После старта панель фоновой загрузки показывает:

текущий файл;
стадия "Загрузка", "Сохранение" или "Создание файлов из архива";
количество обработанных файлов внутри архива;
процент прогресса;
результат "Загрузка завершена" или "Загрузка с ошибкой".

Кнопка со стрелкой сворачивает или раскрывает подробности операции. После завершения загрузки её можно убрать из панели крестиком; загруженные материалы при этом остаются в базе знаний.

Передача обычного файла на сервер идёт в текущей сессии. Когда файл уже сохранён и появился в базе со статусом «Обработка», можно закрыть страницу: извлечение текста и добавление в поиск продолжатся на сервере. Кратковременный перезапуск сервиса не требует новой загрузки — незавершённая обработка продолжится автоматически.

Для ZIP есть два этапа. Пока браузер передаёт архив на сервер, на телефоне кабинет временно заблокирован. После того как сервер принял ZIP и началась стадия «Создание файлов из архива», можно продолжать работу или закрыть страницу: сервер завершит импорт самостоятельно.

Пока у материала стоит статус «Обработка», он ещё не участвует в поиске по базе знаний и не используется агентом в ответах. Дождитесь готового статуса. Загружайте файл заново только после статуса «Ошибка обработки», а не из-за обновления страницы или временного перезапуска сервиса.

Если обновить страницу или позже вернуться в кабинет в том же браузере, панель найдёт принятую сервером операцию и продолжит показывать её прогресс. Выбирать ZIP заново не нужно. Повторный выбор требуется только когда загрузка оборвалась до принятия архива сервером и кабинет прямо сообщает об этом.

Конфликты и сводка импорта

Если в выбранной папке уже есть материал с таким же названием, кабинет показывает конфликт и предлагает загрузить новый материал с другим названием, заменить существующий или отменить импорт. Для папок важно проверить, что именно будет заменено, чтобы случайно не удалить нужные вложенные материалы. Если конфликт появился во время фоновой обработки, эти же действия останутся доступны после перезагрузки страницы.

После успешного импорта кабинет показывает сводку: какая корневая папка создана, сколько папок и файлов добавлено, какие материалы заменены или переименованы и сколько файлов еще ожидают извлечения текста.

Частые ошибки

"Не удалось загрузить файл. Проверьте соединение и попробуйте снова" - вероятна проблема сети или временный сбой.
"Сервер вернул некорректный ответ после загрузки" - сначала обновите список материалов и проверьте, появился ли файл; не запускайте повторную загрузку вслепую.
"Загрузка архива прервалась до того, как сервер принял файл" - выберите тот же ZIP и запустите загрузку снова.
"Не удалось обработать архив" - сервер завершил операцию с ошибкой; откройте детали, исправьте указанный файл или структуру и повторите импорт.
"Обработка" висит долго - файл сохранён, но текст ещё извлекается или индексируется; до завершения он не участвует в поиске и ответах агента.
"Ошибка обработки" - текст не удалось подготовить; стоит проверить формат, размер и содержимое файла.

Если загрузка не удалась

Для отдельного файла повторите загрузку и проверьте его размер. Для больших наборов используйте ZIP до 500 МБ и следите за лимитами архива; если структура слишком большая, разбейте её на несколько архивов. Принятый сервером ZIP повторно не загружайте: обновите страницу и дождитесь восстановленного статуса. Выбирайте архив снова только после сообщения, что сервер не успел его принять, либо после завершившейся ошибки, когда нужные материалы не появились.