Ενσωμάτωση Ηλεκτρονικών Φακέλων Υγείας (ΗΦΥ) με ιατρικούς βοηθούς Τεχνητής Νοημοσύνης: αρχείο FHIR, API περιβάλλοντος και διακομιστής MCP

Η σύνδεση ενός γλωσσικού μοντέλου με ένα ιατρικό αρχείο εγείρει τρία ερωτήματα πριν από την πρώτη ερώτηση: τι βλέπει το μοντέλο, ποιος έδωσε την άδεια και τι συμβαίνει όταν θέλει να γράψει κάτι πίσω. Η πλατφόρμα Anpheros απαντά και στα τρία στο API, ώστε ο βοηθός που δημιουργείτε (ή αυτός που οι χρήστες σας έχουν ήδη) να μπορεί να εργαστεί σε ένα αρχείο χωρίς να επινοεί δικούς του κανόνες. Αυτός ο οδηγός καλύπτει το API περιβάλλοντος, τον διακομιστή MCP και τη ροή προτάσεων.

Τεχνική έκδοση για προγραμματιστές: Ιατρικός βοηθός AI · Διακομιστής MCP στο developers.anpheros.com, με αιτήματα, απαντήσεις και όρια. Αυτή η σελίδα είναι η απλή έκδοση.

Τι βλέπει το μοντέλο: το API περιβάλλοντος

Το POST /v1/context δημιουργεί μια περίληψη έτοιμη για AI ενός ασθενούς εντός ενός προϋπολογισμού διακριτικών που ορίζετε. Κάθε στοιχείο φέρει author_type (ασθενής, επαγγελματίας, συσκευή, εισαγωγή, παράγωγο) και την πηγή του, ώστε το μοντέλο να μπορεί να διακρίνει μια εργαστηριακή τιμή από ένα αυτο-αναφερόμενο σύμπτωμα και μια διάγνωση γιατρού από μια εικασία. Ο προϋπολογισμός αποφασίζει τι περιλαμβάνεται πρώτα: ενεργά προβλήματα, τρέχοντα φάρμακα, αλλεργίες, πρόσφατα αποτελέσματα, και μετά τα υπόλοιπα. Λαμβάνετε επισημασμένες ενότητες ή, με format: "text", ένα επεξεργασμένο μπλοκ έτοιμο για μια ερώτηση, συν μια λίστα omitted που ονομάζει τι δεν χωρούσε.

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

Οι ίδιες ετικέτες προέλευσης είναι αυτές που καθιστούν την έξοδο υπερασπίσιμη αργότερα: μια περίληψη βοηθού μπορεί να αναφέρει από πού προήλθε κάθε δήλωση.

Ποιος έδωσε την άδεια: συναίνεση, όχι διαμόρφωση

Το διακριτικό στην παραπάνω κλήση προέρχεται από το άτομο, μέσω OAuth 2.1 με PKCE, με τα πεδία και τη διάρκεια που επέλεξε. Μια εφαρμογή AI καταχωρείται όπως οποιαδήποτε άλλη, ζητά όπως οποιαδήποτε άλλη και εμφανίζεται στις "Συνδέσεις" του ατόμου όπως οποιαδήποτε άλλη. Η ανάκληση την σταματά στην επόμενη αίτηση. Ένα κλειδί έργου μόνο του βλέπει μόνο τους ασθενείς που δημιούργησε το έργο· ποτέ δεν αντικαθιστά τη συναίνεση.

Γράφοντας πίσω: προτάσεις, όχι εγγραφές

Μια εγγραφή που γίνεται υπό τη συναίνεση ενός ατόμου από μια εφαρμογή που έχει καταχωρηθεί ως πράκτορας AI, κρατείται. Η πλατφόρμα την επικυρώνει, απαντά 202 Accepted με ένα αναγνωριστικό πρότασης και δεν αλλάζει τίποτα. Το άτομο βλέπει την πρόταση, τι είναι και ποιος βοηθός την έστειλε, και την αποδέχεται ή την απορρίπτει. Μια αποδεκτή πρόταση γράφεται ακριβώς όπως στάλθηκε, επισημασμένη ως γραμμένη από AI σύμφωνα με τις οδηγίες διαφάνειας AI της HL7. Τα έργα που μπορούν να δουν το αρχείο λαμβάνουν ένα λεπτό webhook proposal.created.

Αυτός είναι ο κανόνας που επιτρέπει σε έναν βοηθό να είναι χρήσιμος ("Παρατήρησα ότι αναφέρατε ένα νέο φάρμακο, θέλετε να το προσθέσω;") χωρίς ποτέ να είναι ο συγγραφέας του αρχείου.

