API de sănătate pentru AI: context al pacientului etichetat cu proveniența, în limita unui buget de tokeni

O căutare FHIR returnează tot ce se potrivește. Un model lingvistic are nevoie de altceva: faptele care contează, mai întâi, fiecare spunând cine le-a înregistrat, într-o dimensiune care se potrivește solicitării. Construirea acestora din resurse brute este un proiect în sine, iar greșirea înseamnă un model care tratează o presupunere a pacientului ca pe un rezultat de laborator. API-ul de context Anpheros face această muncă pe platformă, sub consimțământul persoanei, astfel încât modelul pe care îl alegeți să înceapă dintr-un rezumat defensibil.

Versiune tehnică pentru dezvoltatori: LLM-uri și date din domeniul sănătății · Accesul agenților AI la dosarele medicale pe developers.anpheros.com, cu cereri, răspunsuri și limite. Această pagină este versiunea în limbaj simplu.

Cererea

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 este dimensiunea pe care ți-o permiți în solicitare. task și o question opțională direcționează ce elemente apar primele; needs numește tipurile de date pe care le dorești; window_days limitează cât de departe să caute; format alege secțiuni structurate sau un bloc de text redat. Fiecare apel este în jurnalul de acces al persoanei ca o citire de context.

Ce revine

Secțiuni etichetate cu proveniență (sau, cu format: "text", un bloc redat gata de lipit într-o solicitare), plus tokens_used, o listă omitted care numește ce nu a încăput, warnings și o provenance_note. Elementele sunt ordonate după relevanța clinică și tăiate la buget: probleme active și alergii primele, apoi medicamentele curente, măsurătorile și rezultatele recente, simptomele recente, apoi istoricul mai vechi. Fiecare element conține:

• author_type: pacient, practician, dispozitiv, import sau derivat;
• source: aplicația sau organizația care a scris-o;
• data, codul (LOINC, ICD-10, ATC) și valoarea cu unitatea sa;
• pentru elementele derivate, din ce au fost derivate.

Nota de proveniență din răspuns spune același lucru în cuvinte, astfel încât un model care citește blocul de text învață și să pondereze elementele. Un diagnostic înregistrat de un practician și un "Cred că am…" tastat de pacient sunt ambele prezente și sunt etichetate diferit.

La ce folosește

• Un rezumat pre-vizită pentru un clinician, generat de modelul în care aveți încredere, din fapte cu surse.
• Un asistent pentru pacienți care răspunde la "ce au spus ultimele mele rezultate" cu numerele și datele reale.
• Triaj sau rutare în cadrul produsului dvs., unde modelul are nevoie de dosar, dar nu trebuie să vadă mai mult decât a permis persoana.
• Întrebări despre tipare ("ce s-a schimbat de primăvară"), pentru care motorul de tipare al platformei și instrumentele compare_periods și get_series oferă dovezi, nu concluzii.

Ce refuză să fie

API-ul de context nu este suport pentru decizii clinice, iar platforma nu apelează un model pentru dvs. Returnează fapte etichetate; ceea ce spune modelul este responsabilitatea celui care îl implementează. API-ul nu include nici elementele pe care consimțământul persoanei le exclude: dacă acordul acoperă observațiile și medicamentele, dar nu documentele, contextul nu are documente.

Sub consimțământ, întotdeauna

Tokenul din cerere aparține persoanei, obținut prin OAuth 2.1 cu domeniile și durata alese de aceasta. O cheie de proiect vede doar pacienții creați de proiect. O aplicație înregistrată ca agent AI poate citi sub consimțământ și poate propune doar scrieri, pe care persoana le aprobă sau le respinge.

Același context este disponibil asistenților MCP ca instrumentul get_patient_context pe platform.anpheros.com/mcp, astfel încât Claude, ChatGPT sau propriul dvs. agent îl citește fără niciun cod din partea dvs. Vezi Integrarea EMR cu asistenți medicali AI.

Întrebări frecvente

Ce model folosește platforma?

Niciunul. Platforma construiește contextul; îl trimiteți modelului pe care îl alegeți, găzduit sau privat. Dosarul nu părăsește UE din partea platformei.

Cum este impus bugetul?

Elementele sunt clasificate după relevanța clinică și incluse până la atingerea bugetului; lista omitted din răspuns numește ce a fost omis, astfel încât modelul știe că contextul este parțial.

Pot cere doar o parte din dosar?

Da, în trei moduri: domeniile consimțământului persoanei limitează ce poate fi citit în general, needs și window_days restrâng cererea, iar bugetul taie restul. Pentru control brut, folosiți search_fhir sau endpoint-urile /v1 în schimb.

Este ieșirea deterministă?

Pentru același dosar, consimțământ și buget, da. Intrările noi îl modifică, ceea ce este scopul: contextul reflectă dosarul așa cum este acum.

Unde pot încerca?

Sandbox-ul este gratuit și cei 30 de pacienți sintetici ai săi au șase luni de istoric codificat. Obțineți o cheie și apelați endpoint-ul de context pe oricare dintre ei: developers.anpheros.com/guides/first-hour.