CDS Hooks: haki, karty, prefetch

Krótka odpowiedź: CDS Hooks to standard HL7, który pozwala systemowi EHR (Elektronicznej Dokumentacji Medycznej) na wywoływanie zewnętrznej usługi wsparcia decyzji klinicznych w określonych momentach (hakach) w przepływie pracy klinicysty: podczas otwierania karty pacjenta (patient-view), wybierania zlecenia (order-select), podpisywania zleceń (order-sign), rozpoczynania lub kończenia wizyty. System EHR wysyła kontekst i opcjonalnie dane FHIR pobrane z wyprzedzeniem; usługa odpowiada w ciągu kilku sekund kartami: krótkimi informacjami, ostrzeżeniami lub sugestiami oraz linkami, które mogą uruchomić aplikację SMART on FHIR. Klinicysta pozostaje w systemie EHR; inteligencja znajduje się poza nim.

Trzy kroki

CDS Hooks działa w trzech krokach. Po pierwsze, odkrywanie: system EHR pobiera GET /cds-services i dowiaduje się, na który hook odpowiada każda usługa i jakie dane FHIR chce wstępnie pobrać. Po drugie, wywołanie hooka: podczas zdarzenia w przepływie pracy, takiego jak zatwierdzenie zlecenia, system EHR wysyła POST kontekst i wstępnie pobrane zasoby do usługi. Po trzecie, odpowiedź: usługa zwraca karty, które system EHR wyświetla.

1. Odkrywanie. System EHR pobiera GET https://cds.example.org/cds-services i otrzymuje listę usług, każda z hakiem, na który odpowiada, oraz zapytaniami FHIR, które chciałaby pobrać z wyprzedzeniem:

{
  "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. Wywołanie haka. Kiedy klinicysta podpisuje zlecenia, system EHR wysyła żądanie POST do /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"}}}]}
  }
}

Jeśli coś, czego potrzebuje usługa, nie zostało pobrane z wyprzedzeniem, może ona samodzielnie zapytać serwer FHIR systemu EHR za pomocą krótkotrwałego tokenu w fhirAuthorization.

3. Odpowiedź. Karty, a w wersji 2.0 także akcje systemowe:

