Галоўнае
Не змяняйце актыўную калекцыю на месцы. Збярыце новую версію асобна, праверце паўнату, retrieval, ACL і выдаленне састарэлых крыніц, затым атамарна пераключыце актыўны alias і захавайце папярэднюю версію для хуткага адкату.
RAG часта запускаюць як імпарт: загрузілі дакументы, пабудавалі embeddings — гатова. У працоўнай сістэме база ведаў жыве. Палажэнні змяняюцца, файлы выдаляюцца, правы адклікаюцца, мадэль embeddings абнаўляецца. Самая непрыемная памылка — часткова абнавіць актыўны індэкс і некалькі гадзін адказваць з сумесі старых і новых даных.
Мы аддаем перавагу падыходу да базы ведаў як да версіі праграмы: сабраць асобна, праверыць, пераключыць і мець магчымасць адкаціць.
Не абнаўляйце актыўную калекцыю «на месцы»
Калі pipeline выдаліў старыя chunks, а сэрвіс embeddings упаў на сярэдзіне новых, актыўная база застанецца няпоўнай. Карыстальнік не ўбачыць тэхнічную памылку — ён проста атрымае ўпэўненае «інфармацыі няма».
Бяспечней ствараць новую версію:
- зафіксаваць manifest крыніц;
- спампаваць і праверыць дакументы;
- нармалізаваць і падзяліць тэкст;
- пабудаваць embeddings у staging collection;
- праверыць колькасць аб'ектаў і кантрольныя запыты;
- атамарна пераключыць alias актыўнай версіі;
- захаваць папярэднюю версію для rollback.
Пакуль новы індэкс не прайшоў gate, карыстальнікі працягваюць працаваць са старым.
Manifest робіць абнаўленне тлумачальным
Для кожнай крыніцы карысна захоўваць:
- ID і canonical URL;
- checksum змесціва;
- версію або дату дзеяння;
- уладальніка;
- ACL і клас даных;
- parser/chunking version;
- embedding model version;
- час паспяховай індэксацыі.
Тады можна адказаць, чаму дакумент трапіў у канкрэтную зборку, і пераапрацаваць толькі змененыя крыніцы. Адзін і той жа manifest павінен даваць той жа набор аб'ектаў — гэта аснова ідэмпатэнтнасці.
Якія праверкі патрэбныя да пераключэння
Паўната. Колькасць дакументаў і chunks адпавядае manifest; абавязковыя крыніцы прысутнічаюць.
Парсінг. Няма пустых дакументаў, пашкоджаных табліц і старонак, якія складаюцца з меню або паўторных загалоўкаў.
Retrieval probes. Для невялікага набору вядомых пытанняў патрэбныя фрагменты трапляюць у top-k.
Правы. Ролі бачаць толькі дазволеныя маркеры.
Актуальнасць. Адкліканы дакумент адсутнічае, новы мае правільны статус і дату.
Сумяшчальнасць. Праграма разумее схему метаданых новай версіі.
Адзін паспяховы запыт «што такое кампанія» нічога не правярае. Probe-набор павінен змяшчаць важныя, рэдкія і праблемныя дакументы.
Пераключэнне павінна быць атамарным
Праграма чытае лагічнае імя накшталт knowledge_active, а не жорстка зададзены ID калекцыі. Пасля ўсіх праверак alias адным дзеяннем указвае на новую версію. Новыя запыты ідуць туды; пачатыя запыты завяршаюцца на папярэдняй.
Калі пошук, citations або permission tests пагоршыліся, alias вяртаецца назад. Rollback не павінен патрабаваць паўторнай індэксацыі — інакш гэта не хуткі адкат.
У адным з нашых RAG-праектаў актыўная версія пераключаецца толькі пасля праверкі колькасці points і probe search. Збой MinIO, embeddings, PostgreSQL або Qdrant пакідае папярэднюю версію актыўнай. Гэта не «складаная AI-магія», а нармальная транзакцыйная дысцыпліна вакол некалькіх нетранзакцыйных сістэм.
Чарга індэксацыі павінна перажываць перазапуск
Вялікі імпарт рэдка заканчваецца за адзін HTTP-запыт. Патрэбная durable queue з lease, пацвярджэннем выканання і вяртаннем завіслай задачы. Паўторная апрацоўка не павінна ствараць дублікаты — кожны дакумент і chunk маюць стабільны ключ версіі.
Асобныя liveness і readiness дапамагаюць не накіроўваць трафік у працэс, які запушчаны, але яшчэ не можа звяртацца да індэкса або базы. Гэта асабліва важна падчас абнаўлення залежнасцей.
Выдаленне важнейшае за даданне
Каманды добра тэстуюць з'яўленне новага дакумента і горш — знікненне старога. Але адкліканая інструкцыя або права доступу ствараюць большую рызыку.
Для выдалення патрэбныя tombstone або manifest diff, праверка адсутнасці chunks ва ўсіх актыўных слаях, ачыстка кэша і тэст па ўнікальным маркеры выдаленай крыніцы. Старыя версіі індэкса можна захоўваць для rollback абмежаваны час, але доступ да іх павінен заставацца закрытым.
Не змяняйце ўсё адначасова
Новая мадэль embeddings, іншы chunk size, reranker і новы prompt у адной версіі не дазволяць зразумець прычыну паляпшэння або дэградацыі. Па магчымасці змяняйце адзін слой і параўноўвайце на тым жа наборы. Калі міграцыя вымушана комплексная, захавайце абедзве версіі і правядзіце shadow або A/B-праверку без змешвання карыстальніцкіх адказаў.
Што паказваць уладальніку базы
Тэхнічнага «паспяхова» мала. Патрэбная зразумелая справаздача:
- якія крыніцы дададзеныя, змененыя і выдаленыя;
- якія не апрацаваліся і чаму;
- якая версія актыўная;
- калі была апошняя паспяховая зборка;
- якія кантрольныя пытанні прайшлі;
- ці можна адкаціць;
- хто пацвердзіў публікацыю.
Так база ведаў перастае быць чорнай скрыняй каманды AI і становіцца кіраваным карпаратыўным рэсурсам.
Release checklist версіі RAG
- Новы індэкс сабраны асобна ад актыўнага.
- Manifest, схемы і версіі мадэляў захаваныя.
- Правераныя паўната, retrieval, citations і ACL.
- Пераключэнне alias атамарнае.
- Папярэдняя версія даступная для хуткага rollback.
- Паўторы pipeline ідэмпатэнтныя.
- Збой любой залежнасці не псуе актыўную версію.
- Выдаленне і адкліканне правоў правераныя гэтак жа, як даданне.
Калі база абнаўляецца часта, гэты pipeline каштоўнейшы за яшчэ адну наладку промпта. Карыстальнік даруе крыху сухі адказ. Адказ па скасаваным дакуменце — наўрад ці.
Параўнанне
Кантрольныя пункты абнаўлення
| Этап | Праверка | Вынік |
|---|---|---|
| Manifest | Крыніцы, checksum, ACL | Зразумелая версія зборкі |
| Staging | Парсінг і embeddings | Актыўная база не закранутая |
| Probe | Вядомыя пытанні і ролі | Падстава для пераключэння даказаная |
| Switch | Alias і rollback | Кароткая атамарная змена |
Што праверыць
Перад публікацыяй версіі
- Новая калекцыя сабраная асобна ад актыўнай.
- Правераныя паўната, retrieval, citations і ACL.
- Выдаленне адкліканых крыніц пратэставанае.
- Паўтор pipeline не стварае дублікатаў.
- Збой залежнасцей пакідае папярэднюю версію актыўнай.
Як мы падыходзім да задачы
У нашым RAG-патэрне staging-індэкс пераключаецца толькі пасля праверкі колькасці points і кантрольнага пошуку; збой MinIO, embeddings, PostgreSQL або Qdrant не псуе папярэднюю працоўную версію.