# Virtuálna starostlivosť a AI lekári: dáta, ktoré potrebujú

> Virtuálna návšteva ako dáta FHIR R4 — rezervácia, vstup, domáce merania, návšteva, následná starostlivosť — a ako AI asistent získa súhlasom označený pohľad na zdrojové dáta. Otestovaný proces.

Source: https://developers.anpheros.com/sk/guides/virtual-care-ai-data

**Virtuálna klinika — či už je lekár osoba na videu alebo AI asistent, ktorý jej pomáha — je len tak dobrá, ako kvalitné sú dáta pacienta, ktoré vidí pred, počas a po návšteve: nedávne merania, aktívne problémy a lieky, čo pacient nahlásil, a záznam o tom, čo bolo rozhodnuté.** Videohovor je tá ľahšia časť. Táto stránka mapuje virtuálnu návštevu na zdroje HL7 FHIR R4, ukazuje, ako môže AI asistent získať súhlasom označený pohľad na zdrojové dáta, a spúšťa celý proces na Anpheros Platform, vrátane jedného obmedzenia, ktoré sme pri tom našli.

## Virtuálna návšteva ako dáta

| Fáza | Čo sa deje | FHIR R4 zdroje |
|---|---|---|
| Rezervácia | Pacient si vyberie čas na video návštevu | `Appointment` |
| Vstup | Pacient odpovedá na otázky a hlási symptómy | `QuestionnaireResponse`, `Observation` (kategória `symptom`) |
| Domáce dáta | Merania z tlakomeru, váhy alebo hodiniek od poslednej návštevy | `Observation` (vitálne funkcie, aktivita), označené ako dáta zo zariadenia |
| Príprava | Klinický lekár alebo AI asistent za neho si prezerá záznam | read: `Condition`, `MedicationStatement`, `AllergyIntolerance`, `Observation`, `DocumentReference` |
| Návšteva | Kto, kedy, prečo a že bola virtuálna | `Encounter` s `class` = `VR` (virtuálna) |
| Výsledok | Diagnóza, zmeny liekov, objednané testy, následná starostlivosť | `Condition`, `MedicationStatement`, `ServiceRequest`, `CarePlan`, `Appointment` |
| Sledovanie | Kto zapísal každú položku, z akého systému | `Provenance` pri každom zápise |

Dve veci odlišujú túto návštevu od osobnej návštevy. Klinický lekár sa viac spolieha na dáta, ktoré vygeneroval pacient (domáce merania, dotazníky), takže záznam musí ukazovať, ktoré hodnoty pochádzajú zo zariadenia alebo od pacienta a ktoré od klinického lekára. A krok prípravy je miestom, kde je AI dnes najužitočnejšia – sumarizuje mesačné merania do toho, čo sa zmenilo – takže záznam musí byť čitateľný softvérom s povolením pacienta.

## Kde AI zapadá a čo by mala vidieť

| Rola AI | Potrebné dáta | Dáta, ktoré by nemala dostať |
|---|---|---|
| Pomocník pri príjme (rozpráva sa s pacientom pred návštevou) | Aktuálne problémy a lieky, aby mohla položiť relevantné otázky | Poznámky a dokumenty, ktoré nepotrebuje |
| Prednávštevkový súhrn pre lekára | Trendy nedávnych meraní, nové symptómy, zmeny liekov, nedávne výsledky | Surové roky histórie nad rámec otázky |
| Návrh dokumentácie po návšteve | Stretnutie, čo sa prediskutovalo, výsledok | Dáta iných pacientov, kedykoľvek |
| Následné kontroly | Plán starostlivosti a merania, o ktoré žiada | Čokoľvek mimo plánu |

Spoločné pravidlá: každej roli AI dajte **najmenší výsek**, ktorý zodpovie jej otázku, **označte zdroj** každej hodnoty, aby model a lekár mohli zvážiť domáce meranie oproti laboratórnemu výsledku, **zaznamenajte každé čítanie**, aby pacient videl, čo AI videla, a majte **človeka v cykle** pre čokoľvek diagnostické. AI, ktorá diagnostikuje alebo odporúča liečbu, môže byť regulovaná ako softvér zdravotníckej pomôcky (FDA v Spojených štátoch; podľa nariadenia o zdravotníckych pomôckach a zákona o AI v Európskej únii); dátová platforma to nemení.

