Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizzare l'API Healthcare Natural Language

Questa pagina spiega come abilitare l'API Healthcare Natural Language, configurare le autorizzazioni e chiamare il metodo analyzeEntities per estrarre insight medici da testi medici.

Panoramica

L'API Healthcare Natural Language fornisce soluzioni di machine learning per ricavare insight da testi medici. L'API Healthcare Natural Language fa parte dell'API Cloud Healthcare. Per una panoramica dell'API Healthcare Natural Language, consulta la documentazione concettuale dell'API Healthcare Natural Language.

L'API Healthcare Natural Language analizza testi medici non strutturati, come cartelle cliniche o richieste di rimborso assicurativo. Quindi, genera una rappresentazione strutturata dei dati delle entità di conoscenza medica archiviate in queste origini dati per l'analisi e l'automazione downstream. Ad esempio, puoi:

Estrai informazioni su concetti medici come malattie, farmaci, dispositivi medici, procedure e i relativi attributi clinicamente rilevanti
Mappare i concetti medici a vocabolari medici standard come RxNorm, ICD-10, MeSH e SNOMED CT (solo per utenti di Stati Uniti e Regno Unito)
Deriva approfondimenti medici dal testo e integrali con i prodotti di analisi dei dati in Google Cloud

Paesi in cui è disponibile il servizio

L'API Healthcare Natural Language è disponibile nelle seguenti località:

Nome della sede	Descrizione della sede
`asia-south1`	Mumbai, India
`australia-southeast1`	Sydney, Australia
`europe-west2`	Londra, Regno Unito
`europe-west4`	Paesi Bassi
`northamerica-northeast1`	Montréal, Canada
`us-central1`	Iowa, Stati Uniti

Abilitare l'API Healthcare Natural Language

Prima di iniziare a utilizzare l'API Healthcare Natural Language, devi abilitare l'API per il tuo progetto Google Cloud . Puoi utilizzare l'API Healthcare Natural Language senza abilitare o utilizzare le funzionalità dell'API Cloud Healthcare.

Per abilitare l'API, completa i seguenti passaggi:

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Create a service account:

Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator). Learn how to grant roles.
In the Google Cloud console, go to the Create service account page.
Go to Create service account
Select your project.
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

In the Service account description field, enter a description. For example, Service account for quickstart.
Click Create and continue.
Grant the Project > Owner role to the service account.

To grant the role, find the Select a role list, then select Project > Owner.

Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
Click Continue.
Click Done to finish creating the service account.

Do not close your browser window. You will use it in the next step.

Create a service account key:

In the Google Cloud console, click the email address for the service account that you created.
Click Keys.
Click Add key, and then click Create new key.
Click Create. A JSON key file is downloaded to your computer.
Click Close.

Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

Example: Linux or macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:

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

Example: Windows

For PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:

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

For command prompt:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Replace KEY_PATH with the path of the JSON file that contains your credentials.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Create a service account:

Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator). Learn how to grant roles.
In the Google Cloud console, go to the Create service account page.
Go to Create service account
Select your project.
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

In the Service account description field, enter a description. For example, Service account for quickstart.
Click Create and continue.
Grant the Project > Owner role to the service account.

To grant the role, find the Select a role list, then select Project > Owner.

Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
Click Continue.
Click Done to finish creating the service account.

Do not close your browser window. You will use it in the next step.

Create a service account key:

In the Google Cloud console, click the email address for the service account that you created.
Click Keys.
Click Add key, and then click Create new key.
Click Create. A JSON key file is downloaded to your computer.
Click Close.

Example: Linux or macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:

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

Example: Windows

For PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:

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

For command prompt:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Replace KEY_PATH with the path of the JSON file that contains your credentials.

Enable the Cloud Healthcare API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the API

Install the Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Configurare le autorizzazioni

Per utilizzare le funzionalità descritte in questa guida, devi disporre dell'autorizzazione healthcare.nlpservice.analyzeEntities, inclusa nel ruolo healthcare.nlpServiceViewer.

Per assegnare questo ruolo, esegui il comando gcloud projects add-iam-policy-binding:

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

Estrazione di entità, relazioni e attributi contestuali

L'API Healthcare Natural Language utilizza modelli sensibili al contesto per estrarre entità mediche, relazioni e attributi contestuali. Ogni entità di testo viene estratta in una voce del dizionario medico. Per estrarre questo livello di approfondimenti medici dal testo medico, utilizza il metodo projects.locations.services.nlp.analyzeEntities.

Per includere il vocabolario con licenza SNOMED CT nelle menzioni di entità, vedi Includere vocabolari con licenza.

Per estrarre approfondimenti medici da testi medici utilizzando l'API Healthcare Natural Language, crea una richiesta POST e specifica il testo di destinazione nel campo documentContent. La dimensione massima del testo medico è di 20.000 caratteri Unicode.

