АудиоПротокол: руководство пользователя

Версия системы 0.104.12 · документ от 2026-11-07 · собран автоматически при выкладке на стенд; таблицы прав и настроек берутся из кода. Адрес стенда: https://audio.checkaimed.ru:8444

Для чего система

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

• Экономит время. Врач не печатает протокол во время и после приёма, а только проверяет его.
• Не теряет важное. Спорные места (числа и дозы, названия препаратов, отрицания, конфликты между фактами) система подсвечивает красным и жёлтым, и каждое можно проверить по цитате из разговора.
• Работает по вашему шаблону. Протокол собирается по шаблону специальности или организации; новые шаблоны можно загрузить из документа DOCX, DOC или PDF.
• Решение за врачом. Система предлагает черновик и не утверждает его сама: утверждает врач, и итоговую ответственность за протокол несёт он.
• Данные под контролем. Запись начинается только с согласия пациента, звук хранится ограниченное время, доступ к приёмам определяется ролью, действия фиксируются в журнале.

1. Быстрый старт (врач)

Скриншоты сняты на версии 0.97.0. С тех пор экраны могли измениться: если кнопка выглядит иначе, ориентируйтесь на описание рядом.

От входа до готового протокола. Всё, что нужно врачу в обычный день.

1. Войдите. Откройте адрес системы, введите email и пароль, которые выдала организация, нажмите Войти. Первый вход по письму-приглашению: откройте ссылку из письма, задайте пароль, нажмите Активировать и войти (ссылка живёт 48 часов). Если пароль задал администратор, система попросит сменить его при первом входе.
2. Один раз настройте микрофоны. В блоке Микрофоны выберите «Микрофон врача» (и «Микрофон пациента», если он отдельный), нажмите Проверить (полоса уровня должна двигаться), затем Сохранить. Если микрофон один на двоих, выберите «Нет отдельного микрофона».
3. Создайте приём: + Новый приём. Заполните «Номер пациента», «ФИО пациента», выберите «Специальность» (пока она не выбрана, приём создать нельзя) и «Шаблон протокола».
4. Отметьте согласие пациента («Согласие пациента получено»). Без согласия запись не начать. Нажмите Создать приём.
5. Нажмите Начать запись и проведите приём как обычно. Слева в окне «Диалог» появляется распознанный текст, справа в «Протоколе» заполняются поля. При необходимости: Пауза / Продолжить.
6. Нажмите Завершить приём. Дождитесь баннера «Готово» (или «Нужна проверка»).
7. Проверьте протокол. Красные места (конфликт, неподтверждённая цитата, возможно пропущенное отрицание и т.п.) исправьте или отклоните; жёлтые просмотрите. Особо проверьте числа и дозы, названия препаратов, отрицания.
8. Утвердите: Проверить выделенное и утвердить, затем Утвердить эту версию. После утверждения версия заблокирована.
9. Выгрузите документ: Скачать PDF, Скачать Word (.docx) или Скопировать текст протокола.
10. Выйдите кнопкой Выйти (вверху справа), если работаете на чужом компьютере.

2. Работа врача

Шапка страницы: колокольчик «Лента работы», индикатор сервера ИИ («ИИ включён» / «ИИ выключен» / «ИИ запускается» / «ИИ недоступен»), строка «Версия … · обновлено …», имя пользователя, Настройки (только у администраторов) и Выйти. Если ИИ выключен, готовый протокол можно открывать, править и выгружать; заполнение продолжится после включения сервера. Врач может включить сервер сам: на вкладке «Весь приём» кнопка при выключенном ИИ называется Включить ИИ и перезаполнить (см. 2.7).

Экран врача по умолчанию «простой»: технические метаданные, строка статуса ИИ, уверенность реплик и панель конфликтов скрыты. Администраторы видят «полный» вид, эксперт качества «технический» (только чтение).

2.1 Список приёмов

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

2.2 Новый приём

Кнопка + Новый приём (нужно право создавать приёмы). Поля формы:

Открытый приём показывает в шапке карточку пациента: ФИО и номер, дата рождения, пол, дата приёма, врач, специальность, режим протокола, статус и отметку согласия. Отдельной страницы карточки пациента нет. Эти же реквизиты стоят в шапке протокола, в скопированном тексте и в выгруженных файлах: ФИО, дата рождения и возраст, врач и специальность берутся только из карточки приёма, а не из разговора. Специальность печатается названием («Терапия»), а не кодом; рядом с датой рождения указан возраст на день приёма, например «12.03.1980 (45 лет)».

