Pro vývojáře

Integrace EMR s lékařskými AI asistenty: záznam FHIR, kontextové API a MCP server

Jak bezpečně propojit lékařského AI asistenta s pacientovým záznamem: kontext s označením původu v rámci povoleného objemu dat, čtení se souhlasem pacienta, zápisy jako návrhy čekající na schválení osobou. Anpheros MCP server a kontextové API s příklady.

od Publikováno Přečteno za 4 min

Spojení jazykového modelu s lékařským záznamem vyvolává tři otázky ještě před prvním zadáním: co model vidí, kdo to povolil a co se stane, když bude chtít něco napsat zpět. Platforma Anpheros odpovídá na všechny tři v API, takže asistent, kterého sestavíte (nebo kterého vaši uživatelé již mají), může pracovat se záznamem, aniž by si vymýšlel vlastní pravidla. Tento průvodce pokrývá kontextové API, server MCP a proces návrhů.

Technická verze pro vývojáře: AI lékařský asistent · Server MCP na developers.anpheros.com, s požadavky, odpověďmi a limity. Tato stránka je verze v běžné řeči.

Co model vidí: kontextové API

POST /v1/context vytvoří souhrn pacienta připravený pro AI v rámci vámi nastaveného rozpočtu tokenů. Každá položka nese author_type (pacient, lékař, zařízení, import, odvozeno) a její zdroj, takže model dokáže rozlišit laboratorní hodnotu od sebepopsaného symptomu a lékařskou diagnózu od odhadu. Rozpočet rozhoduje, co je zahrnuto jako první: aktivní problémy, současné léky, alergie, nedávné výsledky, pak zbytek. Získáte označené sekce nebo s format: "text" renderovaný blok připravený pro zadání, plus seznam omitted pojmenovávající, co se nevešlo.

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

Stejné štítky původu jsou to, co činí výstup později obhajitelným: souhrn asistenta může říci, odkud každé tvrzení pochází.

Kdo to povolil: souhlas, ne konfigurace

Token v předchozím volání pochází od osoby, prostřednictvím OAuth 2.1 s PKCE, s rozsahy a dobou platnosti, které si vybrala. Aplikace AI je registrována jako každá jiná, žádá jako každá jiná a je uvedena v "Připojení" osoby jako každá jiná. Zrušení ji zastaví při dalším požadavku. Samotný klíč projektu vidí pouze pacienty, které projekt vytvořil; nikdy nenahrazuje souhlas.

Psaní zpět: návrhy, ne zápisy

Zápis provedený pod souhlasem osoby aplikací registrovanou jako AI agent je pozdržen. Platforma jej ověří, odpoví 202 Accepted s ID návrhu a nic nezmění. Osoba vidí návrh, co to je a který asistent jej poslal, a přijme nebo odmítne. Přijatý návrh je zapsán přesně tak, jak byl odeslán, označen jako napsaný AI v souladu s pokyny HL7 pro transparentnost AI. Projekty, které vidí záznam, obdrží tenký webhook proposal.created.

Toto je pravidlo, které umožňuje asistentovi být užitečný ("Všiml jsem si, že jste zmínil nový lék, mám ho přidat?") aniž by byl kdy autorem záznamu.

Server MCP

Asistenti, kteří mluví jazykem Model Context Protocol, se připojují přímo na https://platform.anpheros.com/mcp (streamovatelné HTTP). Lidé se připojují pomocí OAuth, na svůj vlastní záznam; vývojáři se mohou připojit pomocí sandbox klíče na 30 syntetických pacientech. Nástroje jsou ty, které byste očekávali od API:

  • list_patients, get_patient_context, get_patient_summary (Mezinárodní souhrn pacienta), get_timeline
  • get_health_patterns, get_pattern_evidence, get_series, compare_periods (co se změnilo a co se opakuje, s důkazy; ne diagnózy)
  • search_fhir, read_fhir_resource, get_provenance, lookup_code
  • validate_fhir_resource, create_fhir_resource, create_patient, import_lab_report
  • sandbox_status, reset_sandbox

Server je uveden v registru MCP jako com.anpheros/fhir. Nastavení pro Claude, ChatGPT a další klienty je na developers.anpheros.com/guides/mcp.

Soukromé modely a rezidence v EU

Platforma za vás nezavolá model; poskytuje kontext a přijímá návrhy. Který model čte kontext, je vaše rozhodnutí: hostované API, soukromé nasazení, model na vlastním hardwaru nemocnice. Samotný záznam zůstává v EU, na Cloud Run v regionu europe-west4, s původem a auditem při každém přístupu.

Co to není

Platforma nediagnostikuje ani nedoporučuje léčbu a kontextové API není podpora klinického rozhodování. Poskytuje modelu fakta, označená, pod souhlasem. To, co model říká, je odpovědností toho, kdo jej nasadí.

Časté otázky

Mohu připojit ChatGPT nebo Claude k lékařskému záznamu pacienta?

Ano, prostřednictvím serveru MCP, se souhlasem osoby prostřednictvím OAuth na jejím vlastním záznamu. Pro vývoj poskytuje sandbox klíč asistentovi 30 syntetických pacientů.

Píše AI do záznamu?

Pouze jako návrh, který osoba schválí. Nic, co AI agent pošle, není aplikováno bez tohoto schválení a přijaté položky jsou označeny jako napsané AI.

Jak zabráním modelu vidět příliš mnoho?

Třemi způsoby: rozsahy, které osoba udělí, filtry kategorií na těchto rozsazích a rozpočet tokenů na volání kontextu, který řadí položky podle klinické relevance a zastaví se u rozpočtu.

Existuje API pro zdravotní chatbot ve mé vlastní aplikaci?

Ano. Vaše aplikace získá souhlas osoby prostřednictvím OAuth, zavolá kontextové API, odešle výsledek modelu, který si vyberete, a pokud model navrhne položku, odešle ji jako zápis; platforma ji přemění na návrh. SDK pro TypeScript a Dart pokrývají volání.

Kde se data zpracovávají?

Záznam je uložen a obsluhován z EU. Kde běží model, je na vás; platforma nikdy neposílá data záznamu samotnému modelu.

Tento návod slouží pouze pro informační účely a nenahrazuje lékařskou radu. Ohledně rozhodnutí o svém zdraví se poraďte se svým lékařem. V případě nouze volejte 112.
O autorovi
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.

Více o Anpheros a autorovi →

Mějte svůj zdravotní záznam stále u sebe

Anpheros Daily uchovává příznaky, výsledky testů, léky a dokumenty na jednom místě, ve standardním formátu, pod vaší kontrolou. Základní plán je zdarma.

Získat Anpheros Daily