## Tok na Anpherose, krok za krokom

Nižšie uvedený kód používa Anpheros TypeScript SDK a bol spustený proti lokálnej inštancii platformy s kľúčom sandboxu. Pacient už má tri domáce merania krvného tlaku z manžety (`author_type: device`), hypertenziu ako diagnózu a enalapril ako liek.

```ts
import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
const subject = { reference: `Patient/${patientId}` };

// 1. Before the visit: the booking and the intake questionnaire
await anpheros.fhir.create({ resourceType: 'Appointment', status: 'booked', description: 'Video visit: blood pressure follow-up',
  start: '2026-10-14T15:00:00-05:00', end: '2026-10-14T15:20:00-05:00',
  participant: [{ actor: subject, status: 'accepted' }] } as any);
await anpheros.fhir.create({ resourceType: 'QuestionnaireResponse', status: 'completed', subject, authored: '2026-10-14T09:12:00-05:00',
  item: [
    { linkId: 'reason', text: 'What would you like to discuss?', answer: [{ valueString: 'Higher readings this week and dizziness in the morning' }] },
    { linkId: 'missed-doses', text: 'Did you miss any doses in the last 7 days?', answer: [{ valueBoolean: false }] },
  ] } as any, { author_type: 'patient' });

// The symptom itself, as a patient-reported Observation, so it reaches the context below
await anpheros.observations.create(patientId, { code: 'R42', system: 'http://hl7.org/fhir/sid/icd-10', display: 'Dizziness and giddiness',
  category: 'symptom', effective_at: '2026-10-13T07:45:00-05:00', value_text: 'Dizzy for a few minutes after getting up', author_type: 'patient' });

// 2. What the clinician (or an AI assistant helping them) reads: a budgeted, source-labelled context
const ctx = await anpheros.context.build({ patient: patientId, task: 'prepare a video visit',
  question: 'blood pressure trend and dizziness in the last 2 weeks', budget_tokens: 700, format: 'text' });

// 3. After the visit: the encounter, written as the clinician
const encounter = await anpheros.fhir.create({ resourceType: 'Encounter', status: 'finished',
  class: { system: 'http://terminology.hl7.org/CodeSystem/v3-ActCode', code: 'VR', display: 'virtual' },
  subject, period: { start: '2026-10-14T15:02:00-05:00', end: '2026-10-14T15:18:00-05:00' },
  reasonCode: [{ text: 'Blood pressure follow-up' }] } as any, { author_type: 'practitioner', source_system: 'video-clinic' });
```

Kontext vrátený v kroku 2 (487 zo 700 tokenov; toto je to, čo by ste dali pred model alebo zobrazili lekárovi):

```
## Summary
Maria Lopez, 58 y, female. Active conditions: Essential (primary) hypertension. Active medications: Enalapril 10 mg.
Allergies: none recorded. Record: 0 lab values, 3 vital signs, 0 documents. As of 2026-10-13.
## Vitals
- Blood pressure panel: latest 2026-10-12 146/90 mm[Hg] ; weekly 2026-10-05: 150/93.5; 2026-10-12: 146/90 [device]
## Symptoms
- Dizziness and giddiness: 1 occurrence(s): 2026-10-13 [patient]
## Timeline
- 2026-10-13 symptom: Dizziness and giddiness: Dizzy for a few minutes after getting up [patient]
```

Každý riadok nesie svoj zdroj — `[device]` pre manžetu, `[patient]` pre symptóm — a meranie je zaznamenané v logu prístupu. Pôvod stretnutia ukazuje `practitioner` z `video-clinic` a časová os pacienta teraz znie: virtuálne stretnutie, video-návšteva, závraty, tri merania krvného tlaku, liek a diagnóza.

**Čo sme zistili pri spustení:** kontextové API dnes neobsahuje odpovede `QuestionnaireResponse`. Prvé spustenie, kde boli závraty iba v dotazníku, vygenerovalo zhrnutie bez ich spomenutia. Zaznamenajte symptómy, ktoré pacient hlási, ako `Observation` s kategóriou `symptom` (ako je uvedené vyššie), alebo si sami prejdite dotazník do vášho modelu.

## Udelenie prístupu AI agentovi so súhlasom

