Zdravotnícke API pre umelú inteligenciu: označený pôvod kontextu pacienta v rámci tokenového rozpočtu

FHIR vyhľadávanie vráti všetko, čo zodpovedá. Jazykový model potrebuje niečo iné: fakty, na ktorých záleží, najprv, každý s uvedením, kto ich zaznamenal, vo veľkosti, ktorá sa hodí do výzvy. Vytvorenie toho zo surových zdrojov je samo o sebe projektom a ak sa to urobí nesprávne, model bude považovať odhad pacienta za laboratórny výsledok. Anpheros kontextové API vykonáva túto prácu na platforme, pod súhlasom osoby, takže model, ktorý si vyberiete, začína od obhájiteľného súhrnu.

Technická verzia pre vývojárov: LLM a zdravotnícke údaje · Prístup agenta AI k lekárskym záznamom na developers.anpheros.com, s požiadavkami, odpoveďami a limitmi. Táto stránka je verzia v bežnom jazyku.

Požiadavka

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 je veľkosť, ktorú si môžete dovoliť vo výzve. task a voliteľná question určujú, ktoré položky idú prvé; needs pomenúva druhy údajov, ktoré chcete; window_days obmedzuje, ako ďaleko dozadu sa má hľadať; format vyberá štruktúrované sekcie alebo spracovaný textový blok. Každé volanie je v denníku prístupu osoby ako čítanie kontextu.

Čo sa vráti

Sekcie označené pôvodom (alebo s format: "text", spracovaný blok pripravený na vloženie do výzvy), plus tokens_used, zoznam omitted pomenúvajúci, čo sa nezmestilo, warnings a provenance_note. Položky sú zoradené podľa klinickej relevance a orezané na rozpočet: najprv aktívne problémy a alergie, potom súčasné lieky, nedávne merania a výsledky, nedávne príznaky, potom staršia anamnéza. Každá položka obsahuje:

• author_type: pacient, lekár, zariadenie, import alebo odvodené;
• source: aplikácia alebo organizácia, ktorá ju napísala;
• dátum, kód (LOINC, ICD-10, ATC) a hodnota s jednotkou;
• pre odvodené položky, z čoho boli odvodené.

Poznámka o pôvode v odpovedi hovorí to isté slovami, takže model, ktorý číta textový blok, sa tiež naučí vážiť položky. Diagnóza zaznamenaná lekárom a pacientom napísané „Myslím, že mám…“ sú obe prítomné a sú odlišne označené.

Na čo je to určené

• Prednávštevný súhrn pre lekára, generovaný modelom, ktorému dôverujete, z faktov s uvedenými zdrojmi.
• Asistent pre pacienta, ktorý odpovedá na otázku „čo hovorili moje posledné výsledky“ s aktuálnymi číslami a dátumami.
• Triage alebo smerovanie vo vašom produkte, kde model potrebuje záznam, ale nesmie vidieť viac, ako osoba povolila.
• Otázky na vzory („čo sa zmenilo od jari“), na ktoré platformový engine na vzory a nástroje compare_periods a get_series poskytujú dôkazy namiesto záverov.

Čo odmieta byť

Kontextové API nie je podpora klinického rozhodovania a platforma za vás model nevolá. Vracia označené fakty; to, čo model povie, je zodpovednosťou toho, kto ho nasadí. API tiež nezahŕňa položky, ktoré sú vylúčené súhlasom osoby: ak povolenie pokrýva pozorovania a lieky, ale nie dokumenty, kontext neobsahuje žiadne dokumenty.

Vždy pod súhlasom

Token v požiadavke patrí osobe, získaný prostredníctvom OAuth 2.1 s rozsahy a trvaním, ktoré si vybrala. Kľúč projektu vidí iba pacientov, ktorých projekt vytvoril. Aplikácia registrovaná ako agent AI môže čítať pod súhlasom a môže navrhovať iba zápisy, ktoré osoba schváli alebo odmietne.

Rovnaký kontext je k dispozícii pre asistentov MCP ako nástroj get_patient_context na platforme platform.anpheros.com/mcp, takže Claude, ChatGPT alebo váš vlastný agent ho číta bez akéhokoľvek kódu na vašej strane. Pozri Integrácia EMR s AI lekárskymi asistentmi.

Časté otázky

Aký model platforma používa?

Žiadny. Platforma buduje kontext; vy ho posielate modelu, ktorý si vyberiete, hostovaný alebo súkromný. Záznam nikdy neopustí EÚ na strane platformy.

Ako je vynucovaný rozpočet?

Položky sú zoradené podľa klinickej relevance a zahrnuté, kým sa nedosiahne rozpočet; zoznam omitted v odpovedi pomenúva, čo bolo vynechané, takže model vie, že kontext je čiastočný.

Môžem požiadať len o časť záznamu?

Áno, tromi spôsobmi: rozsahy súhlasu osoby obmedzujú, čo sa vôbec dá prečítať, needs a window_days zužujú požiadavku a rozpočet oreže zvyšok. Pre surovú kontrolu namiesto toho použite search_fhir alebo koncové body /v1.

Je výstup deterministický?

Pre rovnaký záznam, súhlas a rozpočet, áno. Nové záznamy ho menia, čo je pointa: kontext odráža záznam tak, ako je teraz.

Kde to môžem vyskúšať?

Sandbox je zadarmo a jeho 30 syntetických pacientov má šesť mesiacov kódovanej histórie. Získajte kľúč a zavolajte kontextový koncový bod na ktoromkoľvek z nich: developers.anpheros.com/guides/first-hour.