의료 FHIR R4 데이터 스키마 참조

Vertex AI Search는 FHIR R4 리소스의 하위 집합을 지원합니다. 이 페이지에는 지원되는 FHIR 리소스 및 요소가 나와 있습니다. 이 페이지에는 각 리소스에 대해 Google에서 정의한 스키마 구성의 표와 다음 세부정보가 표시됩니다.

  • 기본적으로 요소가 색인 생성 가능, 검색 가능, 검색 가능 여부를 나타내는 체크표시입니다. 이러한 필드 설정에 대한 자세한 내용은 필드 설정 구성을 참고하세요.
  • LLM 대답이 생성될 때 요소가 입력란으로 간주되는지 나타내는 체크표시입니다. 즉, LLM 답변의 입력 프롬프트를 생성하기 위해 이러한 필드가 문서에서 검색됩니다. 이 필드는 스키마 구성의 일부로 구성할 수 없습니다.

스키마 구성 수정

스키마 구성을 수정하려면 데이터 스토어를 만들 때 커스텀 스키마 옵션을 선택합니다. 데이터 스토어를 만들 때 또는 나중에 스키마 구성을 수정할 수 있습니다.

리소스 수준 사양

Vertex AI Search는 다음 리소스 및 리소스 참조를 지원합니다.

데이터 스토어 수준 사양

데이터 스토어 내의 다음 속성이 지원됩니다.

속성 색인 생성 가능 검색 가능 가져오기 가능
id
resource_type
resource_datetime
patient_id

필드 수준 사양

Vertex AI Search는 지원되는 각 FHIR 리소스 내에서 FHIR 데이터 요소의 하위 집합을 지원합니다. 다음 섹션에는 지원되는 모든 FHIR 리소스에 지원되는 요소와 이러한 조건에서 해당 요소가 색인 생성 가능, 검색 가능, 가져오기 가능인지 여부가 나와 있습니다.

  • 반복되는 요소에 빈 색인 또는 []가 있는 경우 이 요소의 모든 인스턴스가 지원됩니다. 예를 들어 AllergyIntolerance 리소스에서는 clinicalStatus.coding[].code의 모든 인스턴스가 지원됩니다.
  • 반복되는 요소에 특정 색인 또는 [0]가 있는 경우 첫 번째 인스턴스만 지원됩니다. 예를 들어 Composition 리소스에서는 author[0].display의 첫 번째 인스턴스만 지원됩니다.
  • 상대 리소스 참조는 Resource/resourceId 형식으로 지원됩니다. 예를 들어 subject.reference의 값은 Patient/034AB16이어야 합니다.
  • 절대 참조는 데이터 유형이 attachment로 설정된 Binary 리소스에만 지원됩니다. 절대 참조는 다음 패턴을 따르는 Cloud Storage 위치에만 지원됩니다. gs://BUCKET_NAME/FILE_PATH.
  • 내부 또는 논리적 참조는 지원되지 않으며 이러한 참조는 확인되지 않습니다.

AllergyIntolerance

AllergyIntolerance 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
asserter.display
asserter.reference Practitioner만 해당.
clinicalStatus.coding[].code
clinicalStatus.coding[].display
clinicalStatus.coding[].system
code.coding[].code
code.coding[].display
code.coding[].system
code.text
encounter.reference
id
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
patient.reference Patient만 해당.
reaction[].description
reaction[].manifestation[].text
reaction[].severity
recordedDate
recorder.display
recorder.reference Practitioner만 해당.
verificationStatus.coding[].code
verificationStatus.coding[].display
verificationStatus.coding[].system

예약

Appointment 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
appointmentType.coding[].code
appointmentType.coding[].display
appointmentType.coding[].system
comment
created
description
id
participant[].actor.reference
participant[].type[].coding[].code
participant[].type[].coding[].display
participant[].type[].coding[].system
participant[].type[].text
reasonCode[].coding[].code
reasonCode[].coding[].display
reasonCode[].coding[].system
reasonCode[].text
serviceCategory[].coding[].code
serviceCategory[].coding[].display
serviceCategory[].coding[].system
serviceCategory[].text
start
status