2.3 Запись и микрофоны

• Блок Микрофоны: «Микрофон врача», «Микрофон пациента», Проверить с индикатором уровня, Обновить список устройств, Сохранить. Настройка хранится на сервере для вашей учётной записи.
• Два микрофона: роли определяются по каналу. Один микрофон: голоса различаются по калибровке.
• Калибровка голосов (до записи, по 5 секунд): кнопки Врач и Пациент; нужно согласие пациента. Повышает точность деления на говорящих при одном микрофоне.
• Верхнюю часть приёма (сведения о пациенте, микрофоны, калибровку) можно свернуть кнопкой Свернуть сведения ▲, чтобы освободить место под диалог и протокол; та же кнопка раскрывает её обратно.
• Кнопки записи: Начать запись, Пауза, Продолжить, Завершить приём. Есть таймер и полоса уровня звука.
• Окно «Диалог (полный распознанный текст)»: у каждой реплики вместо слов «врач» и «пациент» стоит значок говорящего; один щелчок по значку меняет говорящего у этой реплики (врач становится пациентом и наоборот), факты пересчитываются. Время реплики врачу не показывается. Размер текста 1.5× и 2×. Кнопка ▶ у реплики прослушивает её (звук реплик хранится 12 часов, после срока: «Аудио удалено по сроку хранения»).
• Если сервер перегружен, текст реплик сохраняется, а извлечение фактов откладывается до финальной сверки (появится соответствующее сообщение).

2.4 Обработка и статусы

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

Всплывающие уведомления внизу справа: «Запись распознана», «Факты извлечены», «Протокол заполнен», «Протокол утверждён», «Утверждение снято», «Документ сохранён», «Правка врача», «Обработка неполная», «Ошибка обработки». Ошибки и предупреждения держатся дольше.

В окне «Логи обработки» метка «проверить» у факта стоит по тому же цвету, что и в протоколе: только у жёлтых и красных позиций. У принятых, утверждённых и отклонённых фактов её нет.

2.5 Протокол и правка полей

• Окно «Протокол приёма» показывает поля шаблона карточками; размер текста 1.5× / 2×. Раздел «Коды по МКБ-10» с поиском по коду или названию.
• Правка факта: «изменить» → поле «Значение факта» → Сохранить, Отклонить факт или Отмена (Esc). Пустое значение запрещено: введите текст или отклоните факт.
• Свой текст: нажмите «Нажмите здесь, чтобы дописать свой текст…». Статус «Сохранение…» / «Сохранено» / «Не сохранено». Текст врача система не перезаписывает. Если протокол изменён в другой вкладке, выберите «Оставить моё» или «Взять новое».
• Нераспределённые: факты, для которых поле не удалось определить автоматически; поле выбирается вручную.
• Цвета риска. Красное требует решения, жёлтое просмотра. Причины: конфликт с другим фактом; цитата не подтверждена в реплике; значение не связано с репликой; возможно пропущено отрицание; обсуждается, решение не принято; предположительный диагноз (если врач сам оставляет формулировку «предположительно…» или «?», кнопки «Принять это место» и «Исправить» снимают красную отметку, а факт остаётся с серой пометкой «предположительный»); срок без указания, к чему он относится; препарат не найден в ГРЛС; такой формы выпуска нет в ГРЛС. Кнопки: Принять это место, Исправить, Отклонить, К источнику (прокрутка к реплике), Отметить решённым.
• Новые жёлтые подсказки (релизы 0.104.x). Это только подсказки: факты они не удаляют, решение остаётся за врачом. Текст подсказки виден у факта; жёлтые места разбираются так же, как остальные (см. «Проверка перед утверждением»). Подсказки: «Название заменено словами пациента: в разговоре этого термина не было, проверьте»; «Оценка состояния не звучала в разговоре: проверьте или удалите»; «Такое название обследования или процедуры в разговоре не звучало: проверьте»; «Фраза распознана с ошибкой или оборвана: проверьте формулировку»; «Слово распознано с ошибкой и заменено близким термином из справочника: проверьте»; «Срок повторного приёма в разговоре неоднозначен: проверьте»; «Раздел выбран по таблице, потому что автоматическое распределение не ответило: проверьте». Каждая подсказка включается своим флагом в «Настройках системы» (например, claim_support_checks_enabled, garbled_text_checks_enabled, plan_routing_guard_enabled); у флага есть значок «?».
• Памятка пациенту, собранная из плана выключено по умолчанию (protocol_leaflet_assemble_enabled). Если флаг включён, в памятку попадают срок повторного приёма, пороги и условия из плана, а рядом стоит пометка «собрано из плана автоматически, проверьте». Текст врача такая сборка не заменяет, а в утверждённой версии памятка не меняется.
• Врач в шапке протокола. В шапке стоит текущее ФИО врача из его карточки (в просмотре, экспортах и снимке при утверждении), а не номер и не e-mail. Управляется флагом protocol_doctor_card_name_enabled (значение по умолчанию смотрите в карточке настройки).
• Жалобы. Части одной жалобы («кашель», «сухой кашель», «кашель усиливается ночью») система собирает в один расширенный факт: «сухой кашель, усиливается ночью». Склеиваются только жалобы с общим главным словом; отрицания, числа и жалобы с предлогами остаются отдельными.
• Если правите текст реплики или её роль, факты пересчитываются; список изменений виден в блоке «Что пересчитано после правки».
• Умное заполнение (если включено у шаблона): под полем виден блок «Факты, вошедшие в текст выше»; при сбое в поле остаётся текст шаблона и факты списком с пометкой «не собрано автоматически».
• Офтальмология: правый и левый глаз выключено по умолчанию (eye_paired_fields_enabled). В приёме со специальностью «офтальмология» факт из раздела «Объективный осмотр» или «Лабораторные и инструментальные данные», в цитате которого назван ровно один глаз (OD / OS, «правый глаз», «левый глаз»), попадает не в общее поле, а в добавленную рядом с ним пару «…: правый глаз» и «…: левый глаз». Пара появляется только в этом приёме и только когда нашлось измерение одного глаза; шаблон и другие приёмы не меняются. Измерение обоих глаз (OU), без указания глаза, с отрицанием и не о пациенте остаётся в общем поле: система не угадывает.

