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

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

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

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

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

Введите запрос в поле и нажмите «Найти» (или Enter). Сервис вернёт до 10 самых релевантных фрагментов: название статьи (по клику открывается в вики), название раздела и отрывок текста.

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

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

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

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

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

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

Ассистент отвечает на вопросы по бухгалтерскому и налоговому учёту, опираясь на базу знаний. Как это работает:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• после изменения правил очистки/нарезки текста (модули 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 хоста с сервером; сервис не требует авторизации, доступ ограничен внутренней сетью.