Basic

Basic 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
author.display
author.reference Practitioner만 해당.
code.coding[].code
code.coding[].display
code.coding[].system
code.text
created
id
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
subject.reference Patient만 해당.
text.div

CarePlan

CarePlan 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
activity[].detail.description
activity[].progress[].text
addresses[].display
addresses[].reference
author.display
author.reference
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
created
description
encounter.reference
goal[].display
goal[].reference
id
note[].text
period.end
period.start
status
subject.reference
text.div
title

Composition

Composition 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
author[0].display
author[0].reference Practitioner만 해당.
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
date
encounter.reference
id
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
section[].text.div 리소스를 색인 생성하려면 이 필드가 있어야 합니다.
status
subject.reference Patient만 해당.
title
type.coding[].code
type.coding[].display
type.coding[].system
type.text

Condition

Condition 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
asserter.display
asserter.reference Practitioner만 해당.
bodySite[].coding[].code
bodySite[].coding[].display
bodySite[].coding[].system
bodySite[].text
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
clinicalStatus.coding[].code
clinicalStatus.coding[].display
clinicalStatus.coding[].system
code.coding[].code
code.coding[].display
code.coding[].system
code.text
encounter.reference
id
identifier[].system
identifier[].value
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
onsetDateTime
onsetPeriod.end
onsetPeriod.start
recordedDate
recorder.display
recorder.reference Practitioner만 해당.
subject.reference Patient만 해당.
verificationStatus.coding[].code
verificationStatus.coding[].display
verificationStatus.coding[].system

DiagnosticReport

DiagnosticReport 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
conclusion 이는 presentedForm[0].data를 사용할 수 없는 경우에만 적용됩니다.
effectiveDateTime
id
imagingStudy[].imagingStudyId
issued
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
performer[0].display
performer[0].reference Practitioner만 해당.
presentedForm[0].data base64로 인코딩되어야 합니다. 경로를 포함할 수 있습니다.
subject.reference Patient만 해당.

DocumentReference

DocumentReference 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
authenticator.display
authenticator.reference
author[0].display
author[0].reference
content[0].attachment.contentType

지원되는 MIME 유형:

  • application/json
  • application/pdf
  • application/rtf
  • application/xhtml+xml
  • application/xml
  • image/bmp
  • image/gif
  • image/jpeg
  • image/png
  • image/tiff
  • text/html
  • text/plain
  • text/xml
content[0].attachment.creation
content[0].attachment.data base64로 인코딩되어야 합니다.
content[0].attachment.title
content[0].attachment.url
content[0].format.code
content[0].format.display
content[0].format.system
context.encounter[].reference
context.period.end
context.period.start
custodian.display
custodian.reference Practitioner만 해당.
date
description
docStatus
id
identifier[].system
identifier[].value
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
status
subject.reference Patient만 해당.
type.coding[].code
type.coding[].display
type.coding[].system
type.text

Encounter

Encounter 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
class.code
class.display
class.system
id
identifier[].system
identifier[].value
location[].location.display
location[].location.reference
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
participant[0].individual.display
participant[0].individual.reference Practitioner만 해당.
participant[].type[].coding[].code
participant[].type[].coding[].display
participant[].type[].coding[].system
participant[].type[].text
period.end
period.start
reasonCode[].coding[].code
reasonCode[].coding[].display
reasonCode[].coding[].system
reasonCode[].text
serviceType.coding[].code
serviceType.coding[].display
serviceType.coding[].system
serviceType.text
status
subject.reference Patient만 해당.
type[].coding[].code
type[].coding[].display
type[].coding[].system
type[].text

ImagingStudy

ImagingStudy 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
description
encounter.reference
endpoint[0].reference
id
identifier[].system
identifier[].value
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
modality[].code
modality[].display
modality[].system
note[].text
procedureCode[].coding[].code
procedureCode[].coding[].display
procedureCode[].coding[].system
procedureCode[].text
referrer.display
referrer.reference Practitioner만 해당.
started
status
subject.reference Patient만 해당.

