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

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

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

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 записей, до 2000 файлов и до 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), кабинет старается связать эту ссылку с загруженным материалом. Так в предпросмотре показываются картинки, а агенту проще понять, что к инструкции относится еще и связанный файл.

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

Открыть "Настройки" -> "База знаний".
Нажать "Добавить".
Выбрать вкладку "Загрузить".
Перетащить файлы в область загрузки или выбрать их на компьютере.
Проверить список выбранных файлов.
Нажать "Загрузить".

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

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

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

На телефоне загрузка блокирует кабинет до завершения. Это нормально: пользователь должен дождаться окончания операции.

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

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

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

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

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

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

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

Где это в интерфейсе

Основные элементы раздела:

пункт «Настройки» в боковом меню
страница настроек проекта
кнопка добавления материала в базу знаний
кнопка добавления материала в пустой базе знаний
форма материала базы знаний
вкладка загрузки документов
форма загрузки документов
кнопка загрузки документов