# База знаний с семантическим поиском

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

Мы сделали базу знаний, где поиск работает по смыслу — и одинаково доступен человеку через сайт и агенту через MCP.

## Как устроено

**Источник — репозитории.** Документация лежит в Git и правится как код: через merge request с ревью. Никаких «правок в вебе», которые потом невозможно отследить.

**Индексация.** Содержимое разбирается на разделы и превращается в эмбеддинги. Хранится в базе рядом с полнотекстовым индексом.

**Гибридный поиск.** Два поиска сразу: по смыслу и по словам. Результаты объединяются, затем реранкер переупорядочивает кандидатов — она сравнивает запрос и найденный фрагмент целиком и ставит наверх то, что действительно отвечает на вопрос.

**Работа с разделами.** Агент может не только прочитать документ, но и получить его оглавление, вытащить конкретный раздел и точечно его исправить — без загрузки и перезаписи всего файла. Правка сразу уходит коммитом, индекс обновляется сам.

**Несколько контуров.** Инженерная база и база поддержки разделены: разная аудитория, разная предметная область, свои хранилища. Общие у них только вычислительные ресурсы.

## Что это даёт

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