Immunization

Immunization 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
encounter.reference
id
identifier[].system
identifier[].value
manufacturer.display
manufacturer.reference
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
occurrenceDateTime
occurrenceString
patient.reference Patient만 해당.
primarySource
recorded
status
statusReason.coding[].code
statusReason.coding[].display
statusReason.coding[].system
statusReason.text
vaccineCode.coding[].code
vaccineCode.coding[].display
vaccineCode.coding[].system
vaccineCode.text

MedicationAdministration

MedicationAdministration 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
category.coding[].code
category.coding[].display
category.coding[].system
category.text
context.reference
dosage.dose.unit
dosage.dose.value
dosage.method.coding[].code
dosage.method.coding[].display
dosage.method.coding[].system
dosage.method.text
dosage.rateQuantity.unit
dosage.rateQuantity.value
dosage.route.coding[].code
dosage.route.coding[].display
dosage.route.coding[].system
dosage.route.text
dosage.site.coding[].code
dosage.site.coding[].display
dosage.site.coding[].system
dosage.site.text
dosage.text
effectiveDateTime
effectivePeriod.end
effectivePeriod.start
id
identifier[].system
identifier[].value
medicationCodeableConcept.coding[].code
medicationCodeableConcept.coding[].display
medicationCodeableConcept.coding[].system
medicationCodeableConcept.text
medicationReference.display
medicationReference.reference Medication만 해당.
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
performer[0].actor.display
performer[0].actor.reference Practitioner만 해당.
request.reference
status
subject.reference Patient만 해당.

MedicationDispense

MedicationDispense 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
category.coding[].code
category.coding[].display
category.coding[].system
category.text
context.reference
daysSupply.code
daysSupply.system
daysSupply.unit
daysSupply.value
dosageInstruction[].doseAndRate[].doseQuantity.unit
dosageInstruction[].doseAndRate[].doseQuantity.value
dosageInstruction[].doseAndRate[].rateQuantity.unit
dosageInstruction[].doseAndRate[].rateQuantity.value
dosageInstruction[].method.coding[].code
dosageInstruction[].method.coding[].display
dosageInstruction[].method.coding[].system
dosageInstruction[].method.text
dosageInstruction[].route.coding[].code
dosageInstruction[].route.coding[].display
dosageInstruction[].route.coding[].system
dosageInstruction[].route.text
dosageInstruction[].site.coding[].code
dosageInstruction[].site.coding[].display
dosageInstruction[].site.coding[].system
dosageInstruction[].site.text
dosageInstruction[].text
id
identifier[].system
identifier[].value
medicationCodeableConcept.coding[].code
medicationCodeableConcept.coding[].display
medicationCodeableConcept.coding[].system
medicationCodeableConcept.text
medicationReference.display
medicationReference.reference Medication만 해당.
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
quantity.code
quantity.system
quantity.unit
quantity.value
status
statusReasonCodeableConcept.coding[].code
statusReasonCodeableConcept.coding[].display
statusReasonCodeableConcept.coding[].system
statusReasonCodeableConcept.text
subject.reference Patient만 해당.
whenHandedOver

MedicationRequest

MedicationRequest 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
authoredOn
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
dosageInstruction[].doseAndRate[].doseQuantity.unit
dosageInstruction[].doseAndRate[].doseQuantity.value
dosageInstruction[].patientInstruction
dosageInstruction[].route.text
dosageInstruction[].text
dosageInstruction[].timing.code.text
id
medicationCodeableConcept.coding[].code
medicationCodeableConcept.coding[].display
medicationCodeableConcept.coding[].system
medicationCodeableConcept.text
medicationReference.display
medicationReference.reference Medication만 해당.
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
reportedBoolean
reportedReference.display
reportedReference.reference
requester.display
requester.reference Practitioner만 해당.
status
subject.reference Patient만 해당.

MedicationStatement