2.6 Утверждение

• Карточка «Проверка перед утверждением»: «Красные места (N): разберите каждое» и «Жёлтые места (N)». Жёлтые принимаются одним решением Принять жёлтые места (N) (можно отменить). Красные одним нажатием принять нельзя: исправьте или отклоните каждое. Принятое жёлтое место (в том числе препарат без дозы или курса) теряет жёлтую отметку; в утверждённом протоколе жёлтых отметок и надписи «Нужна проверка» нет.
• Затем Проверить выделенное и утвердить и Утвердить эту версию.
• Обязательные поля пустые: появится предупреждение «Не заполнены обязательные поля». По умолчанию утвердить всё равно можно; запрет включается настройкой block_approval_on_empty_required выключено по умолчанию.
• Приём коллеги утверждать нельзя.
• Вернуть в правку снимает утверждение (после подтверждения). Кто и когда вернул, сохраняется в журнале.

2.7 Версии протокола и экспорт

• Вкладки над протоколом: «По фрагментам» (заполняется по ходу записи) и «Весь приём» (строится по всему тексту после записи, одним запросом). Первый раз версию строит кнопка Заполнить протокол целиком; если построение не удалось, кнопка называется Повторить заполнение. Сравнить рядом показывает две версии вместе. Статусы версии: В очереди, Заполняется, Готово, Ошибка, Утверждена.
• Перезаполнение — это предложение, а не замена. У готовой, но не утверждённой версии «Весь приём» кнопка называется Перезаполнить версию «Весь приём» (после подтверждения). Она строит отдельное предложение, а сама версия не меняется, пока вы его не примете. Под кнопкой появляется панель: «Строится новое предложение…», затем «Есть новое предложение: N новых фактов, M фактов уйдут. Ваши правки не изменятся» с кнопками Принять и Отклонить (если построение не удалось, вместо «Отклонить» кнопка Закрыть, версия осталась прежней). При «Принять» непроверенные машинные факты заменяются новыми; ваши правки, факты, добавленные врачом, отклонённые факты и дописанный текст остаются. Новое перезаполнение, пока предложение ждёт, заменяет прежнее предложение. У утверждённой версии кнопка недоступна: «Версия «Весь приём» утверждена и заблокирована».
• Если сервер ИИ выключен. Кнопка не серая, а называется Включить ИИ и перезаполнить (после неудачного заполнения — «Включить ИИ и повторить», если версия ещё не заполнялась — «Включить ИИ и заполнить»). Нажмите её и подтвердите: сервер платный, запуск занимает 1–3 минуты, заполнение само не начнётся. Индикатор в шапке сменится на «ИИ запускается», затем на «ИИ включён»; после этого кнопка снова называется «Перезаполнить версию «Весь приём»», нажмите её. Если сервер не запустился («ИИ недоступен»), кнопка остаётся серой: включить его повторно может только суперадмин.
• Способ «По всему приёму» как режим по умолчанию для организации работает, только если включена настройка protocol_fill_strategy_enabled выключено по умолчанию.
• Экспорт: Открыть полный документ (отдельная страница с кнопками «Копировать» по полям), Скопировать текст протокола, Скачать PDF, Скачать Word (.docx), Скачать RTF (.rtf). Препараты, которые пациент принимает сейчас, стоят в «Истории заболевания» одной строкой «Принимает сейчас: …» (нерегулярный приём — «ибупрофен, нерегулярно»); если пациент сначала отрицал препарат, а потом назвал его, в документе остаётся только приём. Пустое поле в скопированном тексте и в файлах подписано «не уточнялось»; пустая «Памятка пациенту» не выводится совсем. Если памятку никто не писал, а в плане есть срок повторного приёма, порог, условие, справка или режим, система собирает памятку из этих строк плана и подписывает поле «собрано из плана автоматически, проверьте»; пока вы не изменили и не сохранили памятку, эти строки не считаются вашим текстом, а написанную вами памятку система не трогает (выключатель в настройках: «Сборка памятки пациенту из плана»).
• Правки в Word: отредактируйте скачанный файл и загрузите кнопкой Загрузить правки из файла (docx или rtf). Откроется предпросмотр, затем Применить правки. При конфликте выберите «Взять текст из файла» или «Оставить как в системе». Правки, сделанные только в скачанном файле, остаются в файле, пока вы их не загрузите.

