API для ИИ в сфере здравоохранения: контекст пациента с меткой происхождения в рамках бюджетных токенов

Поиск FHIR возвращает все, что соответствует. Языковой модели нужно нечто иное: важные факты, в первую очередь, каждый с указанием, кто его записал, в размере, подходящем для запроса. Создание этого из необработанных ресурсов само по себе является проектом, и ошибка приведет к тому, что модель будет относиться к догадке пациента как к результату лабораторного исследования. API контекста Anpheros выполняет эту работу на платформе с согласия человека, поэтому выбранная вами модель начинает с обоснованного резюме.

Техническая версия для разработчиков: LLM и медицинские данные · Доступ ИИ-агента к медицинским записям на developers.anpheros.com, с запросами, ответами и ограничениями. Эта страница — версия для обычного языка.

Запрос

curl -X POST "$BASE/v1/context" \
     -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
     -d '{"patient": "'$PID'", "budget_tokens": 2000, "task": "pre-visit summary", "format": "text"}'

budget_tokens — это размер, который вы можете позволить себе в запросе. task и необязательный question определяют, какие элементы идут первыми; needs указывает типы данных, которые вам нужны; window_days ограничивает, как далеко назад искать; format выбирает структурированные разделы или отформатированный текстовый блок. Каждый вызов записывается в журнал доступа человека как чтение контекста.

Что возвращается

Разделы с указанием источника (или, при format: "text", отформатированный блок, готовый для вставки в запрос), плюс tokens_used, список omitted, указывающий, что не поместилось, warnings и provenance_note. Элементы упорядочены по клинической значимости и обрезаются по бюджету: сначала активные проблемы и аллергии, затем текущие лекарства, недавние измерения и результаты, недавние симптомы, затем более старая история. Каждый элемент содержит:

• author_type: пациент, врач, устройство, импорт или производный;
• source: приложение или организация, которая его написала;
• дату, код (LOINC, ICD-10, ATC) и значение с единицей измерения;
• для производных элементов — из чего они были получены.

Заметка об источнике в ответе говорит то же самое словами, поэтому модель, читающая текстовый блок, также учится взвешивать элементы. Диагноз, записанный врачом, и введенное пациентом "Я думаю, у меня есть..." присутствуют оба и маркируются по-разному.

Для чего это нужно

• Резюме перед визитом для врача, сгенерированное доверенной вами моделью, из фактов с указанием источников.
• Пациентский помощник, который отвечает на вопрос "что сказали мои последние результаты" с указанием фактических цифр и дат.
• Сортировка или маршрутизация внутри вашего продукта, где модели нужна запись, но она не должна видеть больше, чем разрешил человек.
• Запросы по шаблонам ("что изменилось с весны"), для которых механизм шаблонов платформы и инструменты compare_periods и get_series предоставляют доказательства, а не выводы.

От чего он отказывается быть

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

Всегда под согласием

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

Тот же контекст доступен помощникам MCP как инструмент get_patient_context на platform.anpheros.com/mcp, поэтому Claude, ChatGPT или ваш собственный агент читают его без какого-либо кода с вашей стороны. См. Интеграция ЭМК с ИИ-помощниками.

Частые вопросы

Какую модель использует платформа?

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

Как обеспечивается соблюдение бюджета?

Элементы ранжируются по клинической значимости и включаются до достижения бюджета; список omitted в ответе указывает, что было исключено, поэтому модель знает, что контекст является частичным.

Могу ли я запросить только часть записи?

Да, тремя способами: области действия согласия человека ограничивают то, что может быть прочитано вообще, needs и window_days сужают запрос, а бюджет обрезает остальное. Для полного контроля используйте search_fhir или конечные точки /v1 вместо этого.

Является ли вывод детерминированным?

Для одной и той же записи, согласия и бюджета — да. Новые записи изменяют его, в этом и суть: контекст отражает запись в ее текущем состоянии.

Где мне попробовать?

Песочница бесплатна, а ее 30 синтетических пациентов имеют шесть месяцев закодированной истории. Получите ключ и вызовите конечную точку контекста для любого из них: developers.anpheros.com/guides/first-hour.