Ο διακομιστής MCP

Οι βοηθοί που μιλούν το Πρωτόκολλο Περιβάλλοντος Μοντέλου συνδέονται απευθείας στο https://platform.anpheros.com/mcp (streamable HTTP). Τα άτομα συνδέονται με OAuth, στο δικό τους αρχείο· οι προγραμματιστές μπορούν να συνδεθούν με ένα κλειδί sandbox στους 30 συνθετικούς ασθενείς. Τα εργαλεία είναι αυτά που θα περιμένατε από το API:

• list_patients, get_patient_context, get_patient_summary (η Διεθνής Περίληψη Ασθενούς), get_timeline
• get_health_patterns, get_pattern_evidence, get_series, compare_periods (τι άλλαξε και τι επαναλαμβάνεται, με αποδείξεις· όχι διαγνώσεις)
• search_fhir, read_fhir_resource, get_provenance, lookup_code
• validate_fhir_resource, create_fhir_resource, create_patient, import_lab_report
• sandbox_status, reset_sandbox

Ο διακομιστής αναφέρεται στο μητρώο MCP ως com.anpheros/fhir. Η ρύθμιση για Claude, ChatGPT και άλλους πελάτες βρίσκεται στο developers.anpheros.com/guides/mcp.

Ιδιωτικά μοντέλα και κατοικία στην ΕΕ

Η πλατφόρμα δεν καλεί ένα μοντέλο για λογαριασμό σας· παρέχει περιβάλλον και δέχεται προτάσεις. Ποιο μοντέλο διαβάζει το περιβάλλον είναι δική σας απόφαση: ένα φιλοξενούμενο API, μια ιδιωτική ανάπτυξη, ένα μοντέλο στο δικό σας υλικό ενός νοσοκομείου. Το ίδιο το αρχείο παραμένει στην ΕΕ, στο Cloud Run στην περιοχή europe-west4, με προέλευση και έλεγχο σε κάθε πρόσβαση.

Τι δεν είναι

Η πλατφόρμα δεν διαγιγνώσκει ούτε συνιστά θεραπεία, και το API περιβάλλοντος δεν είναι υποστήριξη κλινικών αποφάσεων. Δίνει στο μοντέλο τα γεγονότα, επισημασμένα, υπό συναίνεση. Το τι λέει το μοντέλο είναι ευθύνη όποιου το αναπτύσσει.

Συχνές ερωτήσεις

Μπορώ να συνδέσω το ChatGPT ή το Claude σε ένα αρχείο ασθενούς;

Ναι, μέσω του διακομιστή MCP, με τη συναίνεση OAuth του ατόμου στο δικό του αρχείο. Για ανάπτυξη, ένα κλειδί sandbox δίνει στον βοηθό τους 30 συνθετικούς ασθενείς.

Το AI γράφει στο αρχείο;

Μόνο ως πρόταση που εγκρίνει το άτομο. Τίποτα που στέλνει ένας πράκτορας AI δεν εφαρμόζεται χωρίς αυτήν την έγκριση, και οι αποδεκτές καταχωρήσεις επισημαίνονται ως γραμμένες από AI.

Πώς μπορώ να αποτρέψω το μοντέλο από το να βλέπει πολλά;

Τρεις τρόποι: τα πεδία που χορηγεί το άτομο, τα φίλτρα κατηγορίας σε αυτά τα πεδία, και ο προϋπολογισμός διακριτικών στην κλήση περιβάλλοντος, η οποία ταξινομεί τα στοιχεία κατά κλινική συνάφεια και σταματά στον προϋπολογισμό.

Υπάρχει API για ένα chatbot υγείας στην εφαρμογή μου;

Ναι. Η εφαρμογή σας αποκτά τη συναίνεση του ατόμου μέσω OAuth, καλεί το API περιβάλλοντος, στέλνει το αποτέλεσμα στο μοντέλο που επιλέγετε και, αν το μοντέλο προτείνει μια καταχώρηση, την υποβάλλει ως εγγραφή· η πλατφόρμα την μετατρέπει σε πρόταση. Τα SDK TypeScript και Dart καλύπτουν τις κλήσεις.

Πού επεξεργάζονται τα δεδομένα;

Το αρχείο αποθηκεύεται και παρέχεται από την ΕΕ. Πού εκτελείται το μοντέλο είναι δική σας απόφαση· η πλατφόρμα δεν στέλνει ποτέ δεδομένα αρχείου σε ένα μοντέλο.