Загрузка...

Блог

Серия: Экосистема Adminica 2026 · статья 3 из 6

Релевантность по чанку: как читать источники в RAG-чате

Релевантность по чанку: как читать источники в RAG-чате

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

Что видит пользователь

  • Бейдж N% на иконке источника — насколько фрагмент похож на ваш вопрос (гибридный поиск: семантика + BM25).
  • Зелёный / синий / оранжевый цвет — высокая, средняя или низкая релевантность.
  • Клик по иконке — панель с цитатой фрагмента, версией записи и связями version_of.
  • Кнопка «Открыть в библиотеке» — deep link /library/?entry=UUID&chunk_index=N с подсветкой текста.

Зачем отдельно score чанка

Общий confidence ответа отражает, насколько ответ опирается на архив vs догадки LLM. Но одна запись может содержать десятки страниц: в контекст попадает один чанк. Показывая relevance_percent по чанку, Adminica отвечает на вопрос: «именно этот кусок документа релевантен запросу» — а не «документ в целом когда-то индексировался».

Данные в API

В массиве entries[] ответа RAG (чат, POST /query) для каждого источника:

  • relevance_percent — 0–100;
  • chunk_excerpt — короткий текст фрагмента;
  • chunk_id, chunk_index — привязка к индексу Qdrant;
  • version — поле версии записи, если задано при загрузке.

Интеграции могут строить свои UI или логировать источники для аудита качества RAG.

Версии записей

Если в графе знаний настроены связи version_of, в панели источника и в библиотеке отображается блок «Другие версии» — удобно при обновлении регламентов и прайсов. Полная история diff по PDF — в планах; сейчас — навигация между версиями через связи.

Веб-поиск и источники архива

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

Практики применения

  • Обучайте команду кликать на источник с низким % — возможно, вопрос сформулирован неточно или в архиве нет материала.
  • Используйте deep link в библиотеку при ревью ответов для дежурных и аудита RAG.
  • Связывайте версии документов через version_of при загрузке новых редакций регламентов.

Итог: прозрачность RAG — это не только текст ответа, но и измеримая релевантность фрагмента. Adminica показывает её в UI и отдаёт в API для интеграций.