Für Entwickler

Medikamentendaten für KI-Agenten: Medikamente mit ATC-Codes kodieren und in FHIR speichern, damit ein Modell sie nutzen kann

Wie Entwickler eine Medikamentendatenbank für einen KI-Agenten auswählen sollten: Was ATC-Codes leisten, was ein gebündelter Terminologie-Subset abdeckt und was nicht (keine Wechselwirkungen), wie MedicationStatement und MedicationAdministration aufgebaut sind und wie ein Agent Medikamente über die Anpheros Platform liest und vorschlägt.

von Veröffentlicht 4 Min. Lesezeit

Ein KI-Agent, der "Nolvadex 20 mg morgens" liest, muss wissen, dass es sich um Tamoxifen handelt, ein Antiestrogen, ATC L02BA01, und dass es sich um eine tägliche orale Dosis handelt, nicht um eine einmalige Einnahme. Woher dieses Wissen stammt und wie die Medikamente gespeichert werden, damit das nächste System sie auf die gleiche Weise liest, ist die eigentliche Frage hinter "welche Medikamentendatenbank soll ich verwenden". Dieser Leitfaden beantwortet sie für die Anpheros-Plattform und ist ehrlich darüber, was die Plattform bietet und was nicht.

Technische Version für Entwickler: Medikamentendaten für KI-Agenten · FHIR-Codesysteme auf developers.anpheros.com, mit Anfragen, Antworten und Limits. Diese Seite ist die Version in einfacher Sprache.

Zuerst Codes: ATC

Die Anatomical Therapeutic Chemical (ATC)-Klassifikation der WHO gibt jeder Wirksubstanz einen Code, der danach organisiert ist, worauf sie wirkt und was sie tut: C09AA02 ist Enalapril (C kardiovaskulär, C09 Renin-Angiotensin, C09AA ACE-Hemmer). ATC ist kostenlos, international und stabil, weshalb Anpheros jedes Medikament damit kodiert. Der Produktname bleibt in code.text, sodass die Person immer noch "Nolvadex" sieht und der Agent L02BA01.

Was ATC Ihnen nicht gibt: Darreichungsformen, Packungsgrößen, nationale Produktidentifikatoren, Preise oder Wechselwirkungen. Diese sind länderspezifisch und oft lizenziert. Ein Agent, der sie benötigt, braucht eine zweite Quelle.

Was die Plattform bietet

  • Ein gebündeltes ATC-Subset zur Suche, ausreichend für die Medikamente, die Menschen in Europa tatsächlich einnehmen, mit Anzeigenamen, durchsuchbar unter GET /v1/terminology/atc?q= und nach Code unter GET /v1/terminology/atc/{code}. Dasselbe Subset unterstützt das MCP-Tool lookup_code. Ein Code außerhalb des Subsets kann immer noch in einer Ressource verwendet werden; die Suche hat einfach keine Anzeige dafür.
  • Ein gebündeltes LOINC-Subset für Messungen und Laborergebnisse, mit denselben Endpunkten unter /v1/terminology/loinc.
  • FHIR-Ressourcen mit der richtigen Struktur: MedicationStatement für den Behandlungsplan (was die Person einnimmt, seit wann, wie oft), MedicationAdministration für jede eingenommene Dosis, verknüpft mit ihrer Aussage, Immunization mit ATC J07 Impfstoffcodes und AllergyIntolerance mit ATC für Medikamentenallergien.

Was die Plattform nicht bietet: eine vollständige Medikamentendatenbank, Wechselwirkungsprüfung, Dosisbereichsprüfung oder klinische Entscheidungsunterstützung. Diese sind bewusst außerhalb, da sie die Plattform zu einem Medizinprodukt machen würden. Wenn Ihr Agent sie benötigt, nutzen Sie einen lizenzierten Dienst und behalten Sie die Plattform als Aufzeichnung.

Wie ein Agent Medikamente liest

Die Kontext-API gibt aktive Medikamente mit ihrem ATC-Code, Text, Dosierung und Herkunft (wer sie eingegeben hat: der Patient, ein Arzt, ein Import) innerhalb eines Token-Budgets zurück, sodass das Modell eine saubere Liste anstelle eines Haufens von Ressourcen sieht. Über MCP ist dasselbe get_patient_context, und search_fhir mit MedicationStatement?patient=…&status=active gibt die Rohressourcen zurück.

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

