Integrarea dosarelor medicale electronice cu asistenți medicali AI: un dosar FHIR, un API de context și un server MCP

Conectarea unui model lingvistic la un dosar medical ridică trei întrebări înainte de primul prompt: ce vede modelul, cine a permis acest lucru și ce se întâmplă când acesta dorește să scrie ceva înapoi. Platforma Anpheros răspunde tuturor celor trei în API, astfel încât asistentul pe care îl construiți (sau cel pe care utilizatorii dvs. îl au deja) poate lucra pe un dosar fără a-și inventa propriile reguli. Acest ghid acoperă API-ul de context, serverul MCP și fluxul de propuneri.

Versiune tehnică pentru dezvoltatori: Asistent medical AI · Server MCP pe developers.anpheros.com, cu cereri, răspunsuri și limite. Această pagină este versiunea în limbaj simplu.

Ce vede modelul: API-ul de context

POST /v1/context creează un rezumat pregătit pentru AI al unui pacient, în limita unui buget de tokeni pe care îl stabiliți. Fiecare element poartă author_type (pacient, practician, dispozitiv, import, derivat) și sursa sa, astfel încât modelul poate distinge o valoare de laborator de un simptom auto-raportat și un diagnostic medical de o presupunere. Bugetul decide ce este inclus mai întâi: probleme active, medicamente curente, alergii, rezultate recente, apoi restul. Obțineți secțiuni etichetate sau, cu format: "text", un bloc redat gata pentru un prompt, plus o listă omitted care numește ce nu a încăput.

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

Aceleași etichete de proveniență sunt cele care fac ieșirea defensibilă ulterior: rezumatul unui asistent poate indica de unde provine fiecare afirmație.

Cine a permis acest lucru: consimțământ, nu configurare

Tokenul din apelul de mai sus provine de la persoană, prin OAuth 2.1 cu PKCE, cu domeniile și durata alese de aceasta. O aplicație AI este înregistrată ca oricare alta, solicită ca oricare alta și este listată în "Conexiuni" a persoanei ca oricare alta. Revocarea o oprește la următorul apel. O cheie de proiect vede doar pacienții creați de proiect; nu înlocuiește niciodată consimțământul.

Scriere înapoi: propuneri, nu scrieri

O scriere efectuată sub consimțământul unei persoane de către o aplicație înregistrată ca agent AI este reținută. Platforma o validează, răspunde cu 202 Accepted cu un ID de propunere și nu modifică nimic. Persoana vede propunerea, ce este și ce asistent a trimis-o, și o acceptă sau o respinge. O propunere acceptată este scrisă exact așa cum a fost trimisă, marcată ca fiind scrisă de AI, conform ghidului de transparență AI al HL7. Proiectele care pot vedea dosarul primesc un scurt webhook proposal.created.

Aceasta este regula care permite unui asistent să fie util („Am observat că ați menționat un medicament nou, doriți să-l adaug?”) fără a fi vreodată autorul înregistrării.

Serverul MCP

Asistenții care vorbesc Protocolul de Context al Modelului se conectează direct la https://platform.anpheros.com/mcp (HTTP streamabil). Persoanele se conectează cu OAuth, pe propriul dosar; dezvoltatorii se pot conecta cu o cheie sandbox pe cei 30 de pacienți sintetici. Instrumentele sunt cele pe care le-ați aștepta de la API:

• list_patients, get_patient_context, get_patient_summary (Rezumatul Internațional al Pacientului), get_timeline
• get_health_patterns, get_pattern_evidence, get_series, compare_periods (ce s-a schimbat și ce revine, cu dovezi; nu diagnostice)
• search_fhir, read_fhir_resource, get_provenance, lookup_code
• validate_fhir_resource, create_fhir_resource, create_patient, import_lab_report
• sandbox_status, reset_sandbox

Serverul este listat în registrul MCP ca com.anpheros/fhir. Configurarea pentru Claude, ChatGPT și alți clienți este disponibilă la developers.anpheros.com/guides/mcp.

Modele private și rezidență UE

Platforma nu apelează un model în numele dvs.; servește context și acceptă propuneri. Ce model citește contextul este decizia dvs.: un API găzduit, o implementare privată, un model pe propriul hardware al spitalului. Dosarul în sine rămâne în UE, pe Cloud Run în europe-west4, cu proveniență și audit la fiecare acces.

Ce nu este

Platforma nu diagnostichează și nu recomandă tratament, iar API-ul de context nu este un sistem de suport decizional clinic. Oferă modelului faptele, etichetate, sub consimțământ. Ce spune modelul este responsabilitatea celui care îl implementează.

Întrebări frecvente

Pot conecta ChatGPT sau Claude la un dosar medical?

Da, prin serverul MCP, cu consimțământul OAuth al persoanei pe propriul dosar. Pentru dezvoltare, o cheie sandbox oferă asistentului cei 30 de pacienți sintetici.

AI-ul scrie în dosar?

Doar sub formă de propunere pe care persoana o aprobă. Nimic din ce trimite un agent AI nu este aplicat fără acea aprobare, iar intrările acceptate sunt marcate ca fiind scrise de AI.

Cum împiedic modelul să vadă prea multe?

Trei moduri: domeniile pe care le acordă persoana, filtrele de categorie pe acele domenii și bugetul de tokeni pentru apelul de context, care ordonează elementele după relevanța clinică și se oprește la buget.

Există un API pentru un chatbot de sănătate în propria mea aplicație?

Da. Aplicația dvs. obține consimțământul persoanei prin OAuth, apelează API-ul de context, trimite rezultatul către modelul pe care îl alegeți și, dacă modelul sugerează o intrare, o trimite ca scriere; platforma o transformă într-o propunere. SDK-urile TypeScript și Dart acoperă apelurile.

Unde sunt procesate datele?

Dosarul este stocat și servit din UE. Unde rulează modelul depinde de dvs.; platforma nu trimite niciodată date din dosar către un model.