Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Traitement du langage naturel (NLP) intégré pour HealthLake
AWS HealthLake fournit des bibliothèques intégrées de traitement du langage naturel (NLP) pour analyser, identifier et cartographier les données non structurées stockées dans les types de ressources [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)FHIR.
**Important**
La fonction NLP intégrée HealthLake est désactivée par défaut. Pour l'activer, soumettez un dossier d'assistance en utilisant [AWS Support Center Console](https://console.aws.amazon.com/support/home#/). Pour créer votre dossier, connectez-vous à votre dossier Compte AWS et choisissez **Créer un dossier**.
HealthLake Le NLP intégré fonctionne en appelant les actions Amazon Comprehend Medical `DetectEntities-V2` et `InferICD10-CM` `InferRxNorm` API. Les actions ajoutent leurs résultats sous forme d'extension à la `DocumentReference` ressource. Lorsque les actions de l'API Amazon Comprehend Medical détectent des traits qui `SIGN` sont `SYMPTOM` `DIAGNOSIS` et/ou génèrent une ressource [https://hl7.org/fhir/R4/linkage.html](https://hl7.org/fhir/R4/linkage.html)FHIR. Les nouvelles `Condition` `Observation` ressources sont créées à partir d'entités identifiées par les traits de`SIGN`, ou`SYMPTOM`, `DIAGNOSIS` et elles sont liées au document source à l'aide de la `Linkage` ressource.
**Note**
Bien que les `GET` demandes soient prises en charge pour les ressources FHIR générées par le NLP HealthLake intégré, la `search` fonctionnalité de l'API FHIR ne l'est pas. Pour en savoir plus sur la recherche d'extensions NLP à l'aide HealthLake de l'intégration avec Athena, consultez. [Index et requête SQL](integrating-athena.md)
**Contents**
+ [HealthLake Bibliothèques NLP intégrées](med-example.md)
+ [Utilisation des interactions avec l'API REST FHIR](nlp-rest-api.md)
+ [Paramètres de recherche pour le HealthLake NLP intégré](search-parameters-med.md)
+ [HealthLake exemples de demandes NLP intégrées](cm-api-results.md)
# HealthLake Bibliothèques NLP intégrées
HealthLake déduit les données trouvées dans le type de `DocumentReference` ressource à l'aide des bibliothèques Amazon Comprehend Medical. L'API Amazon Comprehend Medical fonctionne `InferRxNorm` et `DetectEntities-V2` détecte `InferICD10-CM` les problèmes de santé en *tant que* caractéristiques. Chaque opération fournit des informations différentes.
**Prise en charge des langages**
Les opérations de l'API Amazon Comprehend Medical détectent uniquement les entités médicales dans les textes en anglais.
+ **DetectEntities-V2** : inspecte le texte clinique de diverses entités médicales et renvoie des informations spécifiques les concernant, telles que la catégorie d'entité, l'emplacement et le score de confiance.
+ **Déduire ICD1 0-CM** : détecte les affections médicales figurant dans le dossier d'un patient sous forme d'entités, et relie ces entités aux identificateurs conceptuels normalisés de la base de connaissances ICD-10-CM du National Center for Health Statistics des CDC, avec l'autorisation de l'Organisation mondiale de la santé (OMS).
+ **InferRxNorm**: Détecte les médicaments en tant qu'entités répertoriées dans le dossier d'un patient et les lie aux identificateurs conceptuels normalisés de la RxNorm base de données de la National Library of Medicine.
Les caractéristiques prises en charge pour chaque opération d'API sont `SIGN``SYMPTOM`, et`DIAGNOSIS`. Si des traits sont détectés, ils sont ajoutés en tant qu'extensions conformes à la norme FHIR à différents emplacements de votre HealthLake banque de données.
**Emplacements où les extensions sont ajoutées.**
+ `DocumentReference`: Les résultats des opérations de l'API Amazon Comprehend Medical sont ajoutés sous forme `extension` de fichier à chaque document trouvé dans `DocumentReference` le type de ressource. Les résultats de l'extension sont divisés en deux groupes. Vous pouvez les trouver dans les résultats en fonction de leurs`URL`.
+ `http://healthlake.amazonaws.com/system-generated-resources/`
+ Il s'agit de types de ressources qui ont été créés ou ajoutés par HealthLake.
+ `http://healthlake.amazonaws.com/aws-cm/`
+ Où le résultat brut des opérations de l'API Amazon Comprehend Medical est ajouté à HealthLake votre magasin de données.
+ `Linkage`: Ce type de ressource est soit ajouté, soit créé grâce au NLP intégré. Une `GET` requête portant sur un sujet spécifique `Linkage` renvoie une liste de ressources liées. Pour savoir si a `Linkage` été ajouté par HealthLake, recherchez la paire `"tag": [{"display": "SYSTEM_GENERATED"}]` clé-valeur ajoutée. Pour en savoir plus sur les spécifications FHIR pour Linkage, consultez [https://hl7.org/fhir/R4/linkage.html](https://hl7.org/fhir/R4/linkage.html)la documentation **FHIR R4**.
+ Types de ressources FHIR générés à la suite des opérations d'Amazon Comprehend Medical.
+ `Observation`: inclut les résultats des `DetectEntities-V2` actions de l'API Amazon Comprehend Medical `InferICD10-CM` et indique quand les caractéristiques `SIGN` sont `SYMPTOM` ou.
+ `Condition`: inclut les résultats des `DetectEntities-V2` actions de l'API Amazon Comprehend Medical `InferICD10-CM` et indique quand le trait `DIAGNOSIS` est.
+ `MedicationStatement`: inclut les résultats des actions de l'API `InferRxNorm` Amazon Comprehend Medical.
# Utilisation des interactions avec l'API REST FHIR
Par défaut, les caractéristiques détectées par les opérations de l'API Amazon Comprehend Medical ne sont pas renvoyées lors `GET` d'une demande. Pour voir les résultats des opérations NLP intégrées, vous devez spécifier une ressource connue `ID` pour les types de ressources FHIR suivants.
+ `Linkage`
+ `Observation`
+ `Condition`
+ `MedicationStatement`
Les résultats des actions NLP HealthLake intégrées en dehors du type de `DocumentReference` ressource sont disponibles à l'aide d'une `GET` requête dont la valeur spécifiée `ID` est connue pour contenir les résultats des opérations de l'API Amazon Comprehend Medical.
# Paramètres de recherche pour le HealthLake NLP intégré
Le tableau suivant répertorie les attributs consultables pour le NLP HealthLake intégré.
**Paramètres de recherche pour le HealthLake NLP**
| Paramètres de recherche | Trouve des correspondances pour |
| --- | --- |
| Détecter ntities-entity-category | Catégorie d'entité au sein de la DetectEntities sous-extension de l'extension AWS CM |
| Détecter ntities-entity-text | Texte de l'entité dans la DetectEntities sous-extension de l'extension AWS CM |
| Détecter ntities-entity-type | Type d'entité dans la DetectEntities sous-extension de l'extension AWS CM |
| Détecter ntities-entity-score | Entity Score au sein de la DetectEntities sous-extension de l'extension AWS CM |
| infer-icd10 cm-entity-text | Texte d'entité dans la sous-extension Infer ICD1 0CM au sein de l'extension CM AWS |
| infer-icd10 cm-entity-score | Score d'entité dans la sous-extension Infer ICD1 0CM au sein de l'extension CM AWS |
| infer-icd10 cm-entity-concept-code | Code de concept d'entité dans la sous-extension Infer ICD1 0CM au sein de l'extension CM AWS |
| infer-icd10 cm-entity-concept-description | Description du concept d'entité dans la sous-extension ICD1 Infer 0CM de l'extension CM AWS |
| infer-icd10 cm-entity-concept-score | Score du concept d'entité dans la sous-extension Infer ICD1 0CM au sein de l'extension CM AWS |
| infer-rxnorm-entity-score | Entity Score au sein de la InferRxNorm sous-extension de l'extension AWS CM |
| infer-rxnorm-entity-text | Texte de l'entité dans la InferRxNorm sous-extension de l'extension AWS CM |
| infer-rxnorm-entity-concept-code | Code de concept d'entité dans la InferRxNorm sous-extension de l'extension AWS CM |
| infer-rxnorm-entity-concept-description | Description du concept d'entité dans la InferRxNorm sous-extension de l'extension AWS CM |
| infer-rxnorm-entity-concept-score | Entity Concept Score au sein de la InferRxNorm sous-extension de l'extension AWS CM |
HealthLake fournit une recherche spéciale pour répondre aux critères lorsque `EntityText` et `EntityCategory` font partie de la même entité. Le tableau suivant décrit les paramètres de recherche spéciaux pris en charge par HealthLake.
**Paramètres de recherche**
| Paramètres de recherche | Allumettes retournées |
| --- | --- |
| Détecter ntities-entity-text-category | S'il existe au moins une entité dans la DetectEntities sous-extension qui correspond à la fois aux entités EntityText et EntityCategory. |
| Détecter ntities-entity-type-score | S'il existe au moins une entité dans la DetectEntities sous-extension qui correspond à la fois à EntityType et à EntityScore. |
| Détecter ntities-entity-text-score | S'il existe au moins une entité dans la DetectEntities sous-extension qui correspond à la fois à EntityText et à EntityScore. |
| Détecter ntities-entity-text-type | S'il existe au moins une entité dans la DetectEntities sous-extension qui correspond à la fois aux entités EntityText et EntityType. |
| Détecter ntities-entity-category-score | S'il existe au moins une entité qui correspond à la fois à EntityCategory et à EntityScore. |
| infer-icd10 -code cm-entity-text-concept | S'il existe au moins une entité dans la sous-extension Infer ICD1 0CM qui correspond à l'EntityText et qu'il existe au moins un ConceptCode pour cette entité qui correspond au code. |
| score de infer-icd10 cm-entity-text-concept | S'il existe au moins une entité dans la sous-extension Infer ICD1 0CM qui correspond au EntityText et qu'il existe au moins un ConceptScore pour cette entité qui correspond au score. |
| infer-icd10 - score conceptuel cm-entity-concept-description | S'il existe au moins un concept dans l'entité de la sous-extension Infer ICD1 0CM qui correspond à la description du concept et au ConceptScore. |
| infer-rxnorm-entity-text-code conceptuel | S'il existe au moins une entité dans la InferRxNorm sous-extension qui correspond à l'EntityText et qu'au moins un ConceptCode pour cette entité correspond au code. |
| infer-rxnorm-entity-text-score conceptuel | S'il existe au moins une entité dans la InferRxNorm sous-extension qui correspond au EntityText et qu'au moins un ConceptScore pour cette entité correspond au score. |
| infer-rxnorm-entity-concept-description-concept-score | S'il existe au moins un concept dans l'entité de la InferRxNorm sous-extension qui correspond à la description du concept et au ConceptScore. |
# HealthLake exemples de demandes NLP intégrées
**Exemple 1 : `Patient` enregistrement ingéré dans un magasin de HealthLake données**
Voici un exemple de note clinique basée sur une `Patient` rencontre avec un professionnel de la santé.
**Données synthétiques**
Le texte de l'exemple suivant est un contenu synthétique et ne contient pas d'informations de santé protégées (PHI).
```
1991-08-31
# Chief Complaint
- Headache
- Sinus Pain
- Nasal Congestion
- Sore Throat
- Pain with Bright Lights
- Nasal Discharge
- Cough
# History of Present Illness
Jerónimo599 is a 4 month-old non-hispanic white male.
# Social History
Patient has never smoked.
Patient comes from a middle socioeconomic background.
Patient currently has Aetna.
# Allergies
No Known Allergies.
# Medications
No Active Medications.
# Assessment and Plan
Patient is presenting with bee venom (substance), mold (organism), house dust mite (organism), animal dander (substance), grass pollen (substance), tree pollen (substance), lisinopril, sulfamethoxazole / trimethoprim, fish (substance).
## Plan
The patient was prescribed the following medications:
- astemizole 10 mg oral tablet
- nda020800 0.3 ml epinephrine 1 mg/ml auto-injector
The patient was placed on a careplan:
- self-care interventions (procedure)
```
Pour rappel, ces informations sont encodées au format base64 dans la `DocumentReference` ressource. Lorsque ce document est intégré HealthLake et que les opérations de l'API Amazon Comprehend Medical sont terminées, pour voir les résultats, vous pouvez commencer par la `GET` demande sur le `DocumentReference` type de ressource.
```
GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/DocumentReference
```
Lorsque les opérations de l'API Amazon Comprehend Medical sont réussies, recherchez ces paires clé-valeur dans `extension` le lien suivant `"url": "http://healthlake.amazonaws.com/aws-cm/"`
```
{
"url": "http://healthlake.amazonaws.com/aws-cm/status/",
"valueString": "SUCCESS"
},
{
"url": "http://healthlake.amazonaws.com/aws-cm/message/",
"valueString": "The AWS HealthLake integrated medical NLP operation was successful."
}
```
Les onglets suivants indiquent comment le dossier médical ingéré est enregistré dans votre banque de HealthLake données en fonction du type de ressource.
------
#### [ DocumentReference ]
Pour voir les résultats pour un seul type de `DocumentReference` ressource, faites une `GET` demande dans laquelle le `id` nom d'une ressource spécifique est fourni.
```
GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/DocumentReference/0e938f03-da7f-4178-acd8-eea9586c46ed
```
En cas de succès, vous obtenez un code de réponse `200` HTTP et la réponse JSON suivante (qui a été tronquée pour plus de clarté).
Voici la `http://healthlake.amazonaws.com/system-generated-resources/` portion. Vous pouvez voir qu'un nouveau `Linkage/e366d29f-2c22-4c19-866e-09603937935a` a été ajouté. Vous pouvez également voir où des résultats basés sur des inférences ont HealthLake été ajoutés à des types `Observation` de `Condition` ressources spécifiques.
Pour voir comment ces types de ressources ont été modifiés, sélectionnez les onglets correspondants.
```
{
"extension": [
{
"url": "http://healthlake.amazonaws.com/linkage",
"valueReference": {
"reference": "Linkage/e366d29f-2c22-4c19-866e-09603937935a"
}
},
{
"url": "http://healthlake.amazonaws.com/nlp-entity",
"valueReference": {
"reference": "Observation/c6e0a3ff-7a17-4d8b-bfd0-d02d7da090c5"
}
},
{
"url": "http://healthlake.amazonaws.com/nlp-entity",
"valueReference": {
"reference": "Condition/0854e1f3-894d-448e-a8d9-3af5b9902baf"
}
}
],
"url": "http://healthlake.amazonaws.com/system-generated-resources/"
}
```
------
#### [ Linkage ]
Pour voir les résultats pour un seul type de `Linkage` ressource, faites une `GET` demande dans laquelle le `ID` nom d'une ressource spécifique est fourni.
```
GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Linkage/e366d29f-2c22-4c19-866e-09603937935a
```
En cas de succès, vous obtenez un code de réponse `200` HTTP et la réponse JSON tronquée suivante.
La réponse contient l'`item`élément. La paire clé-valeur y `"type": "source"` indique l'`DocumentReference`entrée spécifique utilisée pour modifier la `Condition` et `Observations` répertoriée sous la paire `"type": "alternate"` clé-valeur.
*Vous voyez également l'`meta`élément, ainsi que la paire clé-valeur correspondante`"tag": [{"display": "SYSTEM_GENERATED"}]`, indiquant que ces ressources ont été créées par. HealthLake*
```
{
"resourceType": "Linkage",
"id": "e366d29f-2c22-4c19-866e-09603937935a",
"active": true,
"item":
[
{
"type": "alternate",
"resource": {
"reference": "Observation/c6e0a3ff-7a17-4d8b-bfd0-d02d7da090c5",
"type": "Observation"
}
},
{
"type": "alternate",
"resource": {
"reference": "Condition/9d5c1ef6-f822-4faf-b55f-7c70f2a4aa8d",
"type": "Condition"
}
},
{
"type": "source",
"resource": {
"reference": "DocumentReference/0e938f03-da7f-4178-acd8-eea9586c46ed",
"type": "DocumentReference"
}
}
],
"meta": {
"lastUpdated": "2022-10-21T19:38:31.327Z",
"tag": [{
"display": "SYSTEM_GENERATED"
}]
}
}
```
------
#### [ Resource type: Observation ]
Pour voir les résultats pour un seul type de `Observation` ressource, faites une `GET` demande dans laquelle le `ID` nom d'une ressource spécifique est fourni.
```
GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Observation/e366d29f-2c22-4c19-866e-09603937935a
```
Les résultats des opérations de l'API Amazon Comprehend Medical sont modifiés selon les éléments suivants `code` :`meta`, `modifierExtension` et.
**`code`**
Un élément de type`CodeableConcept`. Pour en savoir plus, consultez la [https://hl7.org/fhir/R4/datatypes.html#CodeableConcept](https://hl7.org/fhir/R4/datatypes.html#CodeableConcept)documentation du **FHIR R4**.
HealthLake ajoute les trois paires clé-valeur suivantes.
+ `"system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/"`: où l'URL fait référence à une opération spécifique de l'API Amazon Comprehend Medical. Dans ce cas, inférez ICD1 0 cm.
+ `"code": "A52.06"`: Où se `A52.06` trouve le code ICD-10-CM qui identifie le concept trouvé dans la base de connaissances des Centers for Disease Control.
+ `"display": "Other syphilitic heart involvement"`: Où se `"Other syphilitic heart involvement"` trouve la description détaillée du code ICD-10-CM dans l'ontologie.
La réponse JSON tronquée suivante contient uniquement l'`code`élément.
```
"code": {
"coding":
[
{
"system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/",
"code": "A52.06",
"display": "Other syphilitic heart involvement"
}
],
"text": "Other syphilitic heart involvement"
}
```
Pour comprendre dans quelle mesure le modèle est sûr que le code ICD-10-CM attribué est correct, utilisez l'élément. `modifierExtension`
**`meta`**
L'`meta`élément contient des métadonnées qui indiquent s'il contient des informations ajoutées par les opérations de l'API Amazon Comprehend Medical. `code`
La réponse JSON tronquée suivante contient uniquement l'`meta`élément.
```
"meta": {
"lastUpdated": "2022-10-21T19:38:30.879Z",
"tag": [{
"display": "SYSTEM_GENERATED"
}]
}
```
**`modifierExtension`**
L'`modifierExtension`élément contient plus de détails sur le niveau de confiance des codes assignés trouvés dans l'`code`élément. Il comporte également des paires clé-valeur qui fournissent un lien vers l'original DocumentReference utilisé pour générer les résultats et le type de ressource de liaison associé.
Pour chaque `coding` élément ajouté, vous verrez un `entity-score` et un `entity-Concept-Score` ajoutés à la ModifierExtension. Pour chaque valeur de la paire clé-valeur, vous voyez un score. En effet`entity-score`, ce score correspond au niveau de confiance d'Amazon Comprehend Medical quant à la précision de la détection. En effet`entity-Concept-Score`, ce score est le niveau de confiance d'Amazon Comprehend Medical quant à la précision du lien entre l'entité et un concept ICD-10-CM.
La réponse JSON tronquée suivante contient uniquement l'`modifierExtension`élément.
```
"modifierExtension": [{
"url": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/aws-cm-icd10-entity-score",
"valueDecimal": 0.45005733
},
{
"url": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/aws-cm-icd10-entity-Concept-Score",
"valueDecimal": 0.1111792
},
{
"url": "http://healthlake.amazonaws.com/system-generated-linkage",
"valueReference": {
"reference": "Linkage/e366d29f-2c22-4c19-866e-09603937935a"
}
},
{
"url": "http://healthlake.amazonaws.com/source-document-reference",
"valueReference": {
"reference": "DocumentReference/0e938f03-da7f-4178-acd8-eea9586c46ed"
}
}
]
```
**Réponse JSON complète**
```
{
"subject": {
"reference": "Patient/0679b7b7-937d-488a-b48d-6315b8e7003b"
},
"resourceType": "Observation",
"status": "unknown",
"code": {
"coding": [{
"system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/",
"code": "A52.06",
"display": "Other syphilitic heart involvement"
}],
"text": "Other syphilitic heart involvement"
},
"meta": {
"lastUpdated": "2022-10-21T19:38:30.879Z",
"tag": [{
"display": "SYSTEM_GENERATED"
}]
},
"modifierExtension": [{
"url": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/aws-cm-icd10-entity-score",
"valueDecimal": 0.45005733
},
{
"url": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/aws-cm-icd10-entity-Concept-Score",
"valueDecimal": 0.1111792
},
{
"url": "http://healthlake.amazonaws.com/system-generated-linkage",
"valueReference": {
"reference": "Linkage/e366d29f-2c22-4c19-866e-09603937935a"
}
},
{
"url": "http://healthlake.amazonaws.com/source-document-reference",
"valueReference": {
"reference": "DocumentReference/0e938f03-da7f-4178-acd8-eea9586c46ed"
}
}
],
"id": "7e88c7c5-21a5-4dd7-8fc2-a02474fba583"
}
```
------
#### [ Condition ]
Pour voir les résultats pour un seul type de `Condition` ressource, faites une `GET` demande dans laquelle le `ID` nom d'une ressource spécifique est fourni.
```
GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Condition/b06d343d-ddb8-4f36-82cb-853fcd434dfd
```
Les résultats des opérations de l'API Amazon Comprehend Medical sont modifiés selon les éléments suivants `code` :`meta`, `modifierExtension` et.
**`code`**
Un élément de type`CodeableConcept`. Pour en savoir plus, consultez la [https://hl7.org/fhir/R4/datatypes.html#CodeableConcept](https://hl7.org/fhir/R4/datatypes.html#CodeableConcept)documentation du **FHIR R4**.
HealthLake ajoute les trois paires clé-valeur suivantes.
+ `"system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/"`: où l'URL fait référence à une opération spécifique de l'API Amazon Comprehend Medical. Dans ce cas, inférez ICD1 0 cm.
+ `"code": "I70.0"`: Où se `A52.06` trouve le code ICD-10-CM qui identifie le concept trouvé dans la base de connaissances des Centers for Disease Control.
+ `"display": "Atherosclerosis of aorta"`: Où se `"Other syphilitic heart involvement"` trouve la description détaillée du code ICD-10-CM dans l'ontologie.
La réponse JSON tronquée suivante contient uniquement l'`code`élément.
```
"code": {
"coding":
[
{
"system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/",
"code": "I70.0",
"display": "Atherosclerosis of aorta"
}
],
"text": "Atherosclerosis of aorta"
}
```
Pour comprendre dans quelle mesure le modèle est sûr que le code ICD-10-CM attribué est correct, utilisez l'élément. `modifierExtension`
**`meta`**
L'`meta`élément contient des métadonnées qui indiquent s'il contient des informations ajoutées par les opérations de l'API Amazon Comprehend Medical. `code`
La réponse JSON tronquée suivante contient uniquement l'`meta`élément.
```
"meta": {
"lastUpdated": "2022-10-21T19:38:30.877Z",
"tag": [{
"display": "SYSTEM_GENERATED"
}]
}
```
**`modifierExtension`**
L'`modifierExtension`élément contient plus de détails sur le niveau de confiance des codes assignés trouvés dans l'`code`élément. Il comporte également des paires clé-valeur qui fournissent un lien vers l'original DocumentReference utilisé pour générer les résultats et le type de ressource de liaison associé.
Pour chaque `coding` élément ajouté, vous verrez un `entity-score` et un `entity-Concept-Score` ajoutés à la ModifierExtension. Pour chaque valeur de la paire clé-valeur, vous voyez un score. En effet`entity-score`, ce score correspond au niveau de confiance d'Amazon Comprehend Medical quant à la précision de la détection. En effet`entity-Concept-Score`, ce score est le niveau de confiance d'Amazon Comprehend Medical quant à la précision du lien entre l'entité et un concept ICD-10-CM.
La réponse JSON tronquée suivante contient uniquement l'`modifierExtension`élément.
```
"modifierExtension": [{
"url": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/aws-cm-icd10-entity-score",
"valueDecimal": 0.94417894
},
{
"url": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/aws-cm-icd10-entity-Concept-Score",
"valueDecimal": 0.8458298
},
{
"url": "http://healthlake.amazonaws.com/system-generated-linkage",
"valueReference": {
"reference": "Linkage/e366d29f-2c22-4c19-866e-09603937935a"
}
},
{
"url": "http://healthlake.amazonaws.com/source-document-reference",
"valueReference": {
"reference": "DocumentReference/0e938f03-da7f-4178-acd8-eea9586c46ed"
}
}
]
```
**Réponse JSON complète**
```
{
"subject": {
"reference": "Patient/0679b7b7-937d-488a-b48d-6315b8e7003b"
},
"resourceType": "Condition",
"code": {
"coding": [{
"system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/",
"code": "I70.0",
"display": "Atherosclerosis of aorta"
}],
"text": "Atherosclerosis of aorta"
},
"meta": {
"lastUpdated": "2022-10-21T19:38:30.877Z",
"tag": [{
"display": "SYSTEM_GENERATED"
}]
},
"modifierExtension": [{
"url": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/aws-cm-icd10-entity-score",
"valueDecimal": 0.94417894
},
{
"url": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/aws-cm-icd10-entity-Concept-Score",
"valueDecimal": 0.8458298
},
{
"url": "http://healthlake.amazonaws.com/system-generated-linkage",
"valueReference": {
"reference": "Linkage/e366d29f-2c22-4c19-866e-09603937935a"
}
},
{
"url": "http://healthlake.amazonaws.com/source-document-reference",
"valueReference": {
"reference": "DocumentReference/0e938f03-da7f-4178-acd8-eea9586c46ed"
}
}
],
"id": "b06d343d-ddb8-4f36-82cb-853fcd434dfd"
}
```
------
**Exemple 2 : A `DocumentReference` contenant le type de `MedicationStatement` ressource**
Voici un exemple de note clinique basée sur la rencontre d'un patient avec un professionnel de santé.
**Données synthétiques**
Le texte de cet exemple est un contenu synthétique et ne contient pas d'informations de santé protégées (PHI).
```
Tom is not prescribed Advil
```
Les onglets suivants montrent comment le dossier médical ingéré est enregistré dans votre banque de HealthLake données en fonction du type de ressource.
------
#### [ DocumentReference ]
Pour voir les résultats pour un seul type de `DocumentReference` ressource, faites une `GET` demande dans laquelle le `ID` nom d'une ressource spécifique est fourni.
```
GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/DocumentReference/c549125d-a218-421f-b8bf-23614c5e796c
```
En cas de succès, vous obtenez un code de réponse `200` HTTP et la réponse JSON tronquée suivante.
La paire clé-valeur indique que les `"url": "http://healthlake.amazonaws.com/system-generated-resources/"` types de ressources qu'elle contient `extension` ont été ajoutés par les opérations de l'API Amazon Comprehend Medical. Vous pouvez voir le nouveau type de `Linkage` ressource et plusieurs `MedicationStatement` ressources.
```
"extension": [{
"extension": [{
"url": "http://healthlake.amazonaws.com/linkage",
"valueReference": {
"reference": "Linkage/394bb244-177b-4409-8657-26b20ed56dd7"
}
},
{
"url": "http://healthlake.amazonaws.com/nlp-entity",
"valueReference": {
"reference": "MedicationStatement/cbf6af10-b0b9-451c-bdde-99611e3498a8"
}
},
{
"url": "http://healthlake.amazonaws.com/nlp-entity",
"valueReference": {
"reference": "MedicationStatement/9a89b0d3-6681-45ca-9926-27951edce5c7"
}
},
{
"url": "http://healthlake.amazonaws.com/nlp-entity",
"valueReference": {
"reference": "MedicationStatement/4a01f6c8-5f3a-4122-80ab-405312f96aa2"
}
},
{
"url": "http://healthlake.amazonaws.com/nlp-entity",
"valueReference": {
"reference": "MedicationStatement/fbfb77d8-70cf-4579-b4c0-d6fe3c01656b"
}
},
{
"url": "http://healthlake.amazonaws.com/nlp-entity",
"valueReference": {
"reference": "MedicationStatement/1340c9ce-9c48-4bf9-9b2f-d0ab027f5e0b"
}
}
],
"url": "http://healthlake.amazonaws.com/system-generated-resources/"
}
```
------
#### [ Linkage ]
Pour voir les résultats pour un seul type de `Linkage` ressource, faites une `GET` demande dans laquelle le `ID` nom d'une ressource spécifique est fourni.
```
GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Linkage/394bb244-177b-4409-8657-26b20ed56dd7
```
En cas de succès, vous obtenez un code de réponse `200` HTTP et la réponse JSON suivante.
La réponse contient l'`item`élément. La paire clé-valeur y `"type": "source"` indique l'`DocumentReference`entrée spécifique utilisée pour modifier les types de `MedicationStatement` ressources.
Vous pouvez également voir l'`meta`élément et une paire clé-valeur correspondante`"tag": [{"display": "SYSTEM_GENERATED"}]`, indiquant que ces ressources ont été créées par. HealthLake
```
{
"resourceType": "Linkage",
"id": "394bb244-177b-4409-8657-26b20ed56dd7",
"active": true,
"item": [{
"type": "alternate",
"resource": {
"reference": "MedicationStatement/cbf6af10-b0b9-451c-bdde-99611e3498a8",
"type": "MedicationStatement"
}
},
{
"type": "alternate",
"resource": {
"reference": "MedicationStatement/9a89b0d3-6681-45ca-9926-27951edce5c7",
"type": "MedicationStatement"
}
},
{
"type": "alternate",
"resource": {
"reference": "MedicationStatement/4a01f6c8-5f3a-4122-80ab-405312f96aa2",
"type": "MedicationStatement"
}
},
{
"type": "alternate",
"resource": {
"reference": "MedicationStatement/fbfb77d8-70cf-4579-b4c0-d6fe3c01656b",
"type": "MedicationStatement"
}
},
{
"type": "alternate",
"resource": {
"reference": "MedicationStatement/1340c9ce-9c48-4bf9-9b2f-d0ab027f5e0b",
"type": "MedicationStatement"
}
},
{
"type": "source",
"resource": {
"reference": "DocumentReference/c549125d-a218-421f-b8bf-23614c5e796c",
"type": "DocumentReference"
}
}
],
"meta": {
"lastUpdated": "2022-10-24T20:05:03.501Z",
"tag": [{
"display": "SYSTEM_GENERATED"
}]
}
}
```
------
#### [ MedicationStatement ]
Pour voir les résultats pour un seul type de `MedicationStatement` ressource, faites une `GET` demande dans laquelle le `ID` nom d'une ressource spécifique est fourni.
```
GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/MedicationStatement/9a89b0d3-6681-45ca-9926-27951edce5c7
```
Le type de `MedicationStatement` ressource correspond à l'endroit où se trouvent les résultats de l'opération d'API Amazon Comprehend InferRxNorm Medical. Les résultats sont modifiés selon les éléments suivants : `medicationCodeableConcept``meta`, et`modifierExtension`.
**medicationCodeableConcept**
Un élément de type`CodeableConcept`. Pour en savoir plus, consultez la [https://hl7.org/fhir/R4/datatypes.html#CodeableConcept](https://hl7.org/fhir/R4/datatypes.html#CodeableConcept)documentation du **FHIR R4**.
HealthLake ajoute les trois paires clé-valeur suivantes.
+ `"system": ""http://healthlake.amazonaws.com/aws-cm/infer-rxnorm/`: où l'URL fait référence à une opération spécifique de l'API Amazon Comprehend Medical. Dans ce cas, InferRxNorm.
+ `"code": "731533"`: Où se `731533` trouve un identifiant de RxNorm concept, également connu sous le nom de RxCUI.
+ `"display": "ibuprofen 200 MG Oral Capsule [Advil]"`: Où se `ibuprofen 200 MG Oral Capsule [Advil]` trouve la description du RxNorm concept.
La réponse JSON tronquée suivante contient uniquement l'`MedicationStatement`élément.
```
"medicationCodeableConcept": {
"coding": [
{
"system": "http://healthlake.amazonaws.com/aws-cm/infer-rxnorm/",
"code": "731533",
"display": "ibuprofen 200 MG Oral Capsule [Advil]"
}
]
}
```
**`meta`**
L'`meta`élément contient des métadonnées qui indiquent s'il contient des informations ajoutées par les opérations de l'API Amazon Comprehend Medical. `code`
La réponse JSON tronquée suivante contient uniquement l'`meta`élément.
```
"meta": {
"lastUpdated": "2022-10-24T20:05:02.800Z",
"tag": [
{
"display": "SYSTEM_GENERATED"
}
]
}
```
**`modifierExtension`**
L'`modifierExtension`élément contient des paires clé-valeur qui fournissent un lien vers l'original `DocumentReference` utilisé pour générer les résultats et le type de ressource de liaison associé.
```
"modifierExtension": [
{
"url": "http://healthlake.amazonaws.com/system-generated-linkage",
"valueReference": {
"reference": "Linkage/394bb244-177b-4409-8657-26b20ed56dd7"
}
},
{
"url": "http://healthlake.amazonaws.com/source-document-reference",
"valueReference": {
"reference": "DocumentReference/c549125d-a218-421f-b8bf-23614c5e796c"
}
}
]
```
------