MedicationStatement 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
category.coding[].code
category.coding[].display
category.coding[].system
category.text
context.reference
dateAsserted
dosage[].doseAndRate[].doseQuantity.unit
dosage[].doseAndRate[].doseQuantity.value
dosage[].patientInstruction
dosage[].route.coding[].code
dosage[].route.coding[].display
dosage[].route.coding[].system
dosage[].route.text
dosage[].text
dosage[].timing.code.text
effectiveDateTime
effectivePeriod.end
effectivePeriod.start
id
medicationCodeableConcept.coding[].code
medicationCodeableConcept.coding[].display
medicationCodeableConcept.coding[].system
medicationCodeableConcept.text
medicationReference.display
medicationReference.reference
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
status
subject.reference

Observation

Observation 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
category[].coding[].code
category[].coding[].display
category[].coding[].system
code.coding[].code
code.coding[].display
code.coding[].system
code.text
component[].code.coding[].code
component[].code.coding[].display
component[].code.coding[].system
component[].code.text
component[].valueQuantity.unit
component[].valueQuantity.value
effectiveDateTime
encounter.reference
id
issued
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
performer[].display
performer[].reference Practitioner만 해당.
status
subject.reference Patient만 해당.
valueQuantity.unit
valueQuantity.value
valueString

Patient

Patient 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
active
birthDate
gender
id
identifier[].system
identifier[].type.coding[].code
identifier[].type.coding[].display
identifier[].type.coding[].system
identifier[].type.text
identifier[].value
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
name[].family
name[].given[]
name[].text

Procedure

Procedure 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
basedOn[].display
basedOn[].reference
bodySite[].coding[].code
bodySite[].coding[].display
bodySite[].coding[].system
bodySite[].text
category.coding[].code
category.coding[].display
category.coding[].system
category.text
code.coding[].code
code.coding[].display
code.coding[].system
code.text
encounter.reference
id
identifier[].system
identifier[].value
location.display
location.reference
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
performedDateTime
performer[0].actor.display
performer[0].actor.reference Practitioner만 해당.
recorder.display
recorder.reference
status
statusReason.coding[].code
statusReason.coding[].display
statusReason.coding[].system
statusReason.text
subject.reference Patient만 해당.

ServiceRequest

ServiceRequest 리소스 내의 다음 요소가 지원됩니다.

요소 색인 생성 가능 검색 가능 가져오기 가능 LLM 입력 참조 지원 제약조건
authoredOn
category[].coding[].code
category[].coding[].display
category[].coding[].system
category[].text
code.coding[].code
code.coding[].display
code.coding[].system
code.text
id
intent
meta.source
meta.tag[].code
meta.tag[].display
meta.tag[].system
note[].text
priority
requester.display
requester.reference Practitioner만 해당.
status
subject.reference Patient만 해당.

참조

Vertex AI Search는 검색을 포괄적으로 만들기 위해 특정 참조를 확인합니다. 예를 들어 의료인 이름을 검색하고 해당 의료인을 언급하는 리소스를 찾을 수 있습니다. 참조 컨텍스트에서 지원되는 리소스는 다음과 같습니다. 또한 참조가 포함된 리소스를 검색할 때는 리소스 내에 지정된 요소만 사용됩니다.

리소스 요소 가져오기 가능 색인 생성 가능 검색 가능 제약조건
바이너리 id
바이너리 contentType
  • application/json
  • application/pdf
  • application/rtf
  • application/xhtml+xml
  • application/xml
  • image/bmp
  • image/gif
  • image/jpeg
  • image/png
  • image/tiff
  • text/html
  • text/plain
  • text/xml
바이너리 data
위치 id
위치 name
의약품 id
의약품 text
의약품 code.coding[].code
의약품 code.coding[].system
의약품 code.coding[].display
실무자 id
실무자 name[0].family 이름의 첫 번째 인스턴스만 해당.
실무자 name[0].given[] 이름의 첫 번째 인스턴스만 해당.
실무자 name[0].text 이름의 첫 번째 인스턴스만 해당.