Dane o lekach dla agentów AI: jak kodować leki za pomocą ATC i przechowywać je w FHIR, aby model mógł z nich korzystać

Agent AI, który odczytuje "Nolvadex 20 mg rano", musi wiedzieć, że jest to tamoksyfen, antyestrogen, ATC L02BA01, i że jest to codzienna dawka doustna, a nie jednorazowa. Skąd pochodzi ta wiedza i jak przechowywane są leki, aby następny system odczytywał je w ten sam sposób, to prawdziwe pytanie kryjące się za "z jakiej bazy danych leków powinienem skorzystać". Ten przewodnik odpowiada na nie dla platformy Anpheros i jest szczery co do tego, co platforma oferuje, a czego nie.

Wersja techniczna dla deweloperów: Dane dotyczące leków dla agentów AI · Systemy kodów FHIR na developers.anpheros.com, z żądaniami, odpowiedziami i limitami. Ta strona jest wersją w języku prostym.

Najpierw kody: ATC

Klasyfikacja Anatomical Therapeutic Chemical (ATC) Światowej Organizacji Zdrowia (WHO) nadaje każdej substancji czynnej kod zorganizowany według tego, na co działa i co robi: C09AA02 to enalapril (C układ krążenia, C09 układ renina-angiotensyna, C09AA inhibitory ACE). ATC jest bezpłatne, międzynarodowe i stabilne, dlatego Anpheros koduje nim każdy lek. Nazwa produktu pozostaje w code.text, dzięki czemu osoba nadal widzi "Nolvadex", a agent widzi L02BA01.

Czego ATC nie daje: postaci dawkowania, rozmiarów opakowań, krajowych identyfikatorów produktów, cen ani interakcji. Są one specyficzne dla kraju i często licencjonowane. Agent, który ich potrzebuje, potrzebuje drugiego źródła.

Co oferuje platforma

• Zestaw ATC do wyszukiwania: wystarczający dla leków, które ludzie w Europie faktycznie przyjmują, z nazwami wyświetlanymi, przeszukiwalny pod adresem GET /v1/terminology/atc?q= i według kodu pod adresem GET /v1/terminology/atc/{code}. Ten sam zestaw zasila narzędzie MCP lookup_code. Kod spoza zestawu może być nadal używany w zasobie; wyszukiwanie po prostu nie będzie miało dla niego wyświetlanej nazwy.
• Zestaw LOINC do pomiarów i wyników laboratoryjnych: z tymi samymi punktami końcowymi pod adresem /v1/terminology/loinc.
• Zasoby FHIR o odpowiednim kształcie: MedicationStatement dla planu leczenia (co osoba przyjmuje, od kiedy, jak często), MedicationAdministration dla każdej przyjętej dawki, powiązanej z tym oświadczeniem, Immunization z kodami szczepionek ATC J07 oraz AllergyIntolerance z kodami ATC dla alergii na leki.

Czego platforma nie oferuje: kompletnej bazy danych leków, sprawdzania interakcji, sprawdzania zakresu dawek ani wsparcia decyzji klinicznych. Są one celowo poza zakresem, ponieważ uczyniłyby platformę urządzeniem medycznym. Jeśli Twój agent ich potrzebuje, skorzystaj z licencjonowanej usługi i zachowaj platformę jako zapis.

Jak agent odczytuje leki

API kontekstu zwraca aktywne leki z ich kodem ATC, tekstem, dawkowaniem i pochodzeniem (kto je wprowadził: pacjent, lekarz, import), w ramach budżetu tokenów, dzięki czemu model widzi czystą listę, a nie stos zasobów. W ramach MCP to samo jest get_patient_context, a search_fhir z MedicationStatement?patient=…&status=active daje surowe zasoby.

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

Jak agent zapisuje leki

Nie zapisuje, proponuje. MedicationStatement wysłany przez aplikację zarejestrowaną jako agent AI, za zgodą osoby, jest walidowany i przechowywany jako propozycja. Osoba widzi "Asystent X chce dodać tamoksyfen 20 mg dziennie", akceptuje lub odrzuca, a dopiero zaakceptowana propozycja trafia do rejestru, oznaczona jako napisana przez AI. Agent powinien wysyłać kod ATC, gdy jest pewny, i zawsze nazwę produktu w code.text; tekst czytelny dla człowieka bez kodu jest nadal akceptowany i może być zakodowany później.

Przed wysłaniem validate_fhir_resource (lub POST /fhir/R4/MedicationStatement/$validate) informuje agenta, czy zasób jest poprawnie uformowany, dzięki czemu osoba nigdy nie jest proszona o zatwierdzenie czegoś niepoprawnego.

Wybór drugiego źródła, jeśli go potrzebujesz

Jeśli agent musi odpowiedzieć na pytanie "czy to wchodzi w interakcję z tym", wybierz źródło według kraju (dane o interakcjach i identyfikatory produktów różnią się) i według licencji (większość jest komercyjna). Zachowaj wynik jako własną adnotację, a nie jako zasób w rejestrze osoby, chyba że lekarz go potwierdzi. Rejestr powinien zawierać to, co zostało przyjęte; warstwa porad jest Twoja.

Najczęstsze pytania

Czy Anpheros posiada pełną bazę danych leków?

Nie. Posiada zestaw ATC do kodowania i wyszukiwania, a leki przechowuje jako zasoby FHIR z kodami ATC. Interakcje, kontrole dawek i krajowe katalogi produktów nie są uwzględnione.

Dlaczego ATC zamiast RxNorm lub listy krajowej?

ATC jest międzynarodowe i bezpłatne, co ma znaczenie dla rejestru, który podąża za osobą przez granice. RxNorm jest skoncentrowany na USA; listy krajowe kończą się na granicy. Aplikacja może dodać drugie kodowanie (na przykład krajowy kod produktu) obok kodu ATC w tym samym zasobie.

Czy agent może dodać lek do rejestru osoby?

Tylko jako propozycję, którą osoba zatwierdzi. Nic, co wysyła agent AI, nie jest stosowane bez tej zgody.

Skąd agent wie, kto wprowadził lek?

Każdy element w API kontekstu zawiera author_type i źródło, a każdy zasób ma Provenance. Lek wprowadzony przez lekarza i jeden wprowadzony przez pacjenta wyglądają inaczej dla modelu, o to właśnie chodzi.

Czy istnieje darmowy sposób, aby to wypróbować?

Tak: piaskownica jest bezpłatna, a jej 30 syntetycznych pacjentów ma realistyczne leki zakodowane w ATC. Zobacz Bezpłatny serwer FHIR: piaskownica.