{
  "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 jest ograniczony do 140 znaków; indicator to info, warning lub critical; source jest obowiązkowy, aby klinicysta wiedział, kto mówi. suggestions mogą proponować konkretne zmiany (utworzenie, aktualizację lub usunięcie wersji roboczej zasobu), które klinicysta akceptuje jednym kliknięciem; links typu smart otwierają aplikację SMART w kontekście. System EHR renderuje karty we własnym stylu; usługa nigdy nie rysuje własnego interfejsu użytkownika wewnątrz systemu EHR.

Dodatki do wersji 2.0

CDS Hooks w wersji 2.0, opublikowanej w 2022 roku, dodał punkt końcowy informacji zwrotnej, za pomocą którego system EHR zgłasza, czy karta została zaakceptowana, odrzucona z podaniem przyczyn, czy zignorowana; systemActions, zmiany, które system EHR stosuje bez pytania, w celu rutynowego porządkowania o niskim ryzyku; pole fhirAuthorization.subject; oraz jaśniejsze zasady selectionBehavior (at-most-one lub any) dla sugestii.

Opublikowane w 2022 roku: punkt końcowy feedback (POST /cds-services/{id}/feedback), za pomocą którego system EHR zgłasza, czy karta została zaakceptowana, odrzucona (z podaniem przyczyn) czy zignorowana; systemActions, czyli zmiany, które system EHR stosuje bez pytania, przeznaczone do rutynowych, niskiego ryzyka zadań, takich jak dodanie zakodowanego powodu; fhirAuthorization.subject; oraz jaśniejsze zasady dotyczące selectionBehavior (at-most-one lub any) dla sugestii.

Czym jest usługa, a czym nie jest

Usługa CDS Hooks to oprogramowanie, które odczytuje kontekst przepływu pracy i zwraca informacje w postaci kart; nie jest to automatycznie urządzenie medyczne. To, czy zasady dotyczące urządzeń medycznych mają zastosowanie w UE i USA, zależy od treści: przypomnienie lekarzowi o istnieniu wartości laboratoryjnej to informacja, podczas gdy rekomendacja dawki specyficzna dla pacjenta jest regulowanym wsparciem decyzji.

Usługa CDS to oprogramowanie, które odczytuje kontekst i zwraca informacje. To, czy jest wyrobem medycznym, zależy od treści kart: przypomnienie o istnieniu wyniku laboratoryjnego to informacja; zalecenie dawkowania dla konkretnego pacjenta to wsparcie decyzji, które podlega przepisom dotyczącym wyrobów medycznych w UE i USA. Zobacz Czy aplikacja medyczna jest wyrobem medycznym?. Standard jest neutralny; treść nie.

Zdefiniowane obecnie haki: patient-view, order-select, order-sign, order-dispatch, encounter-start, encounter-discharge, appointment-book, z publicznym katalogiem, w którym proponowane są nowe haki.

Związek z SMART on FHIR

CDS Hooks i SMART on FHIR uzupełniają się. SMART on FHIR uruchamia aplikację, która przejmuje część ekranu i z upoważnienia użytkownika wysyła zapytania do serwera FHIR; CDS Hooks działa w tle i zwraca karty do własnego interfejsu systemu EHR. Karta może zawierać link do uruchomienia SMART, gdy potrzebne jest coś więcej niż tylko karta.

SMART on FHIR uruchamia aplikację, która przejmuje część ekranu i komunikuje się z serwerem FHIR za zgodą użytkownika. CDS Hooks działa w tle i zwraca karty; karta może zawierać link do uruchomienia SMART, gdy potrzebne jest coś więcej niż tylko karta. Większość produktów wspierających decyzje wykorzystuje oba rozwiązania: haki do powiadomień, aplikację SMART do szczegółów.

Gdzie Anpheros pasuje

Anpheros nie oferuje usługi CDS Hooks ani nie generuje zaleceń klinicznych. Jego rejestr FHIR, za zgodą pacjenta, może być danymi, które odczytuje własna usługa wsparcia decyzji szpitala (leki, alergie, ostatnie wyniki), poprzez to samo API FHIR, z którego korzystałaby usługa haków. Zobacz Platforma zgody pacjenta.

Powiązane strony

Źródła

Najczęstsze pytania

Czy CDS Hooks jest częścią FHIR?

Jest to osobna specyfikacja HL7, która wykorzystuje FHIR do swoich danych: dane pobrane z wyprzedzeniem i kontekst zawierają zasoby FHIR, a autoryzacja ponownie wykorzystuje tokeny SMART on FHIR. Jest publikowana przez HL7 obok FHIR, a nie w ramach specyfikacji FHIR.

Jak szybko musi odpowiedzieć usługa CDS?

Specyfikacja nie określa liczby, ale systemy EHR stosują limity czasowe wynoszące kilka sekund i odrzucają spóźnione odpowiedzi, ponieważ klinicysta czeka. Prefetch istnieje właśnie po to, aby usługa nie spędzała tego czasu na zadawaniu pytań.

Czy usługa CDS może zmienić zlecenie?

Tylko poprzez zaproponowanie sugestii, którą klinicysta akceptuje, lub, w wersji 2.0, poprzez systemActions, które system EHR zgodził się zastosować automatycznie dla tej usługi. Usługa nigdy nie zapisuje danych na serwerze FHIR systemu EHR samodzielnie podczas wywołania haka.

Czy aplikacja pacjenta korzysta z CDS Hooks?

Nie. CDS Hooks jest przeznaczony do przepływów pracy w systemach EHR skierowanych do klinicystów. Aplikacje pacjenta korzystają bezpośrednio z API FHIR i SMART on FHIR do logowania.

Anpheros Platform

Wypróbuj za darmo w sandboksie

Pierwsze wywołanie FHIR w 5 minut. API HL7 FHIR R4 z wbudowaną zgodą pacjenta: wypróbuj w piaskownicy, a następnie połącz własną aplikację lub system kliniczny.

Utwórz darmowy sandbox Przeczytaj przewodniki dla programistów →

Za darmo · 30 syntetycznych pacjentów · bez karty

Ten poradnik ma charakter informacyjny i nie zastępuje konsultacji lekarskiej. Decyzje dotyczące zdrowia podejmuj z lekarzem. W nagłym wypadku zadzwoń pod lokalny numer alarmowy (112 w Europie).

Napisane przez

Zespół Anpheros

Anpheros tworzy dokumentację medyczną, nad którą pacjent ma kontrolę i którą może udostępniać dowolnej klinice, na platformie HL7 FHIR R4, z siedzibą w UE. Te przewodniki pomogą Ci zrozumieć i uporządkować informacje o Twoim zdrowiu; nie zastępują one wizyty u lekarza.

O Anpheros →