API Υγείας για Τεχνητή Νοημοσύνη: Πλαίσιο ασθενούς με ετικέτα προέλευσης εντός ορίου token

Μια αναζήτηση FHIR επιστρέφει ό,τι ταιριάζει. Ένα γλωσσικό μοντέλο χρειάζεται κάτι άλλο: τα γεγονότα που έχουν σημασία, πρώτα, καθένα λέγοντας ποιος τα κατέγραψε, σε ένα μέγεθος που ταιριάζει στην προτροπή. Η δημιουργία αυτού από ακατέργαστους πόρους είναι ένα έργο από μόνη της, και η λανθασμένη εκτέλεση σημαίνει ένα μοντέλο που αντιμετωπίζει την εικασία ενός ασθενούς σαν αποτέλεσμα εργαστηριακής εξέτασης. Το Anpheros context API κάνει αυτή τη δουλειά στην πλατφόρμα, με τη συγκατάθεση του ατόμου, έτσι ώστε το μοντέλο που επιλέγετε να ξεκινά από μια υπερασπίσιμη περίληψη.

Τεχνική έκδοση για προγραμματιστές: LLMs και δεδομένα υγείας · Πρόσβαση AI agent σε ιατρικούς φακέλους στο developers.anpheros.com, με αιτήματα, απαντήσεις και όρια. Αυτή η σελίδα είναι η έκδοση σε απλή γλώσσα.

Το αίτημα

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

Το budget_tokens είναι το μέγεθος που μπορείτε να αντέξετε στην προτροπή. Το task και ένα προαιρετικό question καθορίζουν ποια στοιχεία έρχονται πρώτα· το needs ονομάζει τα είδη δεδομένων που θέλετε· το window_days περιορίζει πόσο πίσω να κοιτάξετε· το format επιλέγει δομημένες ενότητες ή ένα επεξεργασμένο μπλοκ κειμένου. Κάθε κλήση καταγράφεται στο αρχείο πρόσβασης του ατόμου ως ανάγνωση περιβάλλοντος.

Τι επιστρέφεται

Ενότητες με ετικέτα προέλευσης (ή, με format: "text", ένα επεξεργασμένο μπλοκ έτοιμο για επικόλληση σε μια προτροπή), συν tokens_used, μια λίστα omitted που ονομάζει τι δεν χωρούσε, warnings και μια provenance_note. Τα στοιχεία ταξινομούνται κατά κλινική συνάφεια και κόβονται στο όριο: ενεργά προβλήματα και αλλεργίες πρώτα, μετά τρέχοντα φάρμακα, πρόσφατες μετρήσεις και αποτελέσματα, πρόσφατα συμπτώματα, μετά παλαιότερο ιστορικό. Κάθε στοιχείο φέρει:

• author_type: ασθενής, επαγγελματίας υγείας, συσκευή, εισαγωγή ή παράγωγο·
• source: η εφαρμογή ή ο οργανισμός που το έγραψε·
• την ημερομηνία, τον κωδικό (LOINC, ICD-10, ATC) και την τιμή με τη μονάδα της·
• για παράγωγα στοιχεία, από τι προέρχονται.

Η σημείωση προέλευσης στην απάντηση λέει το ίδιο με λόγια, έτσι ώστε ένα μοντέλο που διαβάζει το μπλοκ κειμένου να μαθαίνει επίσης να σταθμίζει τα στοιχεία. Μια διάγνωση που καταγράφηκε από επαγγελματία υγείας και ένα "Νομίζω ότι έχω…" που πληκτρολογήθηκε από ασθενή είναι και τα δύο παρόντα, και επισημαίνονται διαφορετικά.

Για τι χρησιμεύει

• Μια περίληψη πριν την επίσκεψη για έναν κλινικό ιατρό, που δημιουργείται από το μοντέλο που εμπιστεύεστε, από γεγονότα με πηγές.
• Ένας βοηθός για τον ασθενή που απαντά "τι έλεγαν τα τελευταία μου αποτελέσματα" με τους πραγματικούς αριθμούς και τις ημερομηνίες.
• Δρομολόγηση ή ταξινόμηση εντός του προϊόντος σας, όπου το μοντέλο χρειάζεται τον φάκελο αλλά δεν πρέπει να βλέπει περισσότερα από όσα επέτρεψε το άτομο.
• Ερωτήσεις για μοτίβα ("τι άλλαξε από την άνοιξη"), για τις οποίες η μηχανή μοτίβων της πλατφόρμας και τα εργαλεία compare_periods και get_series παρέχουν αποδείξεις αντί για συμπεράσματα.

Τι αρνείται να είναι

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

Με συγκατάθεση, πάντα

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

Το ίδιο περιβάλλον είναι διαθέσιμο στους βοηθούς MCP ως το εργαλείο get_patient_context στο platform.anpheros.com/mcp, έτσι ώστε το Claude, το ChatGPT ή ο δικός σας agent να το διαβάζει χωρίς κανέναν κώδικα από την πλευρά σας. Δείτε Ενσωμάτωση EMR με AI ιατρικούς βοηθούς.

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

Ποιο μοντέλο χρησιμοποιεί η πλατφόρμα;

Κανένα. Η πλατφόρμα δημιουργεί το περιβάλλον· εσείς το στέλνετε στο μοντέλο που επιλέγετε, φιλοξενούμενο ή ιδιωτικό. Ο φάκελος δεν φεύγει ποτέ από την ΕΕ από την πλευρά της πλατφόρμας.

Πώς επιβάλλεται το όριο;

Τα στοιχεία κατατάσσονται κατά κλινική συνάφεια και περιλαμβάνονται μέχρι να επιτευχθεί το όριο· η λίστα omitted στην απάντηση ονομάζει τι έμεινε έξω, έτσι ώστε το μοντέλο να γνωρίζει ότι το περιβάλλον είναι μερικό.

Μπορώ να ζητήσω μόνο μέρος του φακέλου;

Ναι, με τρεις τρόπους: τα πεδία της συγκατάθεσης του ατόμου περιορίζουν τι μπορεί να διαβαστεί καθόλου, τα needs και window_days στενεύουν το αίτημα, και το όριο κόβει τα υπόλοιπα. Για ακατέργαστο έλεγχο χρησιμοποιήστε το search_fhir ή τα /v1 endpoints αντ' αυτού.

Είναι η έξοδος ντετερμινιστική;

Για τον ίδιο φάκελο, συγκατάθεση και όριο, ναι. Νέες καταχωρήσεις το αλλάζουν, που είναι και το νόημα: το περιβάλλον αντικατοπτρίζει τον φάκελο όπως είναι τώρα.

Πού μπορώ να το δοκιμάσω;

Το sandbox είναι δωρεάν και οι 30 συνθετικοί ασθενείς του έχουν έξι μήνες κωδικοποιημένο ιστορικό. Αποκτήστε ένα κλειδί και καλέστε το context endpoint σε οποιονδήποτε από αυτούς: developers.anpheros.com/guides/first-hour.