2.8 «Лента работы» и уведомления

Колокольчик открывает ленту событий по вашим приёмам. Фильтры: «Период» (1 / 7 / 30 дней), «Найти приём», «Приём», «Тип события», флажок «Только ошибки и неполно» (у администратора и эксперта ещё «Врач»). В открытом приёме есть свёрнутый блок «Лента работы по приёму». События хранятся 30 дней.

2.9 Удаление данных и корзина выключено по умолчанию

Работает, только если администратор платформы включил data_deletion_enabled; иначе увидите «Удаление данных выключено администратором платформы.»

• Удалить приём и Удалить пациента (пациент уходит вместе со всеми приёмами) перемещают данные в «Корзину». Приём в процессе записи или обработки сначала нужно завершить. Если у пациента есть записывающийся или обрабатываемый приём, удаление пациента отклоняется, а под шапкой приёма появляется панель со счётом («N приёма ещё записываются или обрабатываются») и ссылкой на каждый такой приём (дата, врач, «идёт запись» / «на паузе» / «завершается»). У приёма в записи или на паузе есть кнопка Завершить (с подтверждением: идущая запись будет оборвана); после неё приём уходит на завершение, а удаление повторяют через несколько минут.
• Удалить реплику стирает текст и звук реплики, остаётся пометка «реплика удалена». Из утверждённого протокола реплику удалить нельзя: сначала верните его в правку.
• Из корзины Восстановить может администратор организации. Удалить навсегда (нужно ввести фразу «удалить навсегда») может только суперадминистратор.

3. Администратору

Кнопка Настройки видна, если у вас есть хотя бы одно право управления. Слева вкладки; видны только те, где есть доступные вам карточки. Назад: ← Назад к приёмам. Часть вкладок доступна только суперадминистратору (у него нет своей организации).

3.1 Пользователи и роли

• Организации (суперадмин): выбор «Организация», «Выбранная организация» (название, ИНН 10 или 12 цифр), «Новая организация» → Создать организацию.
• Таблица пользователей: Email, ФИО, Роль, Статус (ожидает активации / активен / отключён). Действия: «отключить» / «включить», Сменить роль, Отправить приглашение повторно (новая ссылка, прежние перестают работать, не чаще раза в минуту).
• Новый пользователь: «Email», «ФИО», «Роль» (Врач, Администратор организации, Специалист по качеству и ваши роли), «Пароль (необязательно)», Создать. Без пароля уходит письмо-приглашение со ссылкой активации (48 часов, одноразовая). Если почта не настроена, ссылка показывается на экране. С паролем учётная запись сразу активна, а пользователь при первом входе обязан сменить пароль (force_password_change_enabled, по умолчанию включено).
• Кнопки «сбросить пароль» у администратора нет: пользователь нажимает «Забыли пароль?» на экране входа (ссылка живёт 1 час).
• Встроенные роли: Врач, Администратор организации, Специалист по качеству (эксперт), Суперадминистратор. Что может человек, определяют права роли, а не её название. Полная таблица в приложении.

