Vysvetlenie CDS Hooks: hooks, karty, prefetch

Krátka odpoveď: CDS Hooks je štandard HL7, ktorý umožňuje EHR (elektronickému zdravotnému záznamu) volať externú službu podpory klinického rozhodovania v definovaných momentoch (hooky) v pracovnom postupe lekára: pri otvorení karty pacienta (patient-view), pri výbere žiadanky (order-select), pri podpise žiadaniek (order-sign), pri začatí alebo ukončení návštevy. EHR pošle kontext a voliteľne prednačítané FHIR dáta; služba odpovie v priebehu sekúnd kartami: krátkymi informáciami, varovaniami alebo návrhmi a odkazmi, ktoré môžu spustiť SMART on FHIR aplikáciu. Lekár zostáva v EHR; inteligencia žije mimo neho.

Tri kroky

CDS Hooks funguje v troch krokoch. Prvý, objavovanie: EHR získa GET /cds-services a dozvie sa, na ktorý hook každá služba reaguje a aké FHIR dáta chce predbežne načítať. Druhý, volanie hooku: pri udalosti pracovného postupu, ako je napríklad podpis objednávky, EHR pošle kontext a predbežne načítané zdroje službe cez POST. Tretí, odpoveď: služba vráti karty, ktoré EHR zobrazí.

1. Objavovanie. EHR načíta GET https://cds.example.org/cds-services a prijme zoznam služieb, každú s hookom, na ktorý reaguje, a FHIR dopytmi, ktoré by chcela prednačítať:

{
  "services": [{
    "id": "renal-dosing",
    "hook": "order-sign",
    "title": "Renal dosing check",
    "description": "Flags drug orders whose dose needs review against the latest eGFR.",
    "prefetch": {
      "patient": "Patient/{{context.patientId}}",
      "egfr": "Observation?patient={{context.patientId}}&code=http://loinc.org|98979-8&_sort=-date&_count=1"
    }
  }]
}

2. Volanie hooku. Keď lekár podpisuje žiadanky, EHR pošle POST na /cds-services/renal-dosing:

{
  "hookInstance": "d1577c69-dfbe-44ad-ba6d-3e05e953b2ea",
  "hook": "order-sign",
  "fhirServer": "https://ehr.example.org/fhir",
  "fhirAuthorization": {"access_token": "…", "token_type": "Bearer", "expires_in": 300, "scope": "patient/*.read", "subject": "renal-dosing"},
  "context": {
    "userId": "Practitioner/42",
    "patientId": "123",
    "draftOrders": {"resourceType": "Bundle", "entry": [{"resource": {"resourceType": "MedicationRequest", "id": "draft-1", "status": "draft"}}]}
  },
  "prefetch": {
    "patient": {"resourceType": "Patient", "id": "123"},
    "egfr": {"resourceType": "Bundle", "type": "searchset", "entry": [{"resource": {"resourceType": "Observation", "id": "obs-9", "status": "final", "code": {"coding": [{"system": "http://loinc.org", "code": "98979-8"}]}, "valueQuantity": {"value": 38, "unit": "mL/min/1.73m2"}}}]}
  }
}

Ak niečo, čo služba potrebuje, nebolo prednačítané, môže si sama dopytovať FHIR server EHR pomocou krátkodobého tokenu v fhirAuthorization.

3. Odpoveď. Karty a vo verzii 2.0 aj systémové akcie:

{
  "cards": [{
    "uuid": "9a1d2f3e-…",
    "summary": "eGFR 38: dose review suggested",
    "indicator": "warning",
    "detail": "The most recent eGFR (38 mL/min/1.73m², 2026-03-10) is below the threshold in the local renal dosing guidance for this drug.",
    "source": {"label": "Hospital renal dosing guidance", "url": "https://intranet.example.org/renal"},
    "suggestions": [{"label": "Open renal dosing table", "uuid": "…", "actions": []}],
    "links": [{"label": "Dosing calculator", "url": "https://apps.example.org/renal/launch", "type": "smart"}]
  }]
}

summary je obmedzený na 140 znakov; indicator je info, warning alebo critical; source je povinný, aby lekár vedel, kto hovorí. suggestions môžu navrhovať konkrétne zmeny (vytvorenie, aktualizáciu alebo odstránenie konceptu zdroja), ktoré lekár prijme jedným kliknutím; links typu smart otvárajú SMART aplikáciu v kontexte. EHR zobrazuje karty vo svojom vlastnom štýle; služba nikdy nekreslí vlastné používateľské rozhranie vnútri EHR.

Doplnky verzie 2.0

CDS Hooks verzie 2.0, publikované v roku 2022, pridali koncový bod spätnej väzby, cez ktorý EHR hlási, či bola karta prijatá, prepísaná s uvedením dôvodov alebo ignorovaná; systemActions, ktoré EHR aplikuje bez opýtania, pre nízkorizikovú údržbu; pole fhirAuthorization.subject; a jasnejšie pravidlá selectionBehavior (at-most-one alebo any) pre návrhy.

