Prepojenie jazykového modelu s lekárskym záznamom vyvoláva tri otázky ešte pred prvým zadaním: čo model vidí, kto to povolil a čo sa stane, keď chce niečo napísať späť. Anpheros Platform odpovedá na všetky tri v API, takže asistent, ktorého vytvoríte (alebo ktorého už vaši používatelia majú), môže pracovať so záznamom bez toho, aby si vymýšľal vlastné pravidlá. Táto príručka pokrýva kontextové API, MCP server a proces návrhov.
Technická verzia pre vývojárov: AI lekársky asistent · MCP server na developers.anpheros.com, s požiadavkami, odpoveďami a limitmi. Táto stránka je verzia v bežnom jazyku.
Čo model vidí: kontextové API
POST /v1/context vytvorí súhrn pacienta pripravený pre AI v rámci vami nastaveného rozpočtu tokenov. Každá položka nesie author_type (pacient, lekár, zariadenie, import, odvodené) a jej zdroj, takže model dokáže rozlíšiť laboratórnu hodnotu od symptómu hláseného pacientom a diagnózu lekára od odhadu. Rozpočet rozhoduje, čo sa zahrnie ako prvé: aktívne problémy, súčasné lieky, alergie, nedávne výsledky, potom zvyšok. Dostanete označené sekcie alebo s format: "text" pripravený blok na zadanie, plus zoznam omitted pomenúvajúci, čo sa nezmestilo.
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"}'
Rovnaké štítky pôvodu sú to, čo robí výstup neskôr obhájiteľným: súhrn asistenta môže uviesť, odkiaľ každé tvrdenie pochádza.
Kto to povolil: súhlas, nie konfigurácia
Token vo vyššie uvedenom volaní pochádza od osoby, prostredníctvom OAuth 2.1 s PKCE, s vybranými rozsahami a trvaním. Aplikácia AI sa registruje ako každá iná, žiada ako každá iná a je uvedená v časti "Pripojenia" osoby ako každá iná. Odvolanie ju zastaví pri ďalšej požiadavke. Samotný kľúč projektu vidí iba pacientov, ktorých projekt vytvoril; nikdy nenahrádza súhlas.
Písanie späť: návrhy, nie zápisy
Zápis vykonaný pod súhlasom osoby aplikáciou registrovanou ako AI agent je pozdržaný. Platforma ho overí, odpovie 202 Accepted s ID návrhu a nič nezmení. Osoba vidí návrh, čo to je a ktorý asistent ho poslal, a prijme alebo odmietne ho. Prijatý návrh sa zapíše presne tak, ako bol odoslaný, označený ako napísaný AI v súlade s pokynmi HL7 pre transparentnosť AI. Projekty, ktoré vidia záznam, dostanú tenký webhook proposal.created.
Toto je pravidlo, ktoré umožňuje asistentovi byť užitočným ("Všimol som si, že ste spomenuli nový liek, mám ho pridať?") bez toho, aby bol kedykoľvek autorom záznamu.
MCP server
Asistenti, ktorí hovoria protokolom Model Context Protocol, sa pripájajú priamo na https://platform.anpheros.com/mcp (streamovateľné HTTP). Ľudia sa pripájajú pomocou OAuth, na svoj vlastný záznam; vývojári sa môžu pripojiť pomocou sandbox kľúča na 30 syntetických pacientoch. Nástroje sú tie, ktoré by ste očakávali od API:
list_patients,get_patient_context,get_patient_summary(International Patient Summary),get_timelineget_health_patterns,get_pattern_evidence,get_series,compare_periods(čo sa zmenilo a čo sa opakuje, s dôkazmi; nie diagnózy)search_fhir,read_fhir_resource,get_provenance,lookup_codevalidate_fhir_resource,create_fhir_resource,create_patient,import_lab_reportsandbox_status,reset_sandbox
Server je uvedený v registri MCP ako com.anpheros/fhir. Nastavenie pre Claude, ChatGPT a ďalších klientov je na developers.anpheros.com/guides/mcp.
Súkromné modely a rezidencia v EÚ
Platforma nevykonáva volania modelu vaším menom; poskytuje kontext a prijíma návrhy. Ktorý model číta kontext, je na vašom rozhodnutí: hostované API, súkromná implementácia, model na vlastnom hardvéri nemocnice. Samotný záznam zostáva v EÚ, na Cloud Run v europe-west4, s pôvodom a auditom pri každom prístupe.
Čo to nie je
Platforma nediagnostikuje ani neodporúča liečbu a kontextové API nie je klinická podpora rozhodovania. Poskytuje modelu fakty, označené, pod súhlasom. To, čo model hovorí, je zodpovednosťou toho, kto ho nasadí.
Časté otázky
Môžem pripojiť ChatGPT alebo Claude k lekárskemu záznamu pacienta?
Áno, prostredníctvom MCP servera, so súhlasom osoby cez OAuth na jej vlastnom zázname. Pre vývoj je sandbox kľúč poskytuje asistentovi 30 syntetických pacientov.
Píše AI do záznamu?
Iba ako návrh, ktorý osoba schváli. Nič, čo AI agent pošle, sa neaplikuje bez tohto schválenia a prijaté záznamy sú označené ako napísané AI.
Ako zabránim modelu vidieť príliš veľa?
Tri spôsoby: rozsahy, ktoré osoba udeľuje, filtre kategórií na týchto rozsahu a rozpočet tokenov na volanie kontextu, ktorý triedi položky podľa klinickej relevance a zastaví sa pri rozpočte.
Existuje API pre zdravotný chatbot v mojej vlastnej aplikácii?
Áno. Vaša aplikácia získa súhlas osoby prostredníctvom OAuth, zavolá kontextové API, pošle výsledok modelu, ktorý si vyberiete, a ak model navrhne záznam, odošle ho ako zápis; platforma ho premení na návrh. SDK v TypeScript a Dart pokrývajú volania.
Kde sa spracúvajú údaje?
Záznam je uložený a obsluhovaný z EÚ. Kde beží model, je na vás; platforma nikdy neposiela údaje zo záznamu do samotného modelu.
Majte svoj zdravotný záznam stále pri sebe
Anpheros Daily uchováva príznaky, výsledky vyšetrení, lieky a dokumenty na jednom mieste, v štandardnom formáte, pod vašou kontrolou. Základný plán je bezplatný.