Questa pagina spiega come abilitare l'API Healthcare Natural Language, configurare
autorizzazioni e richiama 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 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 dati medici non strutturati come cartelle cliniche o richieste di risarcimento assicurativi. Genera quindi un modello di dati strutturati rappresentazione delle entità della conoscenza medica memorizzate in queste origini dati per l'analisi e l'automazione downstream. Ad esempio, puoi:
- Estrae informazioni su concetti medici come malattie, farmaci dispositivi medici, procedure e relativi attributi clinicamente rilevanti
- Mappa i concetti medici ai vocabolari medici standard come RxNorm, ICD-10, MeSH e SNOMED CT (solo utenti degli Stati Uniti)
- Ricava insight medici dai testi e integrali con l'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 del luogo |
---|---|
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 |
Abilita 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 lo API Healthcare Natural Language senza abilitare o utilizzare le funzionalità del API Cloud Healthcare.
Per abilitare l'API, completa i seguenti passaggi:
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Create a service account:
-
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.
- 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.
-
Imposta la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS
sul percorso del file JSON che contiene le tue credenziali. Questa variabile si applica solo alla sessione di shell attuale. Pertanto, se apri una nuova sessione, imposta di nuovo la variabile. -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Create a service account:
-
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.
- 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.
-
Imposta la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS
sul percorso del file JSON che contiene le tue credenziali. Questa variabile si applica solo alla sessione di shell attuale. Pertanto, se apri una nuova sessione, imposta di nuovo la variabile. -
Attiva Cloud Healthcare API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Configurare le autorizzazioni
Per utilizzare le funzionalità di questa guida, devi disporre del
healthcare.nlpservice.analyzeEntities
l'autorizzazione, ovvero
incluso in healthcare.nlpServiceViewer
role.
Per assegnare questo ruolo, esegui
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à, relazioni e attributi contestuali. Ogni entità di testo viene estratta
in una voce del dizionario di medicina. Per estrarre questo livello di
informazioni mediche
medico, utilizza
projects.locations.services.nlp.analyzeEntities
.
Per includere il vocabolario autorizzato SNOMED CT nelle menzioni delle entità, consulta la sezione Includere i vocabolari autorizzati.
Per estrarre insight medici da testi medici utilizzando l'API Healthcare Natural Language, effettua una richiesta POST
e specifica il testo di destinazione in
il
documentContent
. La dimensione massima del testo medico è di 20.000 caratteri Unicode.
I seguenti esempi mostrano come utilizzare il metodo analyzeEntities
per estrarre
consigli medici dal testo medico "Il regime di insulina 5 unità IV sarà
somministrati per il diabete".
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: 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 delle seguenti 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." } 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." } '@ | 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à delle conoscenze mediche riconosciute
- Caratteristiche funzionali
- Relazioni tra le persone giuridiche riconosciute
- Attributi contestuali
- Mappature delle entità di conoscenza medica in terminologie standard
Per un elenco di tipi di entità, attributi e relazioni supportati, consulta Funzionalità dell'API Healthcare Natural Language.
La seguente risposta identifica l'insulina terapeutica, l'entità con
codice C581
nel sistema terminologico NCI, come farmaco. La risposta
include anche il punteggio di confidenza assegnato alla risposta. Per maggiori informazioni
informazioni sui campi di risposta, consulta
analyzeEntities
documentazione.
Includi i vocabolari autorizzati
Per impostazione predefinita, le risposte dell'API Healthcare Natural Language includono il parametro vocaboli medici supportati.
Puoi includere Termini clinici SNOMED, versione USA (SNOMEDCT_US) vocabolario 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 valoreSNOMEDCT_US
.
Se non ti serve il vocabolario SNOMED CT, nessuno di questi sono previste limitazioni.
L'esempio seguente mostra come includere il vocabolario autorizzato SNOMED CT nel
LicensedVocabularies
oggetto da estrarre
consigli medici dal testo medico "Il regime di insulina 5 unità IV sarà
somministrati per il diabete".
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: 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 delle seguenti 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
SNOMEDCT_US
e ICD10CM
. L'output
è quanto segue e i codici del vocabolario concessi in licenza richiesti sono in grassetto:
Estrai l'output come bundle FHIR R4
Puoi estrarre le entità dal testo e mapparle alle risorse FHIR R4.
elementi. Il bundle FHIR R4 risultante include tutte le entità, le menzioni delle entità,
in formato JSON. Ad esempio,
L'API Healthcare Natural Language mappa l'entità di base PROBLEM
al FHIR Condition
la risorsa R4 e l'entità PROBLEM.ANATOMICAL_STRUCTURE
alla
Condition.bodySite
elemento FHIR. Per un elenco di altre mappature, vedi
Output dell'API Healthcare Natural Language come bundle FHIR.
I seguenti esempi mostrano come estrarre
consigli medici dal testo medico "Il regime di insulina 5 unità IV sarà
somministrati per il diabete". in un bundle FHIR R4.
Per ulteriori informazioni, vedi
AlternativeOutputFormat
.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: 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 delle seguenti 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
- La persona giuridica riconosciuta menziona con le persone giuridiche e i loro relazioni in un formato simile all'output Estrai entità, relazioni e attributi contestuali.
- Una chiave
fhirBundle
contenente una risorsa bundle FHIR in formato stringa. Il bundle FHIR include tutte le entità, le menzioni delle entità e le relazioni JSON.