Healthcare Natural Language API 사용

이 페이지에서는 Healthcare Natural Language API를 사용 설정하고, 권한을 구성하고, analyzeEntities 메서드를 호출하여 의료 텍스트의 유용한 의료 정보를 추출하는 방법을 설명합니다.

개요

Healthcare Natural Language API는 의료 텍스트에서 유용한 정보를 도출하는 머신러닝 솔루션을 제공합니다. Healthcare Natural Language API는 Cloud Healthcare API의 일부입니다. Healthcare Natural Language API의 개요는 Healthcare Natural Language API 개념 문서를 참조하세요.

Healthcare Natural Language API는 의료 레코드 또는 보험금 청구와 같은 구조화되지 않은 의료 텍스트를 파싱합니다. 그런 다음 다운스트림 분석 및 자동화를 위해 이러한 데이터 소스에 저장된 의학 지식 항목의 구조화된 데이터 표현을 생성합니다. 관련 예시는 아래와 같습니다.

질병, 약물, 의료기기, 시술, 임상 관련 속성 등의 의학 개념에 대한 정보 추출
RxNorm, ICD-10, MeSH, SNOMED CT(미국 사용자만 해당)와 같은 일반적인 의학 용어에 의료 개념 매핑
텍스트에서 유용한 의학 정보를 추출하여 Google Cloud의 데이터 분석 제품과 통합

사용 가능한 위치

Healthcare Natural Language API는 다음 위치에서 사용할 수 있습니다.

위치 이름	위치 설명
`asia-south1`	인도 뭄바이
`australia-southeast1`	오스트레일리아 시드니
`europe-west2`	영국 런던
`europe-west4`	네덜란드
`northamerica-northeast1`	캐나다 몬트리올
`us-central1`	미국 아이오와주

Healthcare Natural Language API 사용 설정

Healthcare Natural Language API를 사용하기 전에 Google Cloud 프로젝트에 API를 사용 설정해야 합니다. Cloud Healthcare API 기능을 사용 설정하거나 사용하지 않고도 Healthcare Natural Language API를 사용할 수 있습니다.

API를 사용 설정하려면 다음 단계를 완료하세요.

Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

프로젝트 선택기로 이동

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

서비스 계정을 만듭니다.

Google Cloud Console에서 서비스 계정 만들기 페이지로 이동합니다.
서비스 계정 만들기로 이동
프로젝트를 선택합니다.
서비스 계정 이름 필드에 이름을 입력합니다. Google Cloud 콘솔은 이 이름을 기반으로 서비스 계정 ID 필드를 채웁니다.

서비스 계정 설명 필드에 설명을 입력합니다. 예를 들면 Service account for quickstart입니다.
만들고 계속하기를 클릭합니다.
서비스 계정에 Project > Owner 역할을 부여합니다.

역할을 부여하려면 역할 선택 목록을 찾은 후 Project > Owner을 선택합니다.

참고: 역할 필드는 서비스 계정이 프로젝트에서 액세스할 수 있는 리소스에 영향을 줍니다. 이러한 역할을 취소하거나 나중에 추가 역할을 부여할 수 있습니다. 프로덕션 환경에서는 소유자, 편집자 또는 뷰어 역할을 부여하지 마세요. 대신 요구사항을 충족하는 사전 정의된 역할 또는 커스텀 역할을 부여합니다.
계속을 클릭합니다.
완료를 클릭하여 서비스 계정 만들기를 마칩니다.

브라우저 창을 닫지 마세요. 다음 단계에서 사용합니다.

서비스 계정 키 만들기

Google Cloud Console에서 만든 서비스 계정의 이메일 주소를 클릭합니다.
키를 클릭합니다.
키 추가를 클릭한 후 새 키 만들기를 클릭합니다.
만들기를 클릭합니다. JSON 키 파일이 컴퓨터에 다운로드됩니다.
닫기를 클릭합니다.

GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 사용자 인증 정보가 포함된 JSON 파일의 경로로 설정합니다. 이 변수는 현재 셸 세션에만 적용되므로 새 세션을 열면 변수를 다시 설정합니다.

예: Linux 또는 macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

KEY_PATH를 사용자 인증 정보가 포함된 JSON 파일의 경로로 바꿉니다.

예를 들면 다음과 같습니다.

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

예: Windows

PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

KEY_PATH를 사용자 인증 정보가 포함된 JSON 파일의 경로로 바꿉니다.

예를 들면 다음과 같습니다.

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

명령 프롬프트:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

KEY_PATH를 사용자 인증 정보가 포함된 JSON 파일의 경로로 바꿉니다.

Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

프로젝트 선택기로 이동

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

서비스 계정을 만듭니다.