Publikované v roku 2022: koncový bod spätnej väzby (POST /cds-services/{id}/feedback), prostredníctvom ktorého EHR hlási, či bola karta prijatá, prepísaná (s dôvodmi) alebo ignorovaná; systemActions, zmeny, ktoré EHR aplikuje bez otázky, určené na nízkorizikovú údržbu, ako je pridanie kódovaného dôvodu; fhirAuthorization.subject; a jasnejšie pravidlá pre selectionBehavior (at-most-one alebo any) pre návrhy.

Čo služba je a čo nie je

Služba CDS Hooks je softvér, ktorý číta kontext pracovného postupu a vracia informácie vo forme kariet; automaticky to nie je lekársky prístroj. To, či sa pravidlá pre lekárske prístroje uplatňujú v EÚ a USA, závisí od obsahu: pripomenutie lekárovi, že existuje laboratórna hodnota, je informácia, zatiaľ čo odporúčanie dávkovania špecifické pre pacienta je regulovaná podpora rozhodovania.

Služba CDS je softvér, ktorý číta kontext a vracia informácie. Či je to zdravotnícke zariadenie, závisí od toho, čo karty hovoria: pripomienka, že existuje laboratórna hodnota, sú informácie; odporúčanie dávkovania pre konkrétneho pacienta je podpora rozhodovania, ktorá spadá pod pravidlá pre zdravotnícke zariadenia v EÚ a USA. Pozri Je zdravotnícka aplikácia zdravotníckym zariadením?. Štandard je neutrálny; obsah nie je.

Dnes definované hooky: patient-view, order-select, order-sign, order-dispatch, encounter-start, encounter-discharge, appointment-book, s verejným katalógom, kde sa navrhujú nové hooky.

Vzťah k SMART on FHIR

CDS Hooks a SMART on FHIR sa dopĺňajú. SMART on FHIR spúšťa aplikáciu, ktorá prevezme časť obrazovky a s autorizáciou používateľa sa dopytuje na FHIR server; CDS Hooks beží na pozadí a vracia karty do vlastného rozhrania EHR. Karta môže obsahovať odkaz na spustenie SMART, keď je potrebných viac ako len karta.

SMART on FHIR spúšťa aplikáciu, ktorá prevezme časť obrazovky a komunikuje s FHIR serverom s autorizáciou používateľa. CDS Hooks beží na pozadí a vracia karty; karta môže niesť odkaz na spustenie SMART, keď je potrebných viac ako len karta. Väčšina produktov na podporu rozhodovania používa obe: hooky pre upozornenie, SMART aplikáciu pre detaily.

Kde Anpheros zapadá

Anpheros neponúka službu CDS Hooks a neposkytuje klinické odporúčania. Jeho FHIR záznam, so súhlasom pacienta, môže byť dátami, ktoré číta vlastná služba podpory rozhodovania nemocnice (lieky, alergie, nedávne výsledky), prostredníctvom rovnakého FHIR API, ktoré by používala služba hook. Pozri Platforma na súhlas pacienta.

Súvisiace stránky

Zdroje

Časté otázky

Je CDS Hooks súčasťou FHIR?

Je to samostatná špecifikácia HL7, ktorá používa FHIR pre svoje dáta: prednačítanie a kontext nesú FHIR zdroje a autorizácia opätovne používa SMART on FHIR tokeny. Je publikovaná HL7 popri FHIR, nie v rámci špecifikácie FHIR.

Ako rýchlo musí služba CDS odpovedať?

Špecifikácia nestanovuje číslo, ale EHR aplikujú časové limity niekoľkých sekúnd a zahadzujú neskoré odpovede, pretože lekár čaká. Prednačítanie existuje práve preto, aby služba nestrávila tento čas dopytovaním.

Môže služba CDS zmeniť objednávku?

Iba navrhnutím návrhu, ktorý lekár prijme, alebo v 2.0 prostredníctvom systemActions, ktoré sa EHR dohodla automaticky aplikovať pre danú službu. Služba nikdy nepíše na FHIR server EHR sama počas hooku.

Používa pacientska aplikácia CDS Hooks?

Nie. CDS Hooks je navrhnutý pre pracovné postupy EHR zamerané na lekárov. Pacientske aplikácie používajú FHIR API priamo a SMART on FHIR na prihlásenie.

Anpheros Platform

Vyskúšajte zadarmo v sandboxe

Prvé volanie FHIR za 5 minút. API podľa štandardu HL7 FHIR R4 s integrovaným súhlasom pacienta: vyskúšajte si ho v sandboxe a potom pripojte svoju vlastnú aplikáciu alebo klinický systém.

Vytvoriť sandbox zadarmo Prečítať návody pre vývojárov →

Zadarmo · 30 syntetických pacientov · bez karty

Tento návod slúži na informačné účely a nenahrádza lekársku radu. Pri rozhodovaní o svojom zdraví sa poraďte so svojím lekárom. V núdzi volajte miestne tiesňové číslo (v Európe 112).

Napísal

Tím Anpheros

Anpheros vyvíja zdravotný záznam, ktorý pacient ovláda a môže zdieľať s akoukoľvek klinikou, na platforme HL7 FHIR R4, so sídlom v EÚ. Tieto návody vám pomôžu pochopiť a usporiadať si svoje zdravie; nenahrádzajú vášho lekára.

O Anpherose →