Свои роли

Карточка «Права и роли: роли организации»: Создать роль → «Название», «Начать с» (встроенная роль), галочки прав → Создать. У роли есть «изменить», «сбросить к исходному» (для изменённой встроенной) и «удалить» (только своя). Удалить свою роль нельзя, пока она назначена хотя бы одному пользователю: система покажет, сколько их, и просит сначала дать им другую роль в списке пользователей. Правила:

• Нужно хотя бы одно право; выдать можно только те права, что есть у вас самих; права платформы организационной роли не дают.
• Встроенную роль переименовать нельзя. Изменение действует сразу у всех с этой ролью.
• Новая роль пользователя действует со следующего входа (текущие сессии закрываются). Свою роль сменить нельзя. В организации должен остаться хотя бы один активный администратор.
• «Читать приёмы коллег» (только чтение): выдаётся через роль. Суперадмин может выдать право врачу лично в карточке «Права и роли: каталог разрешений» (кнопки Выдать / Снять).

3.2 Почта

Карточка «Почтовый сервер (для писем активации и сброса пароля)»: «Включить отправку писем», «SMTP host», «Порт», «Логин», «Пароль» (не показывается), «Адрес отправителя (From)», «STARTTLS», «SSL с первого байта», Сохранить. Если браузер подставил в «Логин» ваш собственный email в системе, под полем появляется предупреждение (это логин почтового сервера, а не ваш пользователь), и при сохранении и при отправке тестового письма система переспрашивает «Всё равно…?». Проверка: адрес получателя → Отправить тестовое письмо. Без настроенной почты приглашения и сброс пароля письмами не работают. Если письма уходят в спам, нужно настроить SPF, DKIM и DMARC для домена отправителя.

3.3 Шаблоны: каталог и импорт

Права: «Шаблоны своей организации» (админ организации) и «Общие шаблоны» (суперадмин).

Каталог

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

Импорт шаблона из файла (DOCX, DOC, PDF)

Включён по умолчанию (template_import_enabled); при заполненном списке «Пилотные организации импорта шаблонов» работает только для них (пусто = для всех).

1. Загрузка. Карточка «Импорт шаблона из файла»: «Файл шаблона», «Название (необязательно)», «Чей шаблон» (общий или организация), Загрузить и разобрать. Лимиты по умолчанию: 25 МБ, 50 страниц, 200 полей. Не принимаются файлы с макросами, под паролем и повреждённые; для сканов работает распознавание (OCR).
2. Отметка про данные пациентов. Если разбор идёт через внешнюю модель, нужно поставить галочку «В файле нет данных пациентов, текст уйдёт во внешнюю модель». Текст файла целиком уходит стороннему сервису, поэтому в файле не должно быть фамилий, телефонов, номеров полисов. Загружайте только обезличенные образцы.
3. Обработка идёт в фоне, страницу можно закрыть. Состояния: в очереди → обрабатывается → определяются поля → готов к проверке (или не удалось / отменён). Отменить останавливает загрузку. Исходный файл и промежуточный текст удаляются через 30 дней.
4. Правила и модель. Сначала всегда работают правила и словарь: они дают первый результат. Модель подключается, только если для задачи «Разбор структуры шаблона при импорте» выбран профиль (см. «Модели по задачам») и правила нашли меньше полей, чем указано в настройке template_import_llm_min_rule_fields («Сколько полей должны найти правила, чтобы модель не вызывалась», по умолчанию 5, от 1 до 50, действует со следующей загрузки). Если модель нашла не больше полей, чем правила, остаётся результат правил («ИИ нашёл не больше полей, чем правила»). Длинный документ режется по заголовкам на части (12 000 знаков для локальной модели, 24 000 для внешней); каждая часть обрабатывается отдельным запросом, но для неё возможны повторные обращения: ещё один запрос, если ответ модели неверного вида, и повторы внешней модели после ответов 429 и 5xx (см. ниже). Названия полей от модели принимаются, только если они дословно есть в тексте файла; персональные данные перед отправкой во внешнюю модель вычищаются кодом, а в шаблоне заменяются метками.
5. Если модель не помогла. Импорт не падает: поля находят правила, а в предупреждениях черновика стоит причина: «ИИ-сервер недоступен или не ответил», «Внешняя модель ограничила частоту запросов» (ответ 429 после всех повторов), «Суточный лимит обращений к внешней модели исчерпан» (по умолчанию 100 запросов в сутки, template_import_llm_daily_limit, 0 — без предела), «Исчерпан предел обращений … для этого файла», «Модель разобрала только начало документа» (остаток разобран правилами), «Предел размера запроса во внешнем профиле слишком мал…». Внешняя модель при ответе 429 или сбое сервера (5xx) повторяет запрос до 3 раз с растущей паузой 5, 15, 45 секунд (external_retry_attempts и external_retry_start_pause_s; пауза не больше 120 секунд, все паузы одного запроса не больше 300 секунд, всех запросов одного файла не больше 600 секунд; если сервер просит подождать больше 120 секунд, например исчерпана дневная квота, повтора нет). Каждый повтор считается как обращение в пределах на файл и на сутки.
6. Проверка черновика (Проверить): «Поля шаблона (в порядке документа)»; если в файле несколько записей, выберите, какая станет шаблоном (Выбрать; правки пересоберутся). «Предложения по очистке» заменяют личные данные метками: Принять / Оставить как есть. «Не отнесённый текст»: Сделать поле или Не нужен.
7. Публикация. Две отметки: «Я проверил(а) поля и тексты шаблона» и «Я вручную проверил(а), что в шаблоне нет имён, телефонов, адресов и других данных пациента». Затем Опубликовать. Опубликованный шаблон получает номер редакции. Автоматическое обезличивание (template_anonymizer_enabled) выключено по умолчанию и реальной системы обезличивания пока нет, поэтому проверка вручную обязательна.