Google Cloud Console에서 서비스 계정 만들기 페이지로 이동합니다.
서비스 계정 만들기로 이동
프로젝트를 선택합니다.
서비스 계정 이름 필드에 이름을 입력합니다. Google Cloud 콘솔은 이 이름을 기반으로 서비스 계정 ID 필드를 채웁니다.

서비스 계정 설명 필드에 설명을 입력합니다. 예를 들면 Service account for quickstart입니다.
만들고 계속하기를 클릭합니다.
서비스 계정에 Project > Owner 역할을 부여합니다.

역할을 부여하려면 역할 선택 목록을 찾은 후 Project > Owner을 선택합니다.

참고: 역할 필드는 서비스 계정이 프로젝트에서 액세스할 수 있는 리소스에 영향을 줍니다. 이러한 역할을 취소하거나 나중에 추가 역할을 부여할 수 있습니다. 프로덕션 환경에서는 소유자, 편집자 또는 뷰어 역할을 부여하지 마세요. 대신 요구사항을 충족하는 사전 정의된 역할 또는 커스텀 역할을 부여합니다.
계속을 클릭합니다.
완료를 클릭하여 서비스 계정 만들기를 마칩니다.

브라우저 창을 닫지 마세요. 다음 단계에서 사용합니다.

서비스 계정 키 만들기

Google Cloud Console에서 만든 서비스 계정의 이메일 주소를 클릭합니다.
키를 클릭합니다.
키 추가를 클릭한 후 새 키 만들기를 클릭합니다.
만들기를 클릭합니다. JSON 키 파일이 컴퓨터에 다운로드됩니다.
닫기를 클릭합니다.

예: Linux 또는 macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

KEY_PATH를 사용자 인증 정보가 포함된 JSON 파일의 경로로 바꿉니다.

예를 들면 다음과 같습니다.

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

예: Windows

PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

KEY_PATH를 사용자 인증 정보가 포함된 JSON 파일의 경로로 바꿉니다.

예를 들면 다음과 같습니다.

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

명령 프롬프트:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

KEY_PATH를 사용자 인증 정보가 포함된 JSON 파일의 경로로 바꿉니다.

Cloud Healthcare API 사용 설정
API 사용 설정

Google Cloud CLI를 설치합니다.
gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.
```
gcloud init
```

권한 설정

이 가이드의 기능을 사용하려면 healthcare.nlpServiceViewer 역할에 포함된 healthcare.nlpservice.analyzeEntities 권한이 있어야 합니다.

이 역할을 할당하려면 gcloud projects add-iam-policy-binding 명령어를 실행합니다.

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member serviceAccount:SERVICE_ACCOUNT_ID \
    --role roles/healthcare.nlpServiceViewer

항목, 관계, 컨텍스트 속성 추출

Healthcare Natural Language API는 컨텍스트 인식 모델을 사용하여 의료 항목, 관계, 컨텍스트 속성을 추출합니다. 각 텍스트 항목은 의학 사전 항목으로 추출됩니다. 의학 텍스트에 이와 같은 수준의 유용한 의학 정보를 추출하려면 projects.locations.services.nlp.analyzeEntities 메서드를 사용합니다.

항목 멘션에 SNOMED CT 라이선스 어휘를 포함하려면 라이선스 어휘 포함을 참조하세요.

Healthcare Natural Language API를 사용하여 의료 텍스트에서 유용한 의학 정보를 추출하려면 POST 요청을 실행하고 documentContent 필드에 대상 텍스트를 지정합니다. 의학 텍스트 최대 크기는 유니코드 문자 20,000자입니다.

다음 샘플은 analyzeEntities 메서드를 사용하여 "당뇨에 인슐린 양성 5단위 IV 관리" 의료 텍스트에서 의료 정보를 추출하는 방법을 보여줍니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트의 ID
LOCATION: 데이터 세트 위치

JSON 요청 본문:

