> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Медицинский навигатор

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

# Медицинский навигатор

`medical-navigator` — готовая личность Велеса для вопросов о здоровье, подготовки к приёму, разбора результатов исследований и поиска медицинских доказательств.

Она намеренно называется **медицинским навигатором**, а не лицензированным врачом. Личность помогает собрать сведения, оценить срочность обращения, объяснить материал и подготовить вопросы специалисту, но не подтверждает диагноз, не назначает лечение и не заменяет очную помощь.

Такое ограничение опирается на [рекомендации ВОЗ по большим мультимодальным моделям в здравоохранении](https://www.who.int/publications/b/70584): генеративная модель может выдавать ложные, неполные или предвзятые утверждения и усиливать склонность человека некритично доверять автоматическому ответу. Поэтому задачи разделены на узкие сценарии, а основание каждого значимого вывода должно быть доступно для проверки.

<Warning>
  При возможной угрозе жизни навигатор должен сначала предложить вызвать экстренную помощь, а не продолжать опрос или поиск. В России используются номера `112` и `103`; в другой стране нужен местный номер. Язык сообщения не считается доказательством местонахождения пользователя.
</Warning>

## Что входит в комплект

Исходный текст личности находится в `examples/personalities/medical-navigator/`. Набор использует семь навыков из каталога `https://github.com/alor-broker/skills`:

| Навык | Назначение |
| - | - |
| `medical-symptom-navigation` | Сбор истории симптомов, первичная оценка срочности и прозрачный перечень возможных объяснений без окончательного диагноза. |
| `medical-lab-results` | Разбор результатов по единицам и референсным интервалам именно той лаборатории, которая выполнила исследование. |
| `medication-reconciliation` | Сверка лекарств, безрецептурных средств, добавок и аллергий; поиск расхождений и вопросов для врача или фармацевта. |
| `medical-evidence-review` | Поиск действующих клинических рекомендаций, сведений регуляторов и научных публикаций с проверкой применимости. |
| `medical-visit-preparation` | Подготовка краткой хронологии, списка лекарств, важных результатов и вопросов к специалисту. |
| `entrez-search` | Поиск публикаций и биомедицинских записей в NCBI, включая PubMed. |
| `fda-database` | Сведения FDA/openFDA для США; они не заменяют российские или иные национальные источники. |

Подробная маршрутизация описана на странице [Набор медицинских навыков](/skills/medical_suite_ru).

## Установка

Личность хранится в рабочей области как обычная пользовательская личность:

```text theme={null}
<workspace>/personalities/medical-navigator/
  SOUL.md
  personality.json
  skills/
    medical-symptom-navigation/
    medical-lab-results/
    medication-reconciliation/
    medical-evidence-review/
    medical-visit-preparation/
    entrez-search/
    fda-database/
```

Если личность уже создана через Nerve:

1. Создайте личность с именем «Медицинский навигатор / Medical Navigator» и идентификатором `medical-navigator`.
2. Замените только содержимое `SOUL.md` текстом из `examples/personalities/medical-navigator/SOUL.md`. Не копируйте поверх созданный Nerve файл `personality.json`: в нём уже сохранены выбранная модель, уровень рассуждения и служебные даты.
3. Скопируйте перечисленные каталоги навыков из репозитория навыков в `personalities/medical-navigator/skills/`.
4. Откройте новую сессию этой личности и убедитесь, что в её каталоге видны все семь навыков.

При полностью ручном создании каталога возьмите из примера оба файла — `SOUL.md` и минимальный `personality.json`, — а затем добавьте каталоги навыков. Модель и уровень рассуждения в этом случае выбираются позднее через Nerve.

Навыки размещаются внутри личности, а не в общем `<workspace>/skills`, чтобы медицинская маршрутизация не добавлялась всем остальным личностям. Установленная копия является пользовательской: её можно править и удалить, но обновления исходного репозитория не переносятся в неё автоматически.

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

## Секреты

Пять новых медицинских навыков не требуют секретов и не обращаются к платным медицинским базам.

У двух вспомогательных навыков есть только необязательные значения:

* `NCBI_API_KEY` и `NCBI_EMAIL` для `entrez-search`;
* `OPENFDA_API_KEY` для `fda-database`.

Без них навыки работают с более низкими ограничениями запросов. Значения не входят в комплект и не должны передаваться в аргументах команд. Если пользователь решит добавить их, это делается отдельно через зашифрованное хранилище секретов Велеса.

## Как навигатор принимает решения

Общие правила находятся в `SOUL.md`, поэтому они действуют даже тогда, когда отдельный навык не был загружен:

* возможная неотложная ситуация обрабатывается первой;
* факты, предположения, найденные доказательства и пробелы не смешиваются;
* отсутствие упоминания не превращается в отрицательный симптом;
* диагнозы формулируются только как обсуждаемые возможности;
* индивидуальная отмена, замена или изменение дозы лекарства не предлагаются;
* снимки, медицинские изображения, электрокардиограммы и гистологические изображения не используются для самостоятельной диагностики;
* лабораторные значения не сравниваются с универсальной таблицей вместо интервала в отчёте;
* рекомендации проверяются по стране, группе пациентов, дате и текущей версии источника.

Для России основными официальными отправными точками служат [рубрикатор клинических рекомендаций Минздрава](https://cr.minzdrav.gov.ru/), [Государственный реестр лекарственных средств](https://grls.rosminzdrav.ru/) и материалы Росздравнадзора. Международные рекомендации показываются отдельно, если они расходятся с применимыми российскими документами.

## Конфиденциальность и общая память

`medical-navigator` использует обычные механизмы истории и долговременной памяти Велеса. Отдельная медицинская карта, изолированное хранилище или режим анонимности не создаются. Разговоры могут участвовать в стандартном автоматическом создании резюме и файлов памяти, а личность может читать общие `USER.md`, `memory/MEMORY.md` и доступную историю сессий.

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

## Осознанные ограничения

* Консервативная оценка срочности может чаще направлять за очной помощью, зато снижает риск пропустить опасное состояние.
* Запрет на индивидуальное изменение дозы делает ответы менее удобными, но неполный список лекарств, функции почек и печени, беременность и форма препарата не позволяют безопасно назначать лечение по переписке.
* Отказ от универсальных лабораторных порогов иногда требует запросить полный отчёт, зато исключает ошибки единиц, метода и референсной группы.
* Бесплатные официальные источники не дают полной профессиональной базы лекарственных взаимодействий. Пока такой лицензированный источник не подключён и не согласованы его секреты, навигатор обязан обозначать этот пробел и направлять к фармацевту или врачу.

## Связанные страницы

* [Личности](/basics/personalities_ru)
* [Набор медицинских навыков](/skills/medical_suite_ru)
* [Поиск в NCBI](/skills/entrez_search_ru)
* [База FDA](/skills/fda_database_ru)
* [Секреты и токены](/basics/secrets_ru)
* [Память Велеса](/basics/memory_ru)
