Для розробників

Інтеграція ЕМС зі штучним інтелектом для медичних помічників: запис FHIR, API контексту та сервер MCP

Як безпечно підключити медичного помічника зі штучним інтелектом до запису пацієнта: контекст із позначкою походження в межах бюджету токенів, читання за згодою пацієнта, запис як пропозиції до схвалення особою. Сервер MCP Anpheros та API контексту з прикладами.

від Опубліковано 4 хв читання

Підключення мовної моделі до медичної картки викликає три запитання ще до першого запиту: що бачить модель, хто це дозволив і що станеться, коли вона захоче щось записати у відповідь. Платформа Anpheros надає відповіді на всі три запитання в API, тому помічник, якого ви створите (або той, який вже мають ваші користувачі), може працювати з карткою, не вигадуючи власних правил. Цей посібник охоплює контекстний API, сервер MCP та процес пропозицій.

Технічна версія для розробників: AI медичний помічник · Сервер MCP на developers.anpheros.com, із запитами, відповідями та обмеженнями. Ця сторінка є версією простою мовою.

Що бачить модель: контекстний API

POST /v1/context створює резюме пацієнта, готове для ШІ, в межах встановленого вами бюджету токенів. Кожен елемент має author_type (пацієнт, лікар, пристрій, імпорт, похідне) та його джерело, тому модель може відрізнити лабораторне значення від симптому, про який повідомив сам пацієнт, і діагноз лікаря від припущення. Бюджет визначає, що включається в першу чергу: активні проблеми, поточні ліки, алергії, останні результати, а потім решта. Ви отримуєте позначені розділи або, з format: "text", готовий блок для запиту, плюс список omitted, що називає те, що не вмістилося.

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"}'

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

Хто це дозволив: згода, а не конфігурація

Токен у наведеному вище виклику надходить від особи через OAuth 2.1 з PKCE, з обраними нею областями дії та тривалістю. AI-додаток реєструється як будь-який інший, запитує як будь-який інший і перелічується в розділі "Підключення" особи, як будь-який інший. Відкликання зупиняє його при наступному запиті. Ключ проекту сам по собі бачить лише пацієнтів, яких створив проект; він ніколи не замінює згоду.

Запис у відповідь: пропозиції, а не записи

Запис, зроблений за згодою особи додатком, зареєстрованим як AI-агент, утримується. Платформа перевіряє його, відповідає 202 Accepted з ідентифікатором пропозиції та нічого не змінює. Особа бачить пропозицію, що це таке і який помічник її надіслав, і приймає або відхиляє її. Прийнята пропозиція записується точно так, як була надіслана, позначена як написана ШІ відповідно до рекомендацій HL7 щодо прозорості ШІ. Проекти, які можуть бачити картку, отримують тонкий вебхук proposal.created.

Це правило дозволяє помічнику бути корисним ("Я помітив, що ви згадали про новий препарат, додати його?"), ніколи не будучи автором запису.

Сервер MCP

Помічники, що спілкуються мовою протоколу контексту моделі (Model Context Protocol), підключаються безпосередньо до https://platform.anpheros.com/mcp (потокове HTTP). Люди підключаються через OAuth, до власної картки; розробники можуть підключатися за допомогою ключа пісочниці до 30 синтетичних пацієнтів. Інструменти є такими, яких ви очікуєте від API:

  • list_patients, get_patient_context, get_patient_summary (Міжнародне резюме пацієнта), get_timeline
  • get_health_patterns, get_pattern_evidence, get_series, compare_periods (що змінилося і що повторюється, з доказами; не діагнози)
  • search_fhir, read_fhir_resource, get_provenance, lookup_code
  • validate_fhir_resource, create_fhir_resource, create_patient, import_lab_report
  • sandbox_status, reset_sandbox

Сервер перелічений у реєстрі MCP як com.anpheros/fhir. Налаштування для Claude, ChatGPT та інших клієнтів доступні за адресою developers.anpheros.com/guides/mcp.

Приватні моделі та резиденція в ЄС

Платформа не викликає модель від вашого імені; вона надає контекст і приймає пропозиції. Яка модель читає контекст – це ваше рішення: розміщений API, приватне розгортання, модель на власному обладнанні лікарні. Сама картка залишається в ЄС, на Cloud Run у europe-west4, з походженням та аудитом кожного доступу.

Чим це не є

Платформа не ставить діагнози і не рекомендує лікування, а контекстний API не є системою підтримки клінічних рішень. Він надає моделі факти, позначені, за згодою. Те, що говорить модель, є відповідальністю того, хто її розгортає.

Поширені запитання

Чи можу я підключити ChatGPT або Claude до медичної картки пацієнта?

Так, через сервер MCP, за згодою особи через OAuth на її власній картці. Для розробки ключ пісочниці надає помічнику доступ до 30 синтетичних пацієнтів.

Чи ШІ записує дані в картку?

Тільки як пропозицію, яку особа схвалює. Жоден запис, надісланий AI-агентом, не застосовується без цього схвалення, а прийняті записи позначені як написані ШІ.

Як запобігти тому, щоб модель бачила занадто багато?

Три способи: області дії, які надає особа, фільтри категорій для цих областей дії та бюджет токенів для виклику контексту, який упорядковує елементи за клінічною релевантністю та зупиняється на бюджеті.

Чи є API для чат-бота для здоров'я у моєму власному додатку?

Так. Ваш додаток отримує згоду особи через OAuth, викликає контекстний API, надсилає результат до обраної вами моделі, і, якщо модель пропонує запис, надсилає його як запис на запис; платформа перетворює його на пропозицію. SDK TypeScript та Dart охоплюють виклики.

Де обробляються дані?

Картка зберігається та надається з ЄС. Де працює модель – вирішувати вам; платформа ніколи не надсилає дані картки до самої моделі.

Цей посібник призначений для інформаційних цілей і не замінює медичну консультацію. Для прийняття рішень щодо вашого здоров'я зверніться до лікаря. У разі надзвичайної ситуації телефонуйте 112.
Про автора
Adrian Kereky

Founder of Anpheros. An electronics engineer, he spent six years in autonomous driving, on automotive projects run in partnership with Samsung and NVIDIA, designing the architecture of driver-assistance and AI systems that run on NVIDIA chips with CUDA. He then built Anpheros: the patient-controlled medical record and the HL7 FHIR R4 platform it runs on.

Більше про Anpheros та автора →

Тримайте свою медичну карту завжди з собою

Anpheros Daily зберігає симптоми, результати аналізів, ліки та документи в одному місці, у стандартному форматі, під вашим контролем. Базовий план безкоштовний.

Отримати Anpheros Daily