{
  "documentContent": "Insulin regimen 5 units IV will be administered for diabetes."
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

cat > request.json << 'EOF'
{
  "documentContent": "Insulin regimen 5 units IV will be administered for diabetes."
}
EOF

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d @request.json \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/services/nlp:analyzeEntities"

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

@'
{
  "documentContent": "Insulin regimen 5 units IV will be administered for diabetes."
}
'@  | Out-File -FilePath request.json -Encoding utf8

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json" `
    -InFile request.json `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/services/nlp:analyzeEntities" | Select-Object -Expand Content

요청이 성공하면 응답에 다음 정보가 포함됩니다.

인식된 의학 지식 항목
기능적 특징
인식된 항목 간의 관계
문맥 속성
의학 지식 항목을 표준 용어로 매핑

지원되는 항목, 속성, 관계 유형 목록은 Healthcare Natural Language API 기능을 참조하세요.

다음 응답은 NCI 용어 시스템에 코드 C581이 있는 항목인 치료용 인슐린을 약물로 식별합니다. 응답에는 응답에 할당된 신뢰도 점수도 포함됩니다. 응답 필드에 대한 자세한 내용은 analyzeEntities 문서를 참조하세요.

응답

{
  "entityMentions": [
    {
      "mentionId": "1",
      "type": "MEDICINE",
      "text": {
        "content": "Insulin regimen",
        "beginOffset": 0
      },
      "linkedEntities": [
        {
          "entityId": "UMLS/C0021641"
        },
        {
          "entityId": "UMLS/C0795635"
        },
        {
          "entityId": "UMLS/C1533581"
        },
        {
          "entityId": "UMLS/C3537244"
        },
        {
          "entityId": "UMLS/C3714501"
        }
      ],
      "temporalAssessment": {
        "value": "UPCOMING",
        "confidence": 0.95375925302505493
      },
      "certaintyAssessment": {
        "value": "LIKELY",
        "confidence": 0.618984580039978
      },
      "subject": {
        "value": "PATIENT",
        "confidence": 0.99964696168899536
      },
      "confidence": 0.62128835916519165
    },
    {
      "mentionId": "2",
      "type": "MED_DOSE",
      "text": {
        "content": "5 units",
        "beginOffset": 16
      },
      "confidence": 0.78806477785110474
    },
    {
      "mentionId": "3",
      "type": "MED_ROUTE",
      "text": {
        "content": "IV",
        "beginOffset": 24
      },
      "linkedEntities": [
        {
          "entityId": "UMLS/C0348016"
        }
      ],
      "confidence": 0.8927428126335144
    },
    {
      "mentionId": "4",
      "type": "PROBLEM",
      "text": {
        "content": "diabetes",
        "beginOffset": 52
      },
      "linkedEntities": [
        {
          "entityId": "UMLS/C0011847"
        },
        {
          "entityId": "UMLS/C0011849"
        },
        {
          "entityId": "UMLS/C0241863"
        }
      ],
      "temporalAssessment": {
        "value": "CURRENT",
        "confidence": 0.91680806875228882
      },
      "certaintyAssessment": {
        "value": "LIKELY",
        "confidence": 0.98018729686737061
      },
      "subject": {
        "value": "PATIENT",
        "confidence": 0.99965417385101318
      },
      "confidence": 0.99518013000488281
    }
  ],
  "entities": [
    {
      "entityId": "UMLS/C0011847",
      "preferredTerm": "Diabetes",
      "vocabularyCodes": [
        "ICD10CM/E11",
        "LNC/LA10529-8",
        "LNC/LP128793-9",
        "LNC/MTHU040702",
        "MTH/NOCODE",
        "OMIM/MTHU050182"
      ]
    },
    {
      "entityId": "UMLS/C0011849",
      "preferredTerm": "Diabetes Mellitus",
      "vocabularyCodes": [
        "HPO/HP:0000819",
        "ICD10CM/E08-E13",
        "ICD9CM/250",
        "LNC/LA14291-1",
        "LNC/LA27539-8",
        "LNC/LP74722-7",
        "LNC/MTHU020781",
        "MEDLINEPLUS/4",
        "MSH/D003920",
        "MTH/NOCODE",
        "MTH/U000263",
        "NCI/C2985",
        "OMIM/MTHU036798"
      ]
    },
    {
      "entityId": "UMLS/C0021641",
      "preferredTerm": "Insulin",
      "vocabularyCodes": [
        "FMA/83365",
        "LNC/LA15805-7",
        "LNC/LP14676-8",
        "LNC/LP16325-0",
        "LNC/LP32542-0",
        "LNC/LP70329-5",
        "LNC/MTHU002108",
        "LNC/MTHU019392",
        "MSH/D007328",
        "MTH/NOCODE"
      ]
    },
    {
      "entityId": "UMLS/C0241863",
      "preferredTerm": "Diabetic",
      "vocabularyCodes": [
        "LNC/LA26134-9"
      ]
    },
    {
      "entityId": "UMLS/C0348016",
      "preferredTerm": "Intravenous",
      "vocabularyCodes": [
        "LNC/LA9437-0",
        "LNC/LP32453-0",
        "MTH/NOCODE",
        "NCI/C13346"
      ]
    },
    {
      "entityId": "UMLS/C0795635",
      "preferredTerm": "insulin, regular, human",
      "vocabularyCodes": [
        "LNC/LP17001-6",
        "MSH/D061386",
        "MTH/NOCODE",
        "NCI/C29125",
        "RXNORM/253182",
        "VANDF/4017559",
        "VANDF/4017569",
        "VANDF/4019786"
      ]
    },
    {
      "entityId": "UMLS/C1533581",
      "preferredTerm": "Therapeutic Insulin",
      "vocabularyCodes": [
        "MTH/NOCODE",
        "NCI/C581"
      ]
    },
    {
      "entityId": "UMLS/C3537244",
      "preferredTerm": "Insulins",
      "vocabularyCodes": [
        "MSH/D061385",
        "MTH/NOCODE"
      ]
    },
    {
      "entityId": "UMLS/C3714501",
      "preferredTerm": "Insulin Drug Class",
      "vocabularyCodes": [
        "MTH/NOCODE",
        "VANDF/4021631"
      ]
    }
  ],
  "relationships": [
    {
      "subjectId": "1",
      "objectId": "2",
      "confidence": 0.99964696168899536
    },
    {
      "subjectId": "1",
      "objectId": "3",
      "confidence": 0.99964696168899536
    },
    {
      "subjectId": "4",
      "objectId": "1",
      "confidence": 0.68552839756011963
    }
  ]
}

라이선스 어휘 포함

기본적으로 Healthcare Natural Language API 응답에는 지원되는 의료 어휘가 포함됩니다.

요청이 다음 요구사항을 충족하는 경우 응답에 SNOMED 임상 용어, 미국 기준(SNOMEDCT_US) 어휘를 포함할 수 있습니다.

API 요청은 미국에서 시작됩니다.
본문 요청의 licensedVocabularies 필드에는 SNOMEDCT_US 값이 포함됩니다.

SNOMED CT 어휘가 필요하지 않으면 이러한 제한사항이 적용되지 않습니다.

다음 샘플은 LicensedVocabularies 객체에 SNOMED CT 라이선스 어휘를 포함하여 "당뇨에 인슐린 양성 5단위 IV 관리" 의료 텍스트에서 의료 정보를 추출하는 방법을 보여줍니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트의 ID
LOCATION: 데이터 세트 위치

JSON 요청 본문:

{
  "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.",
  "licensedVocabularies": [
    "SNOMEDCT_US",
    "ICD10CM"
  ]
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

cat > request.json << 'EOF'
{
  "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.",
  "licensedVocabularies": [
    "SNOMEDCT_US",
    "ICD10CM"
  ]
}
EOF

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d @request.json \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/services/nlp:analyzeEntities"

PowerShell

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

@'
{
  "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.",
  "licensedVocabularies": [
    "SNOMEDCT_US",
    "ICD10CM"
  ]
}
'@  | Out-File -FilePath request.json -Encoding utf8

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json" `
    -InFile request.json `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/services/nlp:analyzeEntities" | Select-Object -Expand Content

요청이 성공하면 응답에 SNOMEDCT_US 및 ICD10CM 라이선스 어휘의 어휘 코드가 포함됩니다. 출력은 다음과 같으며 요청된 라이선스 어휘 코드는 굵게 표시됩니다.

응답

{
  "entityMentions": [
    {
      "mentionId": "1",
      "type": "MEDICINE",
      "text": {
        "content": "Insulin regimen",
        "beginOffset": 0
      },
      "linkedEntities": [
        {
          "entityId": "UMLS/C0021641"
        },
        {
          "entityId": "UMLS/C0795635"
        },
        {
          "entityId": "UMLS/C1533581"
        },
        {
          "entityId": "UMLS/C3537244"
        },
        {
          "entityId": "UMLS/C3714501"
        }
      ],
      "temporalAssessment": {
        "value": "UPCOMING",
        "confidence": 0.95375925302505493
      },
      "certaintyAssessment": {
        "value": "LIKELY",
        "confidence": 0.618984580039978
      },
      "subject": {
        "value": "PATIENT",
        "confidence": 0.99964696168899536
      },
      "confidence": 0.62128835916519165
    },
    {
      "mentionId": "2",
      "type": "MED_DOSE",
      "text": {
        "content": "5 units",
        "beginOffset": 16
      },
      "confidence": 0.78806477785110474
    },
    {
      "mentionId": "3",
      "type": "MED_ROUTE",
      "text": {
        "content": "IV",
        "beginOffset": 24
      },
      "linkedEntities": [
        {
          "entityId": "UMLS/C0348016"
        }
      ],
      "confidence": 0.8927428126335144
    },
    {
      "mentionId": "4",
      "type": "PROBLEM",
      "text": {
        "content": "diabetes",
        "beginOffset": 52
      },
      "linkedEntities": [
        {
          "entityId": "UMLS/C0011847"
        },
        {
          "entityId": "UMLS/C0011849"
        },
        {
          "entityId": "UMLS/C0241863"
        }
      ],
      "temporalAssessment": {
        "value": "CURRENT",
        "confidence": 0.91680806875228882
      },
      "certaintyAssessment": {
        "value": "LIKELY",
        "confidence": 0.98018729686737061
      },
      "subject": {
        "value": "PATIENT",
        "confidence": 0.99965417385101318
      },
      "confidence": 0.99518013000488281
    }
  ],
  "entities": [
    {
      "entityId": "UMLS/C0011847",
      "preferredTerm": "Diabetes",
      "vocabularyCodes": [
        "ICD10CM/E11",
        "LNC/LA10529-8",
        "LNC/LP128793-9",
        "LNC/MTHU040702",
        "MTH/NOCODE",
        "OMIM/MTHU050182"
      ]
    },
    {
      "entityId": "UMLS/C0011849",
      "preferredTerm": "Diabetes Mellitus",
      "vocabularyCodes": [
        "HPO/HP:0000819",
        "ICD10CM/E08-E13",
        "ICD9CM/250",
        "LNC/LA14291-1",
        "LNC/LA27539-8",
        "LNC/LP74722-7",
        "LNC/MTHU020781",
        "MEDLINEPLUS/4",
        "MSH/D003920",
        "MTH/NOCODE",
        "MTH/U000263",
        "NCI/C2985",
        "OMIM/MTHU036798",
        "SNOMEDCT_US/73211009"
      ]
    },
    {
      "entityId": "UMLS/C0021641",
      "preferredTerm": "Insulin",
      "vocabularyCodes": [
        "FMA/83365",
        "LNC/LA15805-7",
        "LNC/LP14676-8",
        "LNC/LP16325-0",
        "LNC/LP32542-0",
        "LNC/LP70329-5",
        "LNC/MTHU002108",
        "LNC/MTHU019392",
        "MSH/D007328",
        "MTH/NOCODE",
        "SNOMEDCT_US/39487003",
        "SNOMEDCT_US/412222002",
        "SNOMEDCT_US/67866001"
      ]
    },
    {
      "entityId": "UMLS/C0241863",
      "preferredTerm": "Diabetic",
      "vocabularyCodes": [
        "LNC/LA26134-9"
      ]
    },
    {
      "entityId": "UMLS/C0348016",
      "preferredTerm": "Intravenous",
      "vocabularyCodes": [
        "LNC/LA9437-0",
        "LNC/LP32453-0",
        "MTH/NOCODE",
        "NCI/C13346",
        "SNOMEDCT_US/255560000"
      ]
    },
    {
      "entityId": "UMLS/C0795635",
      "preferredTerm": "insulin, regular, human",
      "vocabularyCodes": [
        "LNC/LP17001-6",
        "MSH/D061386",
        "MTH/NOCODE",
        "NCI/C29125",
        "RXNORM/253182",
        "SNOMEDCT_US/126210001",
        "SNOMEDCT_US/417423002",
        "SNOMEDCT_US/420609005",
        "SNOMEDCT_US/96367001",
        "VANDF/4017559",
        "VANDF/4017569",
        "VANDF/4019786"
      ]
    },
    {
      "entityId": "UMLS/C1533581",
      "preferredTerm": "Therapeutic Insulin",
      "vocabularyCodes": [
        "MTH/NOCODE",
        "NCI/C581"
      ]
    },
    {
      "entityId": "UMLS/C3537244",
      "preferredTerm": "Insulins",
      "vocabularyCodes": [
        "MSH/D061385",
        "MTH/NOCODE"
      ]
    },
    {
      "entityId": "UMLS/C3714501",
      "preferredTerm": "Insulin Drug Class",
      "vocabularyCodes": [
        "MTH/NOCODE",
        "VANDF/4021631"
      ]
    }
  ],
  "relationships": [
    {
      "subjectId": "1",
      "objectId": "2",
      "confidence": 0.99964696168899536
    },
    {
      "subjectId": "1",
      "objectId": "3",
      "confidence": 0.99964696168899536
    },
    {
      "subjectId": "4",
      "objectId": "1",
      "confidence": 0.68552839756011963
    }
  ]
}

FHIR R4 번들로 출력 추출

텍스트에서 항목을 추출하여 FHIR R4 리소스 및 요소에 매핑할 수 있습니다. 결과 FHIR R4 번들에는 모든 항목, 항목 멘션, 관계가 JSON 형식으로 포함됩니다. 예를 들어 Healthcare Natural Language API는 기본 항목 PROBLEM을 Condition FHIR R4 리소스에 매핑하고 항목 PROBLEM.ANATOMICAL_STRUCTURE를 Condition.bodySite FHIR 요소에 매핑합니다. 다른 매핑 목록은 FHIR 번들로 Healthcare Natural Language API 출력을 참조하세요.

다음 샘플은 FHIR R4 번들에서 "당뇨에 인슐린 양생 5단위 IV 관리" 의료 텍스트에서 의료 정보를 추출하는 방법을 보여줍니다. 자세한 내용은 AlternativeOutputFormat 객체를 참조하세요.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트의 ID
LOCATION: 데이터 세트 위치

JSON 요청 본문:

{
  "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.",
  "alternativeOutputFormat": "FHIR_BUNDLE"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

cat > request.json << 'EOF'
{
  "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.",
  "alternativeOutputFormat": "FHIR_BUNDLE"
}
EOF

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d @request.json \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/services/nlp:analyzeEntities"

PowerShell

요청 본문을 request.json 파일에 저장합니다. 터미널에서 다음 명령어를 실행하여 현재 디렉터리에 이 파일을 만들거나 덮어씁니다.

@'
{
  "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.",
  "alternativeOutputFormat": "FHIR_BUNDLE"
}
'@  | Out-File -FilePath request.json -Encoding utf8

그런 후 다음 명령어를 실행하여 REST 요청을 전송합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json" `
    -InFile request.json `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/services/nlp:analyzeEntities" | Select-Object -Expand Content

요청이 성공하면 응답에 다음 항목이 포함된 JSON 객체가 포함됩니다.

인식된 항목은 항목, 관계, 컨텍스트 속성 추출의 출력과 유사한 형식으로 항목 및 관계를 언급합니다.
문자열 형식의 FHIR 번들 리소스를 포함하는 fhirBundle 키. FHIR 번들에는 모든 항목, 항목 멘션, 관계가 JSON 형식으로 포함됩니다.

응답

{
  "entityMentions": [
    {
      "mentionId": "1",
      "type": "MEDICINE",
      "text": {
        "content": "Insulin regimen",
        "beginOffset": 0
      },
      "linkedEntities": [
        {
          "entityId": "UMLS/C0021641"
        },
        {
          "entityId": "UMLS/C0795635"
        },
        {
          "entityId": "UMLS/C1533581"
        },
        {
          "entityId": "UMLS/C3537244"
        },
        {
          "entityId": "UMLS/C3714501"
        }
      ],
      "temporalAssessment": {
        "value": "UPCOMING",
        "confidence": 0.95375925302505493
      },
      "certaintyAssessment": {
        "value": "LIKELY",
        "confidence": 0.618984580039978
      },
      "subject": {
        "value": "PATIENT",
        "confidence": 0.99964696168899536
      },
      "confidence": 0.62128835916519165
    },
    {
      "mentionId": "2",
      "type": "MED_DOSE",
      "text": {
        "content": "5 units",
        "beginOffset": 16
      },
      "confidence": 0.78806477785110474
    },
    {
      "mentionId": "3",
      "type": "MED_ROUTE",
      "text": {
        "content": "IV",
        "beginOffset": 24
      },
      "linkedEntities": [
        {
          "entityId": "UMLS/C0348016"
        }
      ],
      "confidence": 0.8927428126335144
    },
    {
      "mentionId": "4",
      "type": "PROBLEM",
      "text": {
        "content": "diabetes",
        "beginOffset": 52
      },
      "linkedEntities": [
        {
          "entityId": "UMLS/C0011847"
        },
        {
          "entityId": "UMLS/C0011849"
        },
        {
          "entityId": "UMLS/C0241863"
        }
      ],
      "temporalAssessment": {
        "value": "CURRENT",
        "confidence": 0.91680806875228882
      },
      "certaintyAssessment": {
        "value": "LIKELY",
        "confidence": 0.98018729686737061
      },
      "subject": {
        "value": "PATIENT",
        "confidence": 0.99965417385101318
      },
      "confidence": 0.99518013000488281
    }
  ],
  "entities": [
    {
      "entityId": "UMLS/C0011847",
      "preferredTerm": "Diabetes",
      "vocabularyCodes": [
        "ICD10CM/E11",
        "LNC/LA10529-8",
        "LNC/LP128793-9",
        "LNC/MTHU040702",
        "MTH/NOCODE",
        "OMIM/MTHU050182"
      ]
    },
    {
      "entityId": "UMLS/C0011849",
      "preferredTerm": "Diabetes Mellitus",
      "vocabularyCodes": [
        "HPO/HP:0000819",
        "ICD10CM/E08-E13",
        "ICD9CM/250",
        "LNC/LA14291-1",
        "LNC/LA27539-8",
        "LNC/LP74722-7",
        "LNC/MTHU020781",
        "MEDLINEPLUS/4",
        "MSH/D003920",
        "MTH/NOCODE",
        "MTH/U000263",
        "NCI/C2985",
        "OMIM/MTHU036798"
      ]
    },
    {
      "entityId": "UMLS/C0021641",
      "preferredTerm": "Insulin",
      "vocabularyCodes": [
        "FMA/83365",
        "LNC/LA15805-7",
        "LNC/LP14676-8",
        "LNC/LP16325-0",
        "LNC/LP32542-0",
        "LNC/LP70329-5",
        "LNC/MTHU002108",
        "LNC/MTHU019392",
        "MSH/D007328",
        "MTH/NOCODE"
      ]
    },
    {
      "entityId": "UMLS/C0241863",
      "preferredTerm": "Diabetic",
      "vocabularyCodes": [
        "LNC/LA26134-9"
      ]
    },
    {
      "entityId": "UMLS/C0348016",
      "preferredTerm": "Intravenous",
      "vocabularyCodes": [
        "LNC/LA9437-0",
        "LNC/LP32453-0",
        "MTH/NOCODE",
        "NCI/C13346"
      ]
    },
    {
      "entityId": "UMLS/C0795635",
      "preferredTerm": "insulin, regular, human",
      "vocabularyCodes": [
        "LNC/LP17001-6",
        "MSH/D061386",
        "MTH/NOCODE",
        "NCI/C29125",
        "RXNORM/253182",
        "VANDF/4017559",
        "VANDF/4017569",
        "VANDF/4019786"
      ]
    },
    {
      "entityId": "UMLS/C1533581",
      "preferredTerm": "Therapeutic Insulin",
      "vocabularyCodes": [
        "MTH/NOCODE",
        "NCI/C581"
      ]
    },
    {
      "entityId": "UMLS/C3537244",
      "preferredTerm": "Insulins",
      "vocabularyCodes": [
        "MSH/D061385",
        "MTH/NOCODE"
      ]
    },
    {
      "entityId": "UMLS/C3714501",
      "preferredTerm": "Insulin Drug Class",
      "vocabularyCodes": [
        "MTH/NOCODE",
        "VANDF/4021631"
      ]
    }
  ],
  "relationships": [
    {
      "subjectId": "1",
      "objectId": "2",
      "confidence": 0.99964696168899536
    },
    {
      "subjectId": "1",
      "objectId": "3",
      "confidence": 0.99964696168899536
    },
    {
      "subjectId": "4",
      "objectId": "1",
      "confidence": 0.68552839756011963
    }
  ],
  "fhirBundle": "{\n    \"entry\": [\n      {\n        \"fullUrl\": \"urn:uuid:7e6e2323-f9e3-4241-bb84-1a8ff997ef99\",\n        \"request\": {\n          \"method\": \"POST\",\n          \"url\": \"Condition\"\n        },\n        \"resource\": {\n          \"category\": [\n            {\n              \"coding\": [\n                {\n                  \"code\": \"problem-list-item\",\n                  \"display\": \"Problem List Item\",\n                  \"system\": \"http://terminology.hl7.org/CodeSystem/condition-category\"\n                }\n              ]\n            }\n          ],\n          \"clinicalStatus\": {\n            \"coding\": [\n              {\n                \"code\": \"active\",\n                \"system\": \"http://terminology.hl7.org/CodeSystem/condition-clinical\"\n              }\n            ]\n          },\n          \"evidence\": [\n            {\n              \"code\": [\n                {\n                  \"coding\": [\n                    {\n                      \"code\": \"C0011847\",\n                      \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n                    },\n                    {\n                      \"code\": \"C0011849\",\n                      \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n                    },\n                    {\n                      \"code\": \"C0241863\",\n                      \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n                    }\n                  ]\n                }\n              ]\n            }\n          ],\n          \"extension\": [\n            {\n              \"url\": \"temporalrelationship\",\n              \"valueCode\": \"CURRENT\"\n            },\n            {\n              \"url\": \"certaintyassessment\",\n              \"valueCode\": \"LIKELY\"\n            },\n            {\n              \"url\": \"g.co/fhir/StructureDefinition/healthcare_nlp\",\n              \"valueCodeableConcept\": {\n                \"coding\": [\n                  {\n                    \"code\": \"C0011847\",\n                    \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n                  },\n                  {\n                    \"code\": \"C0011849\",\n                    \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n                  },\n                  {\n                    \"code\": \"C0241863\",\n                    \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n                  }\n                ]\n              }\n            },\n            {\n              \"url\": \"source\",\n              \"valueReference\": {\n                \"id\": \"#Document1\"\n              }\n            },\n            {\n              \"url\": \"source_offset\",\n              \"valueInteger\": 52\n            },\n            {\n              \"url\": \"entityconfidence\",\n              \"valueDecimal\": 0.995180\n            }\n          ],\n          \"meta\": {\n            \"source\": \"https://healthcare.googleapis.com/v1alpha2/projects/\u003cPROJECTNAME\u003e/locations/\u003cLOCATION\u003e/services/nlp:analyzeEntities\"\n          },\n          \"resourceType\": \"Condition\",\n          \"subject\": {\n            \"reference\": \"Patient/Patient/\u003cPATIENT_ID\u003e\"\n          },\n          \"text\": {\n            \"div\": \"\u003cdiv xmlns=\\\"http://www.w3.org/1999/xhtml\\\"\u003e\u003cPreferred Term\u003e \u003cOptional: Date\u003e\u003c/div\u003e\",\n            \"status\": \"generated\"\n          },\n          \"verificationStatus\": {\n            \"coding\": [\n              {\n                \"code\": \"confirmed\",\n                \"system\": \"http://terminology.hl7.org/CodeSystem/condition-ver-status\"\n              }\n            ]\n          }\n        }\n      },\n      {\n        \"fullUrl\": \"urn:uuid:04be4df6-4bbc-4fb5-a62f-fb82e644b8d2\",\n        \"request\": {\n          \"method\": \"POST\",\n          \"url\": \"MedicationStatement\"\n        },\n        \"resource\": {\n          \"dosage\": [\n            {\n              \"route\": {\n                \"coding\": [\n                  {\n                    \"code\": \"C0348016\",\n                    \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n                  }\n                ]\n              }\n            }\n          ],\n          \"effectivePeriod\": {\n            \"start\": \"2024-02-06T16:55:32+00:00\"\n          },\n          \"extension\": [\n            {\n              \"url\": \"dosage\",\n              \"valueString\": \"5 units\"\n            },\n            {\n              \"url\": \"temporalrelationship\",\n              \"valueCode\": \"UPCOMING\"\n            },\n            {\n              \"url\": \"certaintyassessment\",\n              \"valueCode\": \"LIKELY\"\n            },\n            {\n              \"url\": \"entityconfidence\",\n              \"valueDecimal\": 0.621288\n            }\n          ],\n          \"medicationCodeableConcept\": {\n            \"coding\": [\n              {\n                \"code\": \"C0021641\",\n                \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n              },\n              {\n                \"code\": \"C0795635\",\n                \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n              },\n              {\n                \"code\": \"C1533581\",\n                \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n              },\n              {\n                \"code\": \"C3537244\",\n                \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n              },\n              {\n                \"code\": \"C3714501\",\n                \"system\": \"http://terminology.hl7.org/CodeSystem/umls\"\n              }\n            ],\n            \"text\": \"Insulin regimen\"\n          },\n          \"meta\": {\n            \"source\": \"https://healthcare.googleapis.com/v1alpha2/projects/\u003cPROJECTNAME\u003e/locations/\u003cLOCATION\u003e/services/nlp:analyzeEntities\"\n          },\n          \"reasonReference\": [\n            {\n              \"display\": \"7e6e2323-f9e3-4241-bb84-1a8ff997ef99\"\n            }\n          ],\n          \"resourceType\": \"MedicationStatement\",\n          \"status\": \"active\",\n          \"subject\": {\n            \"reference\": \"Patient/Patient/\u003cPATIENT_ID\u003e\"\n          },\n          \"text\": {\n            \"div\": \"\u003cdiv xmlns=\\\"http://www.w3.org/1999/xhtml\\\"\u003e\u003c/div\u003e\",\n            \"status\": \"generated\"\n          }\n        }\n      },\n      {\n        \"fullUrl\": \"urn:uuid:f62fdb4b-a561-4855-96c8-23e41d8ad7b0\",\n        \"request\": {\n          \"method\": \"POST\",\n          \"url\": \"DocumentReference\"\n        },\n        \"resource\": {\n          \"content\": [\n            {\n              \"attachment\": {\n                \"url\": \"\u003cDOC_REFER\u003e\"\n              }\n            }\n          ],\n          \"meta\": {\n            \"source\": \"https://healthcare.googleapis.com/v1alpha2/projects/\u003cPROJECTNAME\u003e/locations/\u003cLOCATION\u003e/services/nlp:analyzeEntities\"\n          },\n          \"resourceType\": \"DocumentReference\",\n          \"status\": \"current\",\n          \"subject\": {\n            \"id\": \"Patient/\u003cPATIENT_ID\u003e\"\n          }\n        }\n      }\n    ],\n    \"resourceType\": \"Bundle\",\n    \"type\": \"transaction\"\n  }"
}