ИИ-ассистент поиска по wiki, инструкция

Сервис «RAG · Orticon Wiki» — помощник по внутренней базе знаний: ищет в статьях и файлах (PDF, XLSX, DOCX) нужные фрагменты и отвечает на вопросы по учёту. Открыть можно с любого компьютера внутренней сети, регистрация не нужна.

В интерфейсе три вкладки:

• Поиск — находит фрагменты статей и файлов в базе знаний;
• Чат — ИИ-ассистент (ИИ-агент): сам ищет нужные страницы в базе знаний, читает их и отвечает со ссылками на источники;
• Индексация — для администратора (описана в свёрнутом разделе в конце статьи).

Вкладка «Поиск»

Введите запрос в поле и нажмите «Найти» (или Enter). Сервис вернёт до 10 самых релевантных фрагментов: название статьи (по клику открывается в вики), название раздела и отрывок текста. Сокращения в запросе расшифровываются автоматически (например, ДДС — «отчёт о движении денежных средств»), из файлов фрагменты отмечены названием: «Файл: НАПФ.pdf (страница 3)».

Реранкинг — вторичная оценка релевантности: специальная модель «перечитывает» запрос вместе с каждым найденным фрагментом и переставляет результаты так, чтобы сверху оказались не просто похожие по словам, а те, что действительно отвечают на вопрос. Рядом с каждым результатом указана оценка модели (реранк) — чем выше, тем точнее попадание.

Поиск «Годные остатки»: сверху — статья с тем же названием, ниже — связанные темы

На примере: по запросу «Годные остатки» в первом результате — статья с тем же названием, далее — отчёты и обработки по смежным темам. Полезно смотреть не только на первый результат: соседние фрагменты часто дополняют ответ.

Пара советов:

• Задавайте запрос коротко и по ключевым словам: название документа, форма отчёта, название продукта.
• Если ничего не нашлось — переформулируйте запрос (другое слово от того же термина) или задайте вопрос во вкладке «Чат»: ассистент сам расширит поиск несколькими формулировками.

ИИ-ассистент (вкладка «Чат»)

Ассистент отвечает на вопросы по бухгалтерскому и налоговому учёту, опираясь на базу знаний. Он работает как ИИ-агент — ищет в базе знаний сам и отвечает только по найденному:

• Вы задаёте вопрос — ассистент находит связанные страницы (семантический поиск с моделью релевантности), при необходимости смотрит заголовки статей, затем читает найденные страницы (из файлов — наиболее релевантные секции) и готовит краткий, структурированный ответ.
• Пока вопрос обрабатывается, в окне чата видно, что делает ассистент: «Поиск: …», «Смотрю индекс статей: …», «Читаю страницу: …».
• Если в вопросе есть сокращения (ДДС, ОПС, НПФ и т.п.), ассистент расшифрует их сам.
• Ответ содержит ссылки на источники: нумерованные цитаты (1), (2) и список «Источники» под ответом. Кликабельны — ведут на статью в вики (файлы — по имени файла).
• Ассистент отвечает только по базе знаний: если информации в ней нет, он об этом честно говорит, не выдумывает цифры и реквизиты.
• Диалог можно продолжать — уточняющие вопросы учитываются в контексте. Кнопка «Новый чат» начинает тему с чистого листа.
• Предыдущие чаты из вашего браузера сохраняются в списке над чатом — можно вернуться к любому и продолжить.
• Если вопрос о конкретном продукте (ЕПС, УИК, УНПФ, УСК, Лизинг, НУЕПС, ФВ, УМФО, XBRL и др.), назовите его — ассистент посмотрит статьи нужного продукта.

Хороший ответ — пример

Вопрос «что такое Годные остатки?» — определение и пошаговый порядок отражения в учёте

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

Когда ответ «так себе» — и почему это нормально

Вопрос «расскажи про унпф» — ответ честный, но бедный: в базе знаний пока мало статей по теме

Здесь ассистент ответил честно, но кратко: в базе знаний по теме УНПФ пока мало содержательных статей (разделы в разработке, описания пустые). Ассистент не заполняет пробелы выдуманными фактами — это особенность, а не сбой.

Как получить полнее ответ:

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

Когда ассистент не отвечает

Два случая: вопрос вне области учёта и непонятный запрос — ассистент сообщает причину и просит уточнить

Это не сбой, а штатная работа. Два случая:

• Вопрос не про учёт (например, «купи мне авиабилет»). Ассистент вежливо сообщает, что вопрос вне его компетенции, и напоминает, по каким темам он консультирует.
• Запрос непонятен (например, «бki» или «расскажи про версию 5»). Ассистент просит уточнить: что именно нужно сделать — провести документ, настроить отчёт, проверить проводку.

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

Для администратора: вкладка «Индексация»

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

Кнопка	Что делает
Запустить индексацию	Инкрементальный прогон: добавляются новые статьи, обновляются изменённые, удалённые из вики — вычищаются из индекса. Файлы (PDF/XLSX/DOCX) обновляются по хешу содержимого.
Полный реиндекс	Полностью очищает индекс и состояние, затем пересобирает всё с вики, включая файлы. Подтверждается отдельным диалогом. Использовать при первом заводе, после смены моделей или правил нарезки текста, а также если после инкрементального прогона поиск «отстаёт» от вики.

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

Когда именно нужен полный реиндекс:

• после изменения правил очистки/нарезки текста (модули cleaner.py, chunker.py) — меняется идентификатор точек;
• после смены эмбеддинговой или реранк-модели;
• после инкрементального прогона, который завершился с ошибкой, — сначала смотреть поле «Ошибка» в статусе, затем повторить.

Состояние индекса хранится в служебных файлах (index_state.json — версии статей, file_index_state.json — хеши файлов), история диалогов — в chat_history.json. Хранятся рядом с сервером.

Быстрые проверки при неполадках:

Симптом	Что проверить
Чат не находит новую статью	Запущена ли индексация (поиск идёт по индексу, а не по живой вики).
В выдаче нет оценок «реранк» (только «скор»)	Реранкер не работает (нет GPU/CUDA) — поиск деградирует до векторного сходства, остаётся корректным.
Ответ LLM не приходит / долгий таймаут / ошибка в окне чата	Доступность LLM-сервера и модель в config.json (секция llm): и поиск, и ответ чата идут через него.
Ошибка логина в вики при индексации	Учётные данные в config.json (секция wiki), права пользователя.
Сервис недоступен	Порт 7050 хоста с сервером; сервис не требует авторизации, доступ ограничен внутренней сетью.