Zum Hauptinhalt springen

Device Data Source

Category: Healthcare Standards
Node id: device-data-source

Standards: GDPR, HIPAA-eligible

Fetch and merge patient device metrics (wearables vitals and/or IoT summaries) for a time window, ready for downstream agent analysis.

What it does​

  • Parallel fetch of multiple metrics across wearables + IoT sources
  • Per-source/per-metric warnings instead of hard failure
  • Service-to-service JWT auth to the wearables service when org_id + secret are set

Use cases​

  • Assemble a patient's recent vitals before an agent triage step
  • Combine wearable heart-rate trends with IoT device summaries

Runtime​

  • Performance tier: variable

Input ports​

NameTypeRequiredDescription
patient_idtextNoPatient ID (overrides config when the config value is empty or an unresolved {{token}})
inputjsonNoWhole request object from an upstream input node (its output port to this input port). The executor merges it key by key, so phone, patient_id, patient_name and language arrive under their own names; the fields that are not set stay untouched. Lets a pipeline run from the input node's defaults when Studio triggers it without inputs.
window_fromtextNoWindow start (ISO-8601); used when config window.from is empty/unresolved
window_totextNoWindow end (ISO-8601); used when config window.to is empty/unresolved
org_idtextNoOrganization ID; signs the wearables service JWT when a secret is configured

Output ports​

NameTypeRequiredDescription
datajsonNoMerged result: {patient_id, window, sources, metrics{<metric>:{summary,raw_url,iot_summary}}, warnings, alerts, devices}

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Patient IDpatient_idstringYesPatient identifier. Supports {{token}} substitution from pipeline inputs (falls back to the patient_id input port).
Time WindowwindowjsonYes{"from": "", "to": ""}Object with ISO-8601 'from' and 'to' timestamps. Empty/unresolved values fall back to the window_from / window_to input ports.
MetricsmetricsarrayNo["heart_rate"]Metrics to fetch (e.g. heart_rate, steps, sleep). Defaults to ["heart_rate"].
SourcessourcesarrayNo["wearables"]Data sources to query: "wearables" and/or "iot". Defaults to ["wearables"].

Runtime notes​

  • Output is wrapped under a single 'data' port — wire it to an agent's 'data' input.
  • A requested source with no configured backend URL produces a warning, not an error.
  • patient_id and window may be supplied by config or by the input ports; config takes precedence unless empty or an unresolved {{token}}.

See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..