Zdravotnické API pro umělou inteligenci: označený původ dat pacienta v rámci povoleného objemu tokenů

Vyhledávání FHIR vrátí vše, co odpovídá. Jazykový model potřebuje něco jiného: fakta, na kterých záleží, nejprve, každé s uvedením, kdo je zaznamenal, ve velikosti, která odpovídá požadavku. Vytvoření toho ze surových zdrojů je samo o sobě projekt a jeho špatné provedení znamená model, který považuje odhad pacienta za laboratorní výsledek. Anpheros kontextové API provádí tuto práci na platformě, pod souhlasem osoby, takže model, který si vyberete, začíná od obhajitelného souhrnu.

Technická verze pro vývojáře: LLM a zdravotnická data · Přístup AI agenta k lékařským záznamům na developers.anpheros.com, s požadavky, odpověďmi a limity. Tato stránka je verze v prostém jazyce.

Požadavek

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 velikost, kterou si můžete dovolit v požadavku. task a volitelná question určují, které položky jdou první; needs pojmenovává druhy dat, která chcete; window_days omezuje, jak daleko zpět se má hledat; format vybírá strukturované sekce nebo vykreslený textový blok. Každé volání je v přístupovém logu osoby jako čtení kontextu.

Co se vrátí

Sekce označené původem (nebo s format: "text" vykreslený blok připravený k vložení do požadavku), plus tokens_used, seznam omitted pojmenovávající, co se nevešlo, warnings a provenance_note. Položky jsou seřazeny podle klinické relevance a oříznuty na rozpočet: nejprve aktivní problémy a alergie, poté aktuální léky, nedávná měření a výsledky, nedávné příznaky, poté starší anamnéza. Každá položka obsahuje:

• author_type: pacient, lékař, zařízení, import nebo odvozeno;
• source: aplikace nebo organizace, která ji napsala;
• datum, kód (LOINC, ICD-10, ATC) a hodnota s jednotkou;
• u odvozených položek, z čeho byly odvozeny.

Poznámka o původu v odpovědi říká totéž slovy, takže model, který čte textový blok, se také naučí vážit si položky. Diagnóza zaznamenaná lékařem a pacientem zadané "Myslím, že mám…" jsou obě přítomny a jsou odlišně označeny.

K čemu to je

• Souhrn před návštěvou pro klinika, vygenerovaný modelem, kterému důvěřujete, z faktů se zdroji.
• Asistent pro pacienta, který odpovídá na "co říkaly mé poslední výsledky" s aktuálními čísly a daty.
• Třídění nebo směrování uvnitř vašeho produktu, kde model potřebuje záznam, ale nesmí vidět více, než osoba povolila.
• Dotazy na vzory ("co se změnilo od jara"), pro které platformní engine vzorů a nástroje compare_periods a get_series poskytují důkazy spíše než závěry.

Co to odmítá být

Kontextové API není podpora klinického rozhodování a platforma za vás model nevolá. Vrátí označené fakty; co model říká, je odpovědností toho, kdo jej nasadí. API také nezahrnuje položky, které souhlas osoby vylučuje: pokud se udělení vztahuje na pozorování a léky, ale ne na dokumenty, kontext neobsahuje žádné dokumenty.

Vždy pod souhlasem

Token v požadavku patří osobě, získaný prostřednictvím OAuth 2.1 s rozsahy a dobou platnosti, které si vybrala. Klíč projektu vidí pouze pacienti, které projekt vytvořil. Aplikace registrovaná jako AI agent může číst pod souhlasem a může pouze navrhovat zápisy, které osoba schválí nebo zamítne.

Stejný kontext je k dispozici pro asistenty MCP jako nástroj get_patient_context na platform.anpheros.com/mcp, takže Claude, ChatGPT nebo váš vlastní agent jej čte bez jakéhokoli kódu na vaší straně. Viz Integrace EMR s AI lékařskými asistenty.

Časté otázky

Jaký model platforma používá?

Žádný. Platforma sestavuje kontext; vy jej posíláte modelu, který si vyberete, hostovanému nebo soukromému. Záznam z platformy nikdy neopustí EU.

Jak je vynucován rozpočet?

Položky jsou hodnoceny podle klinické relevance a zahrnuty, dokud není dosaženo rozpočtu; seznam omitted v odpovědi pojmenovává, co bylo vynecháno, takže model ví, že kontext je neúplný.

Mohu požádat pouze o část záznamu?

Ano, třemi způsoby: rozsahy souhlasu osoby omezují, co lze vůbec číst, needs a window_days zužují požadavek a rozpočet ořízne zbytek. Pro surovou kontrolu použijte místo toho search_fhir nebo koncové body /v1.

Je výstup deterministický?

Pro stejný záznam, souhlas a rozpočet, ano. Nové položky jej mění, což je smysl: kontext odráží záznam takový, jaký je nyní.

Kde to mohu vyzkoušet?

Sandbox je zdarma a jeho 30 syntetických pacientů má šest měsíců kódované historie. Získejte klíč a zavolejte kontextový koncový bod na kterémkoli z nich: developers.anpheros.com/guides/first-hour.