Каталог релевантных тезисов

Инструкция по работе с инструментом подбора релевантных тезисов

Инструмент принимает клинический текст и вопрос врача, затем показывает ход пайплайна: от разметки анамнеза до финального списка тезисов клинических рекомендаций.

Назначение

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

Главная идея

Врач видит не только финальные тезисы, но и промежуточные рассуждения агентов: какие факты выделены, какие клинреки выбраны, какие тезисы отсеяны и почему.

Быстрый старт

Откройте инструмент

Перейдите на страницу прототипа и дождитесь статуса окружения в блоке «Вход».

Вставьте анамнез и вопрос

Анамнез вставляется в большое поле, вопрос врача - в поле ниже.

Выберите модель и parallel workers

Для OpenRouter рекомендуется поставить 32 workers. Для GigaChat рекомендуется поставить 8 workers. Эти значения ускоряют параллельные стадии без лишнего ожидания результатов по одному.

Нажмите «Запустить»

В правой части экрана начнут появляться шаги пайплайна и текущий статус выполнения.

Проверьте итоговые тезисы

Смотрите метаданные, раскраску, score и причину, по которой тезис оставлен.

Что вводить

Анамнез или клинический текст

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

Вопрос врача

Формулируйте вопрос так, как он стоит в клинической задаче: диагностика, лечение, госпитализация, реабилитация, дальнейшая тактика.

Как читать выводы агентов

Каждый агент показан в отдельном раскрывающемся блоке. Технические блоки можно свернуть, если они не нужны для проверки.

Раскраска анамнеза

Показывает анамнез с цветными фрагментами: жалобы, анамнез, объективные данные, исследования, терапию и другие категории. Это основной способ проверить, что модель правильно увидела клинические данные.

Валидация span-разметки

Техническая проверка разметки: совпали ли фрагменты с исходным текстом, есть ли ошибки индексов или предупреждения. Обычно врачу достаточно смотреть статус.

Тип клинического пути

Определяет, к чему относится вопрос: диагностика, лечение или реабилитация. Это влияет на фильтрацию глав клинических рекомендаций.

Клинические факты

Сжатый список фактов из анамнеза, на которые дальше опираются агенты. Этот блок стоит проверить: если важный факт потерян, итоговые тезисы могут быть хуже.

Подбор клинреков

Список клинических рекомендаций, которые модель считает подходящими для случая. Если в список попал явно нерелевантный документ, это стоит учитывать при оценке.

Первичный выбор тезисов

Параллельная стадия: клинреки обрабатываются независимо, результаты появляются по мере готовности. Здесь видны кандидаты до финальной проверки.

Финальный coloring-фильтр

Каждый тезис дополнительно раскрашивается и сопоставляется с анамнезом. В итог идут тезисы, которые прошли эту проверку.

Trace

Полный технический JSON запуска. Он нужен для отладки, воспроизведения ошибок и передачи разработчикам.

Как читать итоговые тезисы

Итоговые тезисы выводятся отдельными карточками. В каждой карточке есть текст тезиса, метаданные и объяснение, почему он оставлен.

  • Клинрек - название клинической рекомендации.
  • Глава - раздел или номер главы, откуда взят тезис.
  • Score - оценка применимости тезиса к случаю.
  • Population, Condition, Action - проверка популяции, состояния и действия.
  • Цветная раскраска тезиса показывает, какие части тезиса анализировались отдельно.
  • Блок причины объясняет, почему тезис оставлен или как он связан с анамнезом.

Что считать подозрительным

Низкий score, конфликт по популяции, неподходящее действие, детские рекомендации для взрослого пациента, тезис не из той клинической задачи или отсутствие связи с вопросом врача.

Скачивание результата

После завершения финального шага становится активной кнопка «Скачать тезисы». Она скачивает JSON с финальными тезисами в формате, пригодном для последующего подсчета метрик.

  • data.record - исходный анамнез.
  • data.question - вопрос врача.
  • data.recommendation - текст тезиса.
  • data.document_name, data.chapter_name, data.evidence - метаданные тезиса.

Если что-то пошло не так

Таймер идет, а вывода нет

Посмотрите строку статуса вверху и блок «Шаги пайплайна». Если долго идет загрузка графа, возможно сервер читает таблицы и инициализирует модель.

Ошибка красным текстом

Скопируйте текст ошибки и trace. Обычно это помогает понять, проблема в ключе модели, пути к клинрекам или формате ответа LLM.

Нет итоговых тезисов

Проверьте, были ли клинреки и кандидаты на шаге первичного выбора. Если кандидаты были, значит их отсеял финальный фильтр.

Вывод кажется странным

Начинайте проверку с клинических фактов и раскраски анамнеза. Если ошибка появилась там, последующие шаги могли унаследовать неверное представление о случае.

Для администратора или разработчика

Каждый запуск сохраняется в отдельную папку логов. По умолчанию это prototype_catalog/logs. Путь к папке конкретного запуска также передается в событиях stream как log_dir.

  • events.jsonl - подробные события, включая статусы и прогресс.
  • timings.json - длительность агентов, параллельных стадий и отдельных задач.
  • summary.json - краткая статистика запуска.
  • trace.json - финальный trace пайплайна.