Keď AI beží v aplikácii niekoho iného, nezíska váš projektový kľúč. Aplikácia požiada pacienta o súhlas prostredníctvom OAuth 2.1 a SMART on FHIR, s rozsahy (scopes) úzkymi ako `patient/Observation.rs?category=vital-signs`, na pevne stanovené obdobie, ktoré je možné kedykoľvek odvolať. Agent sa môže k záznamu dostať aj cez Anpheros MCP server, iba na čítanie, pokiaľ pacient nepovolí viac. Pozri [Ako udeliť AI agentovi prístup k lekárskym záznamom](https://developers.anpheros.com/sk/guides/ai-agent-access-medical-records) a [FHIR MCP server](https://developers.anpheros.com/sk/guides/mcp).

## Čo Anpheros robí a nerobí

Anpheros poskytuje záznam a jeho ovládacie prvky: FHIR R4 úložisko pre každý zdroj v tabuľke vyššie, súhlas na aplikáciu, pôvod pri každom zápise, prístupový denník, ktorý si pacient môže pozrieť, a kontextové API, ktoré premieňa záznam na rozpočtovaný, označený súhrn pre model.

Neposkytuje videohovory, obrazovky plánovania, elektronické predpisovanie, fakturáciu ani podporu klinického rozhodovania a nehostuje ani nevyberá AI modely. Virtuálna klinika postavená na ňom prináša tieto funkcie a samotnú klinickú zodpovednosť.

## Často kladené otázky

### Čo je virtuálny lekár?
Klinik, ktorý vidí pacientov na diaľku, prostredníctvom videa, telefónu alebo správ. Tento termín sa používa aj pre AI asistentov, ktorí hovoria s pacientmi; v praxi títo asistenti pomáhajú ľudskému lekárovi, namiesto toho, aby ho nahradili, a spoliehajú sa na rovnaké údaje o pacientoch.

### Ktorý FHIR zdroj označuje návštevu ako virtuálnu?
`Encounter.class` s kódom v3 ActCode `VR` ("virtual"). Rezervácia je `Appointment`; vstup je `QuestionnaireResponse` a pre symptómy `Observation`.

### Aké údaje potrebuje AI lekársky asistent?
Len to, čo vyžaduje jeho úloha: pre súhrn pred návštevou, nedávne trendy meraní, nové symptómy, aktívne problémy a lieky, a nedávne výsledky — každý označený svojím zdrojom a časom. Poskytnite mu rozpočtovaný kontext namiesto celého záznamu.

### Ako oddelím údaje hlásené pacientom a údaje zo zariadení od klinických údajov?
Zaznamenajte, kto každú položku napísal. V Anpheros každý zápis nesie typ autora — pacient, zariadenie, praktikant, import alebo AI — a kontext poskytnutý modelu označuje každý riadok s ním.

### Môže AI asistent čítať záznam pacienta bez jeho súhlasu?
V Anpheros nie. Aplikácia iná ako tá, ktorá vytvorila záznam, potrebuje súhlas pacienta prostredníctvom OAuth, obmedzený na rozsahy a obdobie, ktoré si zvolil, a každé čítanie sa zobrazí v jeho prístupovom denníku.

## Súvisiace

- [AI aplikácie v zdravotníctve](https://developers.anpheros.com/sk/guides/ai-healthcare)
- [Ako vytvoriť AI aplikáciu v zdravotníctve s FHIR backendom](https://developers.anpheros.com/sk/guides/build-ai-healthcare-app)
- [Ako vytvoriť lekársky chatbot so štruktúrovanými údajmi](https://developers.anpheros.com/sk/guides/ai-medical-assistant)
- [Údaje z nositeľných zariadení vo formáte FHIR](https://developers.anpheros.com/sk/guides/wearable-data-fhir): domáce údaje, na ktorých závisí virtuálna návšteva
- [Ako vytvoriť aplikáciu na osobný zdravotný záznam](https://developers.anpheros.com/sk/guides/personal-health-record-app)
- [Pôvod lekárskych údajov vysvetlený](https://developers.anpheros.com/sk/guides/medical-data-provenance)
- [Diaľkové monitorovanie pacientov s FHIR](https://developers.anpheros.com/sk/guides/remote-patient-monitoring-fhir)
- [Údaje o liekoch pre zdravotnícke aplikácie a AI agentov](https://developers.anpheros.com/sk/guides/medication-data-ai-agents)