Skip to main content

Interop Service — AI Integration

Status: populated Owner: TBD Last updated: 2026-04-18 Companion: Service Template · 03 platform-services · 02 DDD


1. Current AI Usage

The interop-service does not invoke AI/ML models directly. It is a pure infrastructure/integration layer. No vendor AI SDKs are used.


2. Relationship to AI Gateway

The interop-service is the routing intermediary for AI-relevant clinical data:

  • The ai-gateway-service reads clinical FHIR resources through the FHIR gateway (interop-service) using service-to-service auth + minimum-necessary ABAC scoping.
  • The interop-service enforces that AI service reads are audited and tenant-scoped, the same as any other FHIR consumer.

3. Future: AI-Assisted Mapping (Tier B)

FeaturePurposeHITLStatus
HL7 v2 segment mapping suggestWhen an unknown message type is received, suggest a mapping to FHIR resourcesYes — integration admin accepts/rejectsNot implemented
FHIR profile gap detectionDetect missing required fields in submitted resources before routingRule-based (not LLM)Not implemented

4. Rationale

Integration mapping is a high-precision technical operation. Automated AI-suggested mappings without human validation would risk data corruption. Baseline implementation uses deterministic, tested mapping functions. AI assistance is a stretch goal for complex edge cases.