Dáta o liekoch pre AI agentov: ako kódovať lieky pomocou ATC a ukladať ich vo FHIR, aby ich model mohol použiť

AI agent, ktorý číta „Nolvadex 20 mg ráno“, potrebuje vedieť, že ide o tamoxifén, antiestrogén, ATC L02BA01, a že ide o dennú perorálnu dávku, nie jednorazovú. Odkiaľ tieto znalosti pochádzajú a ako sú lieky uložené, aby si ich ďalší systém prečítal rovnako, je skutočnou otázkou za „ktorú databázu liekov by som mal použiť“. Tento sprievodca na ne odpovedá pre platformu Anpheros a je úprimný o tom, čo platforma poskytuje a čo nie.

Technická verzia pre vývojárov: Dáta o liekoch pre AI agentov · Kódové systémy FHIR na developers.anpheros.com, s požiadavkami, odpoveďami a limitmi. Táto stránka je verzia v bežnom jazyku.

Najprv kódy: ATC

Anatomicko-terapeuticko-chemická klasifikácia WHO prideľuje každej účinnej látke kód organizovaný podľa toho, na čo pôsobí a čo robí: C09AA02 je enalapril (C kardiovaskulárne, C09 renín-angiotenzín, C09AA ACE inhibítory). ATC je bezplatné, medzinárodné a stabilné, preto Anpheros každý liek kóduje pomocou neho. Názov produktu zostáva v code.text, takže osoba stále vidí „Nolvadex“ a agent vidí L02BA01.

Čo ATC neposkytuje: liekové formy, veľkosti balení, národné identifikačné kódy produktov, ceny ani interakcie. Tie sú špecifické pre krajinu a často licencované. Agent, ktorý ich potrebuje, potrebuje druhý zdroj.

Čo platforma poskytuje

• Zoskupený pododbor ATC na vyhľadávanie, dostatočný pre lieky, ktoré ľudia v Európe skutočne užívajú, s zobrazovanými názvami, vyhľadávateľný na GET /v1/terminology/atc?q= a podľa kódu na GET /v1/terminology/atc/{code}. Rovnaký pododbor podporuje nástroj MCP lookup_code. Kód mimo pododboru môže byť stále použitý na zdroji; vyhľadávanie preň jednoducho nemá zobrazenie.
• Zoskupený pododbor LOINC pre merania a laboratórne výsledky, s rovnakými koncovými bodmi pod /v1/terminology/loinc.
• Zdroje FHIR so správnym tvarom: MedicationStatement pre liečebný plán (čo osoba užíva, od kedy, ako často), MedicationAdministration pre každú podanú dávku, prepojenú s jej vyhlásením, Immunization s kódmi vakcín ATC J07 a AllergyIntolerance s ATC pre alergie na lieky.

Čo platforma neposkytuje: kompletnú databázu liekov, kontrolu interakcií, kontrolu dávkovacích rozsahov ani klinickú podporu rozhodovania. Tie sú zámerne mimo, pretože by z platformy urobili lekársky prístroj. Ak ich váš agent potrebuje, použite licencovanú službu a platformu ponechajte ako záznam.

Ako agent číta lieky

Kontextové API vracia aktívne lieky s ich ATC kódom, textom, dávkovaním a pôvodom (kto ich zadal: pacient, lekár, import), v rámci rozpočtu tokenov, takže model vidí prehľadný zoznam namiesto hromady zdrojov. Cez MCP je to rovnaké ako get_patient_context a search_fhir s MedicationStatement?patient=…&status=active poskytuje surové zdroje.

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

Ako agent píše lieky

Nepíše, navrhuje. MedicationStatement odoslaný aplikáciou registrovanou ako AI agent, so súhlasom osoby, je validovaný a držaný ako návrh. Osoba vidí „Asistent X chce pridať tamoxifén 20 mg denne“, prijme alebo odmietne, a iba prijatý návrh vstúpi do záznamu, označený ako napísaný AI. Agent by mal poslať ATC kód, keď je si istý, a vždy názov produktu v code.text; text čitateľný pre ľudí bez kódu je stále akceptovaný a môže byť kódovaný neskôr.

Pred odoslaním validate_fhir_resource (alebo POST /fhir/R4/MedicationStatement/$validate) povie agentovi, či je zdroj správne formovaný, takže osoba nikdy nie je požiadaná o schválenie niečoho nesprávne formovaného.

Výber druhého zdroja, ak ho potrebujete

Ak musí agent odpovedať „interaguje toto s týmto“, vyberte zdroj podľa krajiny (údaje o interakciách a identifikačné kódy produktov sa líšia) a podľa licencie (väčšina je komerčná). Výsledok si ponechajte ako svoju vlastnú anotáciu, nie ako zdroj v zázname osoby, pokiaľ ho nepotvrdí lekár. Záznam by mal obsahovať to, čo bolo užité; vrstva poradenstva je vaša.

Časté otázky

Má Anpheros kompletnú databázu liekov?

Nie. Má zoskupený pododbor ATC na kódovanie a vyhľadávanie a ukladá lieky ako zdroje FHIR s ATC kódmi. Interakcie, kontroly dávkovania a národné katalógy produktov nie sú zahrnuté.

Prečo ATC namiesto RxNorm alebo národného zoznamu?

ATC je medzinárodné a bezplatné, čo je dôležité pre záznam, ktorý sleduje osobu cez hranice. RxNorm je zameraný na USA; národné zoznamy končia na hraniciach. Aplikácia môže pridať druhé kódovanie (napríklad národný kód produktu) vedľa ATC kódu na tom istom zdroji.

Môže agent pridať liek do záznamu osoby?

Iba ako návrh, ktorý osoba schváli. Nič, čo AI agent pošle, sa neaplikuje bez tohto súhlasu.

Ako agent vie, kto zadal liek?

Každá položka v kontextovom API nesie author_type a zdroj, a každý zdroj má Provenance. Liek zadaný lekárom a liek zadaný pacientom vyzerajú pre model odlišne, čo je pointa.

Existuje bezplatný spôsob, ako to vyskúšať?

Áno: sandbox je bezplatný a jeho 30 syntetických pacientov má realistické lieky kódované podľa ATC. Pozri Bezplatný FHIR server: sandbox.