Date despre medicamente pentru agenți AI: cum să codificați medicamentele cu ATC și să le stocați în FHIR pentru a fi utilizate de un model

Un agent AI care citește „Nolvadex 20 mg dimineața” trebuie să știe că acesta este tamoxifen, un antiestrogenic, ATC L02BA01, și că este o doză orală zilnică, nu una unică. De unde provine această cunoaștere și cum este stocat medicamentul, astfel încât următorul sistem să îl citească în același mod, este adevărata întrebare din spatele „ce bază de date de medicamente ar trebui să folosesc”. Acest ghid răspunde pentru Platforma Anpheros și este sincer cu privire la ceea ce oferă platforma și la ce nu.

Versiune tehnică pentru dezvoltatori: Date despre medicamente pentru agenți AI · Sisteme de coduri FHIR pe developers.anpheros.com, cu cereri, răspunsuri și limite. Această pagină este versiunea în limbaj simplu.

Coduri mai întâi: ATC

Clasificarea Anatomico-Terapeutică Chimică a OMS oferă fiecărei substanțe active un cod organizat în funcție de ce acționează și ce face: C09AA02 este enalapril (C cardiovascular, C09 renină-angiotensină, C09AA inhibitori ai ECA). ATC este gratuit, internațional și stabil, motiv pentru care Anpheros codifică fiecare medicament cu acesta. Numele produsului rămâne în code.text, astfel încât persoana vede în continuare „Nolvadex”, iar agentul vede L02BA01.

Ce nu oferă ATC: forme farmaceutice, dimensiuni ale ambalajelor, identificatori naționali de produs, prețuri sau interacțiuni. Acestea sunt specifice țării și adesea licențiate. Un agent care are nevoie de ele necesită o a doua sursă.

Ce oferă platforma

• Un subset ATC grupat pentru căutare, suficient pentru medicamentele pe care le iau oamenii în Europa, cu nume de afișare, căutabil la GET /v1/terminology/atc?q= și după cod la GET /v1/terminology/atc/{code}. Același subset stă la baza instrumentului MCP lookup_code. Un cod din afara subsetului poate fi în continuare utilizat pe o resursă; căutarea pur și simplu nu are afișare pentru acesta.
• Un subset LOINC grupat pentru măsurători și rezultate de laborator, cu aceleași endpoint-uri sub /v1/terminology/loinc.
• Resurse FHIR cu forma corectă: MedicationStatement pentru planul de tratament (ce ia persoana, de când, cât de des), MedicationAdministration pentru fiecare doză luată, legată de declarația sa, Immunization cu coduri de vaccinuri ATC J07 și AllergyIntolerance cu ATC pentru alergiile la medicamente.

Ce platforma nu oferă: o bază de date completă de medicamente, verificarea interacțiunilor, verificarea intervalului de dozare sau suport pentru decizii clinice. Acestea sunt intenționat în afara platformei, deoarece ar face din platformă un dispozitiv medical. Dacă agentul dumneavoastră are nevoie de ele, utilizați un serviciu licențiat și păstrați platforma ca înregistrare.

Cum citește un agent medicamentele

API-ul de context returnează medicamentele active cu codul ATC, textul, dozajul și proveniența (cine le-a introdus: pacientul, un practician, o importare), în limita unui buget de tokeni, astfel încât modelul să vadă o listă curată, nu un morman de resurse. Prin MCP, același lucru este get_patient_context, iar search_fhir cu MedicationStatement?patient=…&status=active oferă resursele brute.

curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $TOKEN"

Cum scrie un agent medicamentele

Nu scrie, propune. Un MedicationStatement trimis de o aplicație înregistrată ca agent AI, sub consimțământul persoanei, este validat și păstrat ca propunere. Persoana vede „Asistentul X dorește să adauge tamoxifen 20 mg zilnic”, acceptă sau respinge, și doar o propunere acceptată intră în înregistrare, marcată ca fiind scrisă de AI. Agentul ar trebui să trimită codul ATC atunci când este sigur, iar numele produsului în code.text întotdeauna; un text lizibil de om, fără cod, este în continuare acceptat și poate fi codificat ulterior.

Înainte de trimitere, validate_fhir_resource (sau POST /fhir/R4/MedicationStatement/$validate) îi spune agentului dacă resursa este bine formată, astfel încât persoana să nu fie niciodată rugată să aprobe ceva malformat.

Alegerea unei a doua surse, dacă aveți nevoie

Dacă agentul trebuie să răspundă „interacționează acesta cu acela”, alegeți o sursă în funcție de țară (datele de interacțiune și identificatorii de produs diferă) și de licență (majoritatea sunt comerciale). Păstrați rezultatul ca propria dumneavoastră adnotare, nu ca o resursă în înregistrarea persoanei, cu excepția cazului în care un clinician o confirmă. Înregistrarea ar trebui să conțină ce a fost luat; stratul de consiliere este al dumneavoastră.

Întrebări frecvente

Anpheros are o bază de date completă de medicamente?

Nu. Are un subset ATC grupat pentru codificare și căutare și stochează medicamentele ca resurse FHIR cu coduri ATC. Interacțiunile, verificările de dozare și cataloagele naționale de produse nu sunt incluse.

De ce ATC în loc de RxNorm sau o listă națională?

ATC este internațional și gratuit, ceea ce contează pentru o înregistrare care urmărește o persoană peste granițe. RxNorm este centrat pe SUA; listele naționale se opresc la graniță. O aplicație poate adăuga o a doua codificare (de exemplu, un cod național de produs) lângă cel ATC pe aceeași resursă.

Poate un agent să adauge un medicament în înregistrarea unei persoane?

Doar ca propunere pe care persoana o aprobă. Nimic trimis de un agent AI nu este aplicat fără acea aprobare.

Cum știe agentul cine a introdus un medicament?

Fiecare element din API-ul de context poartă author_type și o sursă, iar fiecare resursă are o Proveniență. Un medicament introdus de un practician și unul introdus de pacient arată diferit pentru model, acesta fiind scopul.

Există o modalitate gratuită de a încerca acest lucru?

Da: sandbox-ul este gratuit și cei 30 de pacienți sintetici ai săi au medicamente realiste codificate ATC. Vezi Server FHIR gratuit: sandbox-ul.