Wie ein Agent Medikamente schreibt

Er schreibt nicht, er schlägt vor. Eine MedicationStatement, die von einer als KI-Agent registrierten Anwendung gesendet wird, unter Zustimmung der Person, wird validiert und als Vorschlag gehalten. Die Person sieht "Assistent X möchte Tamoxifen 20 mg täglich hinzufügen", akzeptiert oder lehnt ab, und nur ein akzeptierter Vorschlag wird in die Aufzeichnung aufgenommen und als KI-generiert markiert. Der Agent sollte den ATC-Code senden, wenn er sicher ist, und immer den Produktnamen in code.text; ein menschenlesbarer Text ohne Code wird immer noch akzeptiert und kann später kodiert werden.

Vor dem Senden teilt validate_fhir_resource (oder POST /fhir/R4/MedicationStatement/$validate) dem Agenten mit, ob die Ressource gut formatiert ist, sodass die Person niemals gebeten wird, etwas Falsches zu genehmigen.

Auswahl einer zweiten Quelle, falls Sie eine benötigen

Wenn der Agent "interagiert das mit dem" beantworten muss, wählen Sie eine Quelle nach Land (Interaktionsdaten und Produktidentifikatoren unterscheiden sich) und nach Lizenz (die meisten sind kommerziell). Behalten Sie das Ergebnis als Ihre eigene Anmerkung, nicht als Ressource in der Aufzeichnung der Person, es sei denn, ein Kliniker bestätigt es. Die Aufzeichnung sollte das enthalten, was eingenommen wurde; die Beratungsebene ist Ihre.

Häufige Fragen

Hat Anpheros eine vollständige Medikamentendatenbank?

Nein. Es hat ein gebündeltes ATC-Subset zur Kodierung und Suche und speichert Medikamente als FHIR-Ressourcen mit ATC-Codes. Wechselwirkungen, Dosisprüfungen und nationale Produktkataloge sind nicht enthalten.

Warum ATC statt RxNorm oder einer nationalen Liste?

ATC ist international und kostenlos, was für eine Aufzeichnung wichtig ist, die eine Person über Grenzen hinweg begleitet. RxNorm ist US-zentriert; nationale Listen stoppen an der Grenze. Eine Anwendung kann eine zweite Kodierung (z. B. einen nationalen Produktcode) neben der ATC-Kodierung auf derselben Ressource hinzufügen.

Kann ein Agent ein Medikament zur Aufzeichnung einer Person hinzufügen?

Nur als Vorschlag, den die Person genehmigt. Nichts, was ein KI-Agent sendet, wird ohne diese Genehmigung angewendet.

Woher weiß der Agent, wer ein Medikament eingegeben hat?

Jeder Eintrag in der Kontext-API trägt author_type und eine Quelle, und jede Ressource hat eine Provenance. Ein von einem Arzt eingegebenes Medikament und eines, das vom Patienten eingegeben wurde, sehen für das Modell unterschiedlich aus, was der Sinn der Sache ist.

Gibt es eine kostenlose Möglichkeit, dies auszuprobieren?

Ja: Die Sandbox ist kostenlos und ihre 30 synthetischen Patienten haben realistische ATC-kodierte Medikamente. Siehe Kostenloser FHIR-Server: die Sandbox.

Dieser Ratgeber dient der Information und ersetzt keine ärztliche Beratung. Sprechen Sie bei Entscheidungen über Ihre Gesundheit mit Ihrem Arzt oder Ihrer Ärztin. Im Notfall wählen Sie 112.
Über den Autor
Adrian Kereky

Gründer von Anpheros. Elektronikingenieur; sechs Jahre im Bereich autonomes Fahren, in Automobilprojekten in Partnerschaft mit Samsung und NVIDIA, an der Architektur von Fahrerassistenz- und KI-Systemen, die auf NVIDIA-Chips mit CUDA laufen. Danach baute er Anpheros auf: die patientenkontrollierte Patientenakte und die HL7-FHIR-R4-Plattform, auf der sie läuft.

Mehr über Anpheros und den Autor →

Ihre Patientenakte immer dabei

Anpheros Daily bewahrt Symptome, Laborwerte, Medikamente und Dokumente an einem Ort auf, in einem Standardformat und unter Ihrer Kontrolle. Der Basic-Plan ist kostenlos.

Anpheros Daily laden