Режимы заполнения поля («Чем заполнять»)

Препараты, дозы и сроки всегда остаются фактами. Форма приёма «Чем заполнять протокол» может одним режимом перекрыть все поля.

Умное заполнение признак шаблона выключен по умолчанию

Признак шаблона (флажок «Умное заполнение»): у нового или импортированного шаблона выключен, и тогда факты просто дописываются после текста шаблона. Если включить, сначала выделяются факты, затем модель вписывает их в нужные места текста шаблона (в поля со способом «дополнять»); сервер принимает только правки, где совпадают числа, единицы и отрицания; текст врача не перезаписывается. Признак относится к шаблону и применяется к новым приёмам. Системная настройка template_smart_fill_enabled в коде включена по умолчанию; если задан список «Пилотные организации умного заполнения», функция работает только для них (пусто = для всех). Модель берётся из «Модели по задачам» («Умное заполнение шаблона»; пусто = та же, что извлекает факты). Если системная настройка выключена, признак шаблона сохранится, но на результат не повлияет. Фактическое значение на стенде сверяйте в «Настройки системы».

3.4 Справочники

• Специальности: список, «изменить» (название, «Инструкции для модели извлечения фактов»; изменение даёт новую версию инструкции; в редакторе видно «Версия инструкции: N» и кнопка История версий с прежними текстами), «Новая специальность» (код латиницей, название, инструкции).
• Справочник ГРЛС: активная версия, Проверить и обновить ГРЛС, «Автообновление, дней (0 — выключено)» (по умолчанию 7), «Журнал обновлений», режим «ГРЛС первичен» (включается только после загрузки ГРЛС, с подтверждением; по умолчанию выключено), форма «Добавить написание препарата вручную» (появляется при включённой GRLS_ALIAS_FORM_ENABLED; запись начинает действовать после утверждения в «Накопленных знаниях»).
• Словарь препаратов: названия, по которым исправляется распознавание. Поиск, фильтры «Все / Действуют / Выключены», Выключить / Включить, Добавить в словарь (только русские буквы и цифры).
• Справочники ЕСНСИ и ЕСКЛП: экрана нет, настройка reference_dictionaries_enabled выключено по умолчанию.

3.5 Настройки системы (суперадмин)

Карточка «Настройки системы: флаги и параметры с пояснениями». В реестре 155 настроек (78 флагов). У каждой есть значок «?»: что делает, польза, риск, когда менять, значение по умолчанию, допустимые значения, техническое имя. Рядом отметка источника значения («задано на этой странице» / «из окружения сервера» / «по умолчанию») и срок действия: «Применяется без перезапуска (в течение нескольких секунд)» или «Требует перезапуска сервиса». Рискованные настройки просят подтверждение. Кнопки Применить, Сбросить, Отмена, «Показать журнал изменений». Поиск по названию или имени настройки в верхней строке.