Gli esempi riportati di seguito mostrano come utilizzare il metodo analyzeEntities per estrarre informazioni mediche dal testo medico "Insulin regimen 5 units IV will be administered for diabetes.".

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

PROJECT_ID: l'ID del tuo progetto Google Cloud
LOCATION: la posizione del set di dati

Corpo JSON della richiesta:

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

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

Quindi esegui questo comando per inviare la richiesta 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

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

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

Quindi esegui questo comando per inviare la richiesta 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

Se la richiesta ha esito positivo, la risposta include le seguenti informazioni:

Entità di conoscenza medica riconosciute
Funzionalità
Relazioni tra le entità riconosciute
Attributi contestuali
Mappature delle entità di conoscenza medica in terminologie standard

Per un elenco dei tipi di entità, attributi e relazioni supportati, consulta la sezione Funzionalità dell'API Healthcare Natural Language.

La seguente risposta identifica l'insulina terapeutica, l'entità con il codice C581 nel sistema di terminologia NCI, come farmaco. La risposta include anche il punteggio di confidenza assegnato alla risposta. Per saperne di più sui campi di risposta, consulta la documentazione di analyzeEntities.

Risposta

{
  "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
    }
  ]
}

Includi vocabolari concessi in licenza

Per impostazione predefinita, le risposte dell'API Healthcare Natural Language includono i vocabolari medici supportati.

Puoi includere il vocabolario SNOMED Clinical Terms, US Version (SNOMEDCT_US) nella risposta se la tua richiesta soddisfa i seguenti requisiti:

La richiesta API ha origine negli Stati Uniti.
Il campo licensedVocabularies nel corpo della richiesta ha il valore SNOMEDCT_US.

Se non hai bisogno del vocabolario SNOMED CT, nessuna di queste limitazioni si applica.

Il seguente esempio mostra come includere il vocabolario con licenza SNOMED CT nell'oggetto LicensedVocabularies per estrarre informazioni mediche dal testo medico "Insulin regimen 5 units IV will be administered for diabetes.".

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

PROJECT_ID: l'ID del tuo progetto Google Cloud
LOCATION: la posizione del set di dati

Corpo JSON della richiesta:

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

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

Quindi esegui questo comando per inviare la richiesta 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

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

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

Quindi esegui questo comando per inviare la richiesta 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

Se la richiesta ha esito positivo, la risposta include i codici del vocabolario dei vocabolari con licenza SNOMEDCT_US e ICD10CM. L'output è il seguente e i codici del vocabolario con licenza richiesti sono in grassetto:

Risposta

{
  "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
    }
  ]
}

Estrai l'output come bundle FHIR R4

Puoi estrarre entità dal testo e mapparle a risorse ed elementi FHIR R4. Il bundle FHIR R4 risultante include tutte le entità, le menzioni di entità e le relazioni in formato JSON. Ad esempio, l'API Healthcare Natural Language mappa l'entità di base PROBLEM alla risorsa FHIR R4 Condition e l'entità PROBLEM.ANATOMICAL_STRUCTURE all'elemento FHIR Condition.bodySite. Per un elenco di altri mapping, consulta Output dell'API Healthcare Natural Language come bundle FHIR.

Gli esempi riportati di seguito mostrano come estrarre informazioni mediche dal testo medico "Insulin regimen 5 units IV will be administered for diabetes." (Regime insulinico 5 unità IV saranno somministrate per il diabete) in un bundle FHIR R4. Per maggiori informazioni, vedi l'oggetto AlternativeOutputFormat.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

PROJECT_ID: l'ID del tuo progetto Google Cloud
LOCATION: la posizione del set di dati

Corpo JSON della richiesta:

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

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

Quindi esegui questo comando per inviare la richiesta 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

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

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

Quindi esegui questo comando per inviare la richiesta 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

Se la richiesta ha esito positivo, la risposta contiene un oggetto JSON con le seguenti voci:

Le menzioni di entità riconosciute con le entità e le relative relazioni in un formato simile all'output in Estrazione di entità, relazioni e attributi contestuali.
Una chiave fhirBundle contenente una risorsa bundle FHIR formattata come stringa. Il bundle FHIR include tutte le entità, le menzioni di entità e le relazioni in formato JSON.

Risposta

{
  "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  }"
}

Utilizzare l'API Healthcare Natural Language Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Panoramica

Paesi in cui è disponibile il servizio

Abilitare l'API Healthcare Natural Language

Configurare le autorizzazioni

Estrazione di entità, relazioni e attributi contestuali

REST

curl

PowerShell

Risposta

Includi vocabolari concessi in licenza

REST

curl

PowerShell

Risposta

Estrai l'output come bundle FHIR R4

REST

curl

PowerShell

Risposta

Utilizzare l'API Healthcare Natural Language