ربط السجلات الطبية الإلكترونية بمساعدي الذكاء الاصطناعي الطبي: سجل FHIR، واجهة برمجة تطبيقات السياق، وخادم MCP

عند ربط نموذج لغوي بسجل طبي، تظهر ثلاثة أسئلة قبل الاستعلام الأول: ماذا يرى النموذج، ومن سمح بذلك، وماذا يحدث عندما يريد كتابة شيء ما مرة أخرى. منصة Anpheros تجيب على هذه الأسئلة الثلاثة في واجهة برمجة التطبيقات (API)، بحيث يمكن للمساعد الذي تبنيه (أو الذي يمتلكه مستخدموك بالفعل) العمل على سجل دون اختراع قواعده الخاصة. يغطي هذا الدليل واجهة برمجة تطبيقات السياق (context API)، وخادم MCP، وتدفق الاقتراحات.

نسخة تقنية للمطورين: مساعد طبي بالذكاء الاصطناعي · خادم MCP على developers.anpheros.com، مع الطلبات والاستجابات والحدود. هذه الصفحة هي النسخة بلغة واضحة.

ماذا يرى النموذج: واجهة برمجة تطبيقات السياق (context API)

يقوم POST /v1/context بإنشاء ملخص جاهز للذكاء الاصطناعي لمريض ضمن ميزانية رموز تحددها. كل عنصر يحمل 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، مع النطاقات والمدة التي اختارها. يتم تسجيل تطبيق الذكاء الاصطناعي مثل أي تطبيق آخر، ويطلب مثل أي تطبيق آخر، ويُدرج في "الاتصالات" الخاصة بالشخص مثل أي تطبيق آخر. يؤدي الإلغاء إلى إيقافه عند الطلب التالي. مفتاح المشروع وحده يرى فقط المرضى الذين أنشأهم المشروع؛ ولا يحل محل الموافقة أبدًا.

الكتابة مرة أخرى: اقتراحات، وليس كتابات

يتم الاحتفاظ بالكتابة التي تتم بموافقة شخص ما بواسطة تطبيق مسجل كوكيل ذكاء اصطناعي. تقوم المنصة بالتحقق منها، وترد بـ 202 Accepted مع معرف اقتراح، ولا تغير شيئًا. يرى الشخص الاقتراح، وما هو، وأي مساعد أرسله، ويقبله أو يرفضه. يتم كتابة الاقتراح المقبول تمامًا كما تم إرساله، ويُشار إليه على أنه مكتوب بواسطة الذكاء الاصطناعي وفقًا لإرشادات الشفافية للذكاء الاصطناعي الخاصة بـ HL7. تتلقى المشاريع التي يمكنها رؤية السجل إشعارًا خفيفًا proposal.created عبر الويب.

هذه هي القاعدة التي تسمح للمساعد بأن يكون مفيدًا ("لاحظت أنك ذكرت دواءً جديدًا، هل أضيفه؟") دون أن يكون أبدًا مؤلف السجل.

خادم MCP

تتصل المساعدات التي تتحدث بروتوكول سياق النموذج (Model Context Protocol) مباشرة بـ https://platform.anpheros.com/mcp (HTTP قابل للبث). يتصل الأشخاص باستخدام OAuth، على سجلهم الخاص؛ يمكن للمطورين الاتصال بمفتاح تجريبي على المرضى الاصطناعيين الـ 30. الأدوات هي تلك التي تتوقعها من واجهة برمجة التطبيقات:

• 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.

نماذج خاصة وإقامة في الاتحاد الأوروبي

لا تتصل المنصة بنموذج نيابة عنك؛ بل تقدم السياق وتقبل الاقتراحات. أي نموذج يقرأ السياق هو قرارك: واجهة برمجة تطبيقات مستضافة، نشر خاص، نموذج على أجهزة المستشفى الخاصة. يبقى السجل نفسه في الاتحاد الأوروبي، على Cloud Run في europe-west4، مع المصدر والتدقيق في كل وصول.

ما ليس هو

المنصة لا تشخص ولا توصي بالعلاج، وواجهة برمجة تطبيقات السياق ليست دعمًا للقرار السريري. إنها تعطي النموذج الحقائق، مُعلمة، بموجب الموافقة. ما يقوله النموذج هو مسؤولية من يقوم بنشره.

الأسئلة الشائعة

هل يمكنني توصيل ChatGPT أو Claude بسجل مريض؟

نعم، من خلال خادم MCP، بموافقة OAuth من الشخص على سجله الخاص. للتطوير، يمنح مفتاح الاختبار المساعد المرضى الاصطناعيين الـ 30.

هل يكتب الذكاء الاصطناعي في السجل؟

فقط كاقتراح يوافق عليه الشخص. لا يتم تطبيق أي شيء ترسله وكالة ذكاء اصطناعي بدون هذه الموافقة، ويتم تمييز الإدخالات المقبولة على أنها مكتوبة بواسطة الذكاء الاصطناعي.

كيف أمنع النموذج من رؤية الكثير؟

ثلاث طرق: النطاقات التي يمنحها الشخص، وفلاتر الفئة على تلك النطاقات، وميزانية الرموز في استدعاء السياق، والتي ترتب العناصر حسب الأهمية السريرية وتتوقف عند الميزانية.

هل هناك واجهة برمجة تطبيقات لروبوت محادثة صحي في تطبيقي الخاص؟

نعم. يحصل تطبيقك على موافقة الشخص عبر OAuth، ويستدعي واجهة برمجة تطبيقات السياق، ويرسل النتيجة إلى النموذج الذي تختاره، وإذا اقترح النموذج إدخالاً، فإنه يقدمه ككتابة؛ تقوم المنصة بتحويله إلى اقتراح. تغطي حزم تطوير البرامج TypeScript و Dart المكالمات.

أين تتم معالجة البيانات؟

يتم تخزين السجل وتقديمه من الاتحاد الأوروبي. أين يعمل النموذج متروك لك؛ لا ترسل المنصة أبدًا بيانات السجل إلى نموذج بنفسها.