Не меняется с веб-страницы: секреты, пароли и ключи, роли и права, CORS, TLS, адреса моделей и шлюза, провайдеры ASR и диаризации, пути хранилищ.

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

Блок «Набор настроек для теста» (Применить набор для теста) одним нажатием включает «ГРЛС первичен», форму ручных написаний ГРЛС и повторную сверку очереди и выключает выборочный пересчёт; используйте только на тестовом стенде. Остальные настройки группируются по темам: распознавание речи и диаризация; извлечение фактов и итоговый протокол; очередь, повторы и прогрев модели; аудио, ГРЛС и обучающий слой; безопасность; импорт шаблонов.

3.6 AI и промпты

• Серверы шлюза (ai-gateway): список серверов, «Запасные конфигурации запуска», «Новый сервер», «Клиентские токены шлюза», «Лог команд». Облачный сервер с GPU включается по запросу и может останавливаться при простое; запуск тарифицируется облаком. Кнопка «Модель ИИ…» в шапке (включить/остановить) есть только у суперадмина.
• AI-профили: таблица «Профиль / Модель / Активен / Контекст, токенов», кнопки тест соединения, Изменить, активировать. Типы провайдера: «Ollama (локально, на CPU)», «Через ai-gateway-service (свои GPU-серверы)», «Свой OpenAI-совместимый сервер (internal)», «llama.cpp server», «Внешняя модель». Форма «Изменить профиль»: имя модели, адрес сервера, контекстное окно, «Предел ответа модели, токенов», «Таймаут одного запроса, секунд», «Предел размера одного запроса, знаков», «Предел запросов на один файл», «Новый ключ API (пусто = оставить прежний)», «Очистить ключ». Ключ нигде не показывается. Тип провайдера и идентификатор профиля не меняются. Правка активного профиля действует сразу на все приёмы (включая уже работающие), требует подтверждения; кнопка тест соединения проверяет профиль после правки. Для внешней модели есть ещё «Предел размера одного запроса, знаков» (пусто = 60 000) и «Предел запросов на один файл» (пусто = 40), таймаут не более 600 секунд.
• Внешняя модель (например Gemini через relay) допускается только для разбора шаблонов при импорте: адрес только https и только с сервера из списка external_ai_allowed_hosts (в «Настройки системы»), ключ обязателен. Текст приёмов во внешние сервисы не уходит; текст загруженного файла уходит только с отметкой «В файле нет данных пациентов» и после очистки кодом. Для задачи разбора структуры шаблона внешнему профилю всегда разрешён ответ не короче 8192 токенов, даже если в профиле стоит меньше (иначе модель с «размышлением» обрывает ответ). При ответах 429 («слишком много запросов») и 5xx (перегрузка, например 503) запрос повторяется с растущей паузой, см. «Правила и модель» в разделе об импорте. Повторы действуют только для внешнего профиля; ошибка 404 означает, что такой модели нет.
• «Модели по задачам»: «Умное заполнение шаблона» (пусто = та же модель, что извлекает факты) и «Разбор структуры шаблона при импорте» (пусто = модельный этап выключен, работают только правила). Выбор сохраняется сразу.
• Библиотека промптов: версии неизменяемы; новая версия сохраняется кнопкой Сохранить как новую версию, можно сразу сделать активной. Чтение у админов, запись у суперадмина.

3.7 Обработка и логи

• «Сценарий извлечения фактов» для новых приёмов: сценарий 1 (один проход, по умолчанию), 2 (два контура), 3 (прямое извлечение, экспериментальный). Меняет только суперадмин.
• «Очередь повторной обработки»: фильтр статусов, «Обновить», «Назад», «Вперёд». «Текущая работа: извлечение фактов» и «Логи этапов обработки» (автообновление каждые 5 с) помогают найти застрявшие приёмы.
• «Логи обработки для врачей» (админ организации): флажки показа врачам окна логов и выбора сценария на странице приёма; «Способ заполнения протокола по умолчанию» (По фрагментам / По всему приёму, виден при включённом protocol_fill_strategy_enabled); Сохранить.
• «Хранилище аудио»: состояние записи звука и места на диске.

3.8 Медицинские факты и накопленные знания

