Provider Directory Service — AI Integration
Status: populated Owner: TBD Last updated: 2026-04-17
1. Scope
No direct vendor AI SDKs. All assistive features route through ai-gateway-service via Kong /v1/ai/* per platform AI Tier B policy.
2. Candidate assists (Tier A — hints, non-authoritative)
| Use case | Template | HITL |
|---|---|---|
| Normalize free-text specialty to SNOMED code | provider.specialty.normalize.v1 | Admin accepts before save |
| Transliterate local-script names to Latin | provider.name.transliterate.v1 | Admin accepts |
| Suggest missing credential types for a specialty | provider.credentials.hint.v1 | Admin reviews |
| Duplicate candidate surfacing for possible-same-practitioner | provider.dedupe.hint.v1 | Admin decides merge |
All outputs are hints; duplicate merge decisions are never AI-automated.
3. Guarantees
- No PHI in prompts (provider data is professional, but names may be sensitive under data protection); minimum-necessary only.
- AIProvenance row written for each accept/reject.
- Audit event
provider_directory.audit.ai.hint_acceptedemitted.
4. Status
Ports reserved for M3+. N/A for M0/M1.