Переиндексация базы знаний Open WebUI: что проверить после смены модели
На странице · 3 разделов
Если в Open WebUI сменили модель поиска по документам, прежние векторы базы знаний нужно пересоздать через Reindex. Операция затрагивает все базы и удаляет их старые поисковые индексы перед восстановлением. Даже сообщение об успехе не доказывает, что каждый файл обработан: проверьте журнал и контрольный поиск; без резервной копии не запускайте это на рабочем сервере.
Поменяли модель, которая помогает Open WebUI находить фрагменты ваших документов, и старые файлы перестали находиться? Reindex пересоздаёт поисковые представления документов — векторы (числовые представления текста для поиска по смыслу). После смены такой модели старые и новые векторы не совместимы. Но кнопка работает со всеми базами знаний, а не только с одним тестовым документом. s1 s2
Инструкция по документации и исходному коду Open WebUI v0.12.2, проверенным 17 октября 2026 года. Редакция не запускала модель, интерфейс или переиндексацию. Это действие администратора уже работающего сервера, не домашний рецепт установки модели. Память, диск, длительность и выход в сеть зависят от выбранной модели поиска, количества файлов и места её запуска; универсальных требований эти источники не дают. Если модель поиска подключена к внешнему сервису, не отправляйте ему конфиденциальные документы без разрешения вашей организации. s1 s2
Что подготовить до нажатия Reindex?
- Уточните, какая модель поиска сейчас выбрана в Settings → Admin → Documents и где она выполняется. Для первых испытаний используйте свой несекретный файл и изолированную копию установки. Смена только размера фрагмента не требует немедленной переиндексации: старые фрагменты продолжают работать, но для единообразия их можно пересоздать позже. Смена модели поиска требует пересоздания старых векторов. s1
- Попросите администратора сделать и проверить восстановление резервной копии данных и поискового хранилища по правилам именно вашей установки. Исходный код v0.12.2 удаляет старую коллекцию базы до обработки её файлов. Если нет проверенного пути восстановления и окна для работ, не запускайте Reindex на рабочем экземпляре. s2
- Подготовьте контрольный учебный файл, например собственную заметку «Доставка назначена на 14 мая». Убедитесь, что он находится в базе знаний, и зафиксируйте его извлечённый текст и ожидаемый найденный фрагмент. Векторный поиск и ответ модели — разные этапы: после операции надо проверить именно источник ответа. s1
Как переиндексировать и проверить результат?
Администратор меняет модель поиска в Settings → Admin → Documents, затем там же нажимает Reindex. Дождитесь завершения на тестовой копии, не обрывая работу во время обработки файлов. Операция пересобирает фрагменты и векторы для документов баз знаний; прикреплённые только к отдельным чатам файлы она не обрабатывает. s1 s2
После этого проверьте серверный журнал на ошибки обработки каждого файла и задайте вопрос по учебной заметке: «На какое число назначена доставка?». Найдите в показанных источниках фрагмент с 14 мая и сверьте его с самой заметкой. Не выдумывайте ответ модели и не считайте зелёное сообщение или ответ HTTP доказательством успеха: в исходнике v0.12.2 ошибки отдельных файлов записываются в журнал, но обработчик всё равно возвращает true. Если фрагмента нет или файл пропущен, не переносите настройку в рабочую базу; выясните причину по журналу и проверьте сохранённый извлечённый текст. s1 s2
Когда Reindex не поможет?
При смене извлечения текста из PDF или настроек OCR (распознавания текста на скане) эта кнопка не открывает старые файлы повторно. Загрузите учебный документ заново и сверьте извлечённый текст до проверки поиска. Файлы, загруженные только в чат, также не обновятся через Reindex баз знаний: после смены модели их надо загрузить заново. s1
Начните с различия между извлечением текста и индексом, а после пробного восстановления перейдите к проверке поиска с цитатами. Основной следующий шаг — сверить найденный фрагмент своего контрольного файла и журнал ошибок; правильный на вид ответ без источника недостаточен. s1
Источники
- Open WebUI Docs — RAG: Changing RAG Settings After Initial Setup — revision 416b3593adc7a869502cfcfd127050259ad7a86e. Получено 17.10.2026.
- Open WebUI v0.12.2 — knowledge.py, ReindexKnowledgeFiles — revision 6a18585ff4c2e5f6805f682222cfbc46dc669ef8. Получено 17.10.2026.