Cette page explique comment activer l'API Healthcare Natural Language, configurer des autorisations et appeler la méthode analyzeEntities
pour extraire des insights médicaux du texte médical.
Présentation
L'API Healthcare Natural Language fournit des solutions de machine learning permettant de recueillir des informations utiles à partir de texte médical. L'API Healthcare Natural Language fait partie de l'API Cloud Healthcare. Pour une présentation de l'API Healthcare Natural Language, consultez la documentation sur les concepts de l'API Healthcare Natural Language.
L'API Healthcare Natural Language analyse du texte médical non structuré, tel que des dossiers médicaux ou des déclarations d'assurance. Elle génère ensuite une représentation des données structurées des entités de connaissances médicales stockées dans ces sources de données pour une analyse et une automatisation en aval. Par exemple, vous pouvez :
- Extraire des informations sur des concepts médicaux comme les maladies, les médicaments, les dispositifs médicaux, les procédures et leurs attributs pertinents sur le plan médical
- Mapper des concepts médicaux à des vocabulaires médicaux standards tels que RxNorm, ICD-10, MeSH et SNOMED CT (utilisateurs américains seulement)
- Dégager des insights médicaux à partir de texte et les intégrer aux produits d'analyse de données dans Google Cloud
Régions acceptées
L'API Healthcare Natural Language est disponible dans les emplacements suivants :
Nom du lieu | Description de l'emplacement |
---|---|
asia-south1 |
Mumbai, Inde |
australia-southeast1 |
Sydney, Australie |
europe-west2 |
Londres, Royaume-Uni |
europe-west4 |
Pays-Bas |
northamerica-northeast1 |
Montréal, Canada |
us-central1 |
Iowa, États-Unis |
Activer l'API Healthcare Natural Language
Avant de commencer à utiliser l'API Healthcare Natural Language, vous devez l'activer pour votre projet Google Cloud. Vous pouvez utiliser l'API Healthcare Natural Language sans activer ni utiliser les fonctionnalités de l'API Cloud Healthcare.
Pour activer l'API, procédez comme suit :
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Vérifiez que la facturation est activée pour votre projet 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.
-
Définissez la variable d'environnement
GOOGLE_APPLICATION_CREDENTIALS
sur le chemin d'accès du fichier JSON contenant vos identifiants. Cette variable ne s'applique qu'à la session de shell actuelle. Par conséquent, si vous ouvrez une nouvelle session, vous devez de nouveau la définir. -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Vérifiez que la facturation est activée pour votre projet 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.
-
Définissez la variable d'environnement
GOOGLE_APPLICATION_CREDENTIALS
sur le chemin d'accès du fichier JSON contenant vos identifiants. Cette variable ne s'applique qu'à la session de shell actuelle. Par conséquent, si vous ouvrez une nouvelle session, vous devez de nouveau la définir. -
Activez Cloud Healthcare API.
- Installez Google Cloud CLI.
-
Pour initialiser gcloudCLI, exécutez la commande suivante :
gcloud init
Configurer les autorisations
Pour utiliser les fonctionnalités de ce guide, vous devez disposer de l'autorisation healthcare.nlpservice.analyzeEntities
, incluse dans le rôle healthcare.nlpServiceViewer
.
Pour attribuer ce rôle, exécutez la commande gcloud projects add-iam-policy-binding
:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member serviceAccount:SERVICE_ACCOUNT_ID \ --role roles/healthcare.nlpServiceViewer
Extraire les entités, les relations et les attributs contextuels
L'API Healthcare Natural Language utilise des modèles contextuels pour extraire des entités médicales, des relations et des attributs contextuels. Chaque entité de texte est extraite dans une entrée de dictionnaire médical. Pour extraire des insights médicaux de ce niveau à partir de texte médical, utilisez la méthode projects.locations.services.nlp.analyzeEntities
.
Pour inclure le vocabulaire sous licence SNOMED CT dans les mentions de votre entité, consultez la section Inclure les vocabulaires sous licence.
Pour extraire des insights médicaux d'un texte médical à l'aide de l'API Healthcare Natural Language, exécutez une requête POST
et spécifiez le texte cible dans
la
documentContent
. La taille maximale d'un texte médical est de 20 000 caractères Unicode.
Les exemples suivants montrent comment utiliser la méthode analyzeEntities
pour extraire
des informations médicales issues du texte médical "Un régime d'insuline de 5 unités IV sera
administrés pour le diabète. »
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de données
Corps JSON de la requête :
{ "documentContent": "Insulin regimen 5 units IV will be administered for diabetes." }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
cat > request.json << 'EOF' { "documentContent": "Insulin regimen 5 units IV will be administered for diabetes." } EOF
Exécutez ensuite la commande suivante pour envoyer votre requête 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
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
@' { "documentContent": "Insulin regimen 5 units IV will be administered for diabetes." } '@ | Out-File -FilePath request.json -Encoding utf8
Exécutez ensuite la commande suivante pour envoyer votre requête 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
Si la requête aboutit, la réponse inclut les informations suivantes :
- Entités de connaissances médicales reconnues
- Fonctionnalités fonctionnelles
- Relations entre les entités reconnues
- Attributs contextuels
- Mappages des entités de connaissances médicales en termes standards
Pour obtenir la liste des types d'entités, d'attributs et de relations pris en charge, consultez la Fonctionnalités de l'API Healthcare Natural Language.
La réponse suivante identifie l'insuline thérapeutique, l'entité ayant
code C581
dans le système terminologique NCI, comme le médicament. La réponse inclut également l'indice de confiance attribué à la réponse. Pour en savoir plus sur les champs de réponse, consultez la documentation sur analyzeEntities
.
Inclure des vocabulaires agréés
Par défaut, les réponses de l'API Healthcare Natural Language incluent le paramètre vocabulaires médicaux acceptés.
Vous pouvez inclure le paramètre Conditions cliniques SNOMED, version États-Unis (SNOMEDCT_US) vocabulaire dans la réponse si votre requête répond aux exigences suivantes:
- La requête API provient des États-Unis.
- Le champ
licensedVocabularies
dans le corps de la requête contient la valeurSNOMEDCT_US
.
Si vous n'avez pas besoin du vocabulaire SNOMED CT, aucune de ces Des restrictions s'appliquent.
L'exemple suivant montre comment inclure le vocabulaire sous licence SNOMED CT dans le fichier
LicensedVocabularies
à extraire
des informations médicales issues du texte médical "Un régime d'insuline de 5 unités IV sera
administrés pour le diabète. »
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de données
Corps JSON de la requête :
{ "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.", "licensedVocabularies": [ "SNOMEDCT_US", "ICD10CM" ] }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
cat > request.json << 'EOF' { "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.", "licensedVocabularies": [ "SNOMEDCT_US", "ICD10CM" ] } EOF
Exécutez ensuite la commande suivante pour envoyer votre requête 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
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
@' { "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.", "licensedVocabularies": [ "SNOMEDCT_US", "ICD10CM" ] } '@ | Out-File -FilePath request.json -Encoding utf8
Exécutez ensuite la commande suivante pour envoyer votre requête 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
et ICD10CM
. Le résultat
est le suivant et les codes de vocabulaire sous licence demandés sont en gras:
Extraire la sortie en tant que bundle FHIR R4
Vous pouvez extraire des entités d'un texte et les mapper sur des ressources FHIR R4 et
éléments. Le bundle FHIR R4 résultant comprend toutes
les entités, les mentions d'entité,
et les relations au format JSON. Par exemple,
L'API Healthcare Natural Language mappe l'entité de base PROBLEM
avec le FHIR Condition
la ressource R4 et l'entité PROBLEM.ANATOMICAL_STRUCTURE
à la
Élément FHIR Condition.bodySite
. Pour obtenir la liste des autres mappages, consultez
Sortie de l'API Healthcare Natural Language en tant que bundle FHIR
Les exemples suivants montrent comment extraire
des informations médicales issues du texte médical "Un régime d'insuline de 5 unités IV sera
administrés pour le diabète. » dans un bundle FHIR R4.
Pour en savoir plus, consultez
AlternativeOutputFormat
.
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de données
Corps JSON de la requête :
{ "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.", "alternativeOutputFormat": "FHIR_BUNDLE" }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
cat > request.json << 'EOF' { "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.", "alternativeOutputFormat": "FHIR_BUNDLE" } EOF
Exécutez ensuite la commande suivante pour envoyer votre requête 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
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
@' { "documentContent": "Insulin regimen 5 units IV will be administered for diabetes.", "alternativeOutputFormat": "FHIR_BUNDLE" } '@ | Out-File -FilePath request.json -Encoding utf8
Exécutez ensuite la commande suivante pour envoyer votre requête 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
- L'entité reconnue mentionne les entités et leurs ces relations dans un format semblable à la sortie extraire les entités, les relations et les attributs contextuels ;
- Une clé
fhirBundle
contenant une ressource de bundle FHIR au format de chaîne. Le bundle FHIR comprend toutes les entités, les entités mentionnées et les relations dans JSON.