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

API для охорони здоров'я для ШІ: контекст пацієнта з позначкою походження в межах бюджету токенів

Що потрібно моделі ШІ від API охорони здоров'я, чого не дає простий пошук FHIR: спочатку правильні факти, кожен з позначкою, хто його записав, в межах бюджету токенів, за згодою. Як працює API контексту Anpheros, з запитом та формою відповіді.

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

Пошук 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.

Цей посібник призначений для інформаційних цілей і не замінює медичну консультацію. Для прийняття рішень щодо вашого здоров'я зверніться до лікаря. У разі надзвичайної ситуації телефонуйте 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