• «Обезличенный каталог мед. фактов» (по специальностям) и «База медицинских фактов»: фильтры, поиск, Добавить факт вручную (раздел, тип факта, текст, отрицание, достоверность). Добавление и удаление требует права на справочники.
• «Накопленные знания»: система накапливает исправления распознавания, варианты формулировок и кандидаты в словарь, но ничего не включает сама. Достижение порога лишь ставит запись в очередь, решение принимает человек (Включить / Отключить, Утвердить / Отклонить), решение пишется в журнал. Разделы: «Исправления распознавания (ASR)», «Общий каталог: кандидаты», «Карантин организации», «Кандидаты в словарь препаратов» (одобрение добавляет название в общий словарь всех организаций), «Связи вариантов формулировок», «Написания препаратов (алиасы ГРЛС)». Перед переносом в общий каталог подтвердите, что в значении нет персональных данных.

3.9 Хранение и удаление данных

Автоудаление по сроку хранения

• Режимы data_retention_auto_mode: «off» (по умолчанию), «report» (только считает и раз в сутки пишет в журнал аудита, сколько приёмов подлежит удалению, ничего не удаляя), «purge» (удаляет). Рекомендуемый порядок: сначала «report», прочитать запись журнала, потом «purge».
• Обрабатываются только организации со сроком больше 0 и только обычные приёмы старше срока (по дате создания), которые не заняты записью или обработкой и не лежат в корзине. Эталонные приёмы не затрагиваются никогда.
• «purge» работает в два шага: просроченный приём сначала уходит в корзину (автор действия «system:retention»), и администратор организации может его восстановить; через 7 дней в корзине он стирается навсегда. Корзину, наполненную людьми, автоудаление не очищает. Приём, восстановленный из корзины, получает новый полный срок.
• Для «purge» должна быть включена и настройка data_deletion_enabled; без неё проход только сообщает, ничего не удаляя. За один проход обрабатывается не больше 25 приёмов организации на шаг, большая очередь разбирается за несколько проходов. Пациент без приёмов автоудалением не удаляется.

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

3.10 Безопасность входа (вкладка «Прочее», суперадмин)

Изменения действуют в течение 15 секунд, вошедшие врачи их не замечают. Сессия непрерывно продлевается до 12 часов. После 5 неверных паролей учётная запись блокируется на 15 минут.

Функции только на сервере, без экранов: журнал аудита, выдача экстренного доступа суперадмина, срок хранения организации, справочники ЕСНСИ/ЕСКЛП.

4. Эксперт качества и эталонный приём

• Эксперт качества (роль «Специалист по качеству») только читает: видит приёмы организации, технический вид, версии, отчёты, «Не включено в протокол», экспертные отметки. Запись, правка и утверждение скрыты («Режим только для чтения»). Исключение: разметка эталонных приёмов.
• Эталонный приём (право создавать эталонные приёмы): + Новый эталонный приём. Форма «Тестовый эталон: не медицинская карта пациента»: специальность, «Код тестового сценария», «Тип эталона» («С аудио (запись голоса сохраняется)» или «Только текст»), «Срок хранения записи, дней», «Вымышленная история тестового пациента», согласие. Эталон изолирован от карты пациента, МИС и статистики.
• Разметка эталона: прослушать, исправить текст и роль реплики, отклонить лишний факт (причина обязательна), добавить пропущенный (нужна реплика-источник), отметить отрицание, субъект, время, «неуверенно», отметить просмотр каждого раздела. Разметка слепая (gold_blind_markup_enabled, вкл.).

5. Частые вопросы и ошибки

Приложение А. Права встроенных ролей

«+» означает, что право есть у роли по умолчанию. Администратор может собирать свои роли из этих прав (не больше, чем есть у него самого). Таблица строится из кода.

Суперадминистратор не имеет своей организации и видит приёмы организаций только по экстренному доступу.

Приложение Б. Все настройки системы

Раздел «Настройки системы» (суперадминистратор). Таблица строится из реестра настроек в коде. «Вкл.»/«выкл.» для флагов, иначе значение. «Р» — нужен перезапуск сервиса, «!» — рискованная настройка (просит подтверждение).

Распознавание речи и диаризация (29)

Очередь извлечения, повторы и прогрев модели (21)

Извлечение фактов и итоговый протокол (70)

Безопасность и журнал аудита (3)

Аудио, справочник ГРЛС и обучающий слой (27)

Импорт шаблонов из файлов (17)

Модели по задачам и внешняя модель (3)

Приложение В. История версий

Версии системы и даты, когда они вошли в основную ветку и выкладывались на стенд.

Приложение Г. Прежние редакции инструкции

Каждая новая редакция руководства выкладывается как новая, а предыдущая сохраняется с номером версии и датой.