翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # HealthLake の統合自然言語処理 (NLP) AWS HealthLake は、FHIR [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)リソースタイプに保存されている非構造化データを解析、識別、マッピングするための統合された自然言語処理 (NLP) ライブラリを提供します。 **[重要]** HealthLake の統合 NLP はデフォルトでオフになっています。有効にするには、 を使用してサポートケースを送信します[AWS Support Center Console](https://console.aws.amazon.com/support/home#/)。ケースを作成するには、 にログイン AWS アカウント し、**ケースの作成**を選択します。 HealthLake 統合 NLP は、Amazon Comprehend Medical `DetectEntities-V2`、`InferICD10-CM`、および `InferRxNorm` API アクションを呼び出すことで機能します。アクションは、結果を`DocumentReference`リソースの拡張機能として追加します。Amazon Comprehend Medical API アクションが `SIGN`、`SYMPTOM`、および/または である特性を検出すると`DIAGNOSIS`、FHIR [https://hl7.org/fhir/R4/linkage.html](https://hl7.org/fhir/R4/linkage.html)リソースが生成されます。新しい `Condition` および `Observation`リソースは、`SIGN`、、または の特性で識別されたエンティティから作成`DIAGNOSIS`され`SYMPTOM`、`Linkage`リソースを使用してソースドキュメントにリンクされます。 **注記** HealthLake 統合 NLP によって生成された FHIR リソースでは`GET`リクエストがサポートされていますが、FHIR API `search`機能はサポートされていません。HealthLake と Athena の統合を使用した NLP 拡張機能の検索の詳細については、「」を参照してください[SQL インデックスとクエリ](integrating-athena.md)。 **Contents** + [HealthLake 統合 NLP ライブラリ](med-example.md) + [FHIR REST API インタラクションの使用](nlp-rest-api.md) + [HealthLake 統合 NLP の検索パラメータ](search-parameters-med.md) + [HealthLake 統合 NLP リクエストの例](cm-api-results.md) # HealthLake 統合 NLP ライブラリ HealthLake は、Amazon Comprehend Medical ライブラリを使用して`DocumentReference`、リソースタイプで見つかったデータを推測します。Amazon Comprehend Medical API オペレーション `DetectEntities-V2`、`InferICD10-CM`、 は、病状を*特性*として`InferRxNorm`検出します。オペレーションごとに異なるインサイトが得られます。 **言語サポート** Amazon Comprehend Medical API オペレーションは、英語テキストの医療エンティティのみを検出します。 + **DetectEntities-V2**: さまざまな医療エンティティの臨床テキストを検査し、エンティティカテゴリ、場所、信頼スコアなど、それらに関する特定の情報を返します。 + **InferICD10-CM**: 患者レコード内の病状をエンティティとして検出し、世界保健機関 (WHO) の承認の下で、CDC の National Center for Health Statistics から ICD-10-CM ナレッジベースの正規化された概念識別子にそれらのエンティティをリンクします。 + **InferRxNorm**: 患者レコードにリストされているエンティティとして薬剤を検出し、国立医学図書館の RxNorm データベース内の正規化された概念識別子にリンクします。 各 API オペレーションでサポートされている特性は、`SIGN`、`SYMPTOM`、および です`DIAGNOSIS`。特性が検出されると、それらは HealthLake データストア内の異なる場所に FHIR 準拠の拡張機能として追加されます。 **拡張機能が追加される場所。** + `DocumentReference`: Amazon Comprehend Medical API オペレーションの結果は、`DocumentReference`リソースタイプ内の各ドキュメント`extension`に として追加されます。拡張機能の結果は 2 つのグループに分割されます。これらは、 に基づいて結果で確認できます`URL`。 + `http://healthlake.amazonaws.com/system-generated-resources/` + これらは、HealthLake によって作成または追加されたリソースタイプです。 + `http://healthlake.amazonaws.com/aws-cm/` + ここで、Amazon Comprehend Medical API オペレーションの raw 出力が HealthLake データストアに追加されます。 + `Linkage`: このリソースタイプは、統合された NLP の結果として追加または作成されます。特定の に対する`GET`リクエストは、リンクされたリソースのリスト`Linkage`を返します。`Linkage` が HealthLake によって追加されたかどうかを確認するには、追加された`"tag": [{"display": "SYSTEM_GENERATED"}]`キーと値のペアを探します。Linkage の FHIR 仕様の詳細については、**FHIR R4 ドキュメント**[https://hl7.org/fhir/R4/linkage.html](https://hl7.org/fhir/R4/linkage.html)の「」を参照してください。 + Amazon Comprehend Medical オペレーションの結果として生成された FHIR リソースタイプ。 + `Observation`: には、Amazon Comprehend Medical API アクションの結果`DetectEntities-V2`と、特性が `SIGN`または `InferICD10-CM`の場合が含まれます`SYMPTOM`。 + `Condition`: には、Amazon Comprehend Medical API アクションの結果`DetectEntities-V2`と、特性が `InferICD10-CM`の場合の結果が含まれます`DIAGNOSIS`。 + `MedicationStatement`: には、Amazon Comprehend Medical API アクション の結果が含まれます`InferRxNorm`。 # FHIR REST API インタラクションの使用 デフォルトでは、Amazon Comprehend Medical API オペレーションによって検出された特性は、`GET`リクエストの実行時に返されません。統合された NLP オペレーションの結果を表示するには、次の FHIR リソースタイプ`ID`に既知の を指定する必要があります。 + `Linkage` + `Observation` + `Condition` + `MedicationStatement` `DocumentReference` リソースタイプ外の HealthLake 統合 NLP アクションの結果は、指定された `ID` に Amazon Comprehend Medical API オペレーションの結果が含まれていることがわかっている`GET`リクエストを使用して使用できます。 # HealthLake 統合 NLP の検索パラメータ 次の表に、HealthLake 統合 NLP の検索可能な属性を示します。 **HealthLake NLP の検索パラメータ** | 検索パラメータ | の一致を検索します | | --- | --- | | detectEntities-entity-category | CM 拡張機能内の DetectEntities AWS サブ拡張機能内のエンティティカテゴリ | | detectEntities-entity-text | CM 拡張機能内の DetectEntities AWS サブ拡張機能内のエンティティテキスト | | detectEntities-entity-type | CM 拡張機能内の DetectEntities AWS サブ拡張機能内のエンティティタイプ | | detectEntities-entity-score | CM 拡張機能内の DetectEntities AWS サブ拡張機能内のエンティティスコア | | infer-icd10cm-entity-text | AWS CM 拡張機能内の InferICD10CM サブ拡張内のエンティティテキスト | | infer-icd10cm-entity-score | AWS CM 拡張内の InferICD10CM サブ拡張内のエンティティスコア | | infer-icd10cm-entity-concept-code | AWS CM 拡張機能内の InferICD10CM サブ拡張機能内のエンティティ概念コード | | infer-icd10cm-entity-concept-description | CM 拡張機能内の InferICD10CM サブ拡張機能内の AWS エンティティ概念の説明 | | infer-icd10cm-entity-concept-score | AWS CM 拡張機能内の InferICD10CM サブ拡張機能内のエンティティ概念スコア | | infer-rxnorm-entity-score | AWS CM 拡張機能内の InferRxNorm サブ拡張内のエンティティスコア | | infer-rxnorm-entity-text | AWS CM 拡張機能内の InferRxNorm サブ拡張内のエンティティテキスト | | infer-rxnorm-entity-concept-code | AWS CM 拡張機能内の InferRxNorm サブ拡張内のエンティティ概念コード | | infer-rxnorm-entity-concept-description | CM 拡張機能内の InferRxNorm サブ拡張内の AWS エンティティ概念の説明 | | infer-rxnorm-entity-concept-score | AWS CM 拡張機能内の InferRxNorm サブ拡張内のエンティティ概念スコア | HealthLake は、 `EntityText`と が同じエンティティの一部`EntityCategory`である条件に一致するように特別な検索を提供します。次の表は、HealthLake でサポートされている特別な検索パラメータを示しています。 **検索パラメータ** | 検索パラメータ | 返される一致 | | --- | --- | | detectEntities-entity-text-category | DetectEntities サブ拡張機能に entityText と entityCategory の両方に一致するエンティティが少なくとも 1 つある場合。 | | detectEntities-entity-type-score | DetectEntities サブ拡張機能に entityType と entityScore の両方に一致するエンティティが少なくとも 1 つある場合。 | | detectEntities-entity-text-score | DetectEntities サブ拡張機能に entityText と entityScore の両方に一致するエンティティが少なくとも 1 つある場合。 | | detectEntities-entity-text-type | DetectEntities サブ拡張機能に entityText と entityType の両方に一致するエンティティが少なくとも 1 つある場合。 | | detectEntities-entity-category-score | entityCategory と entityScore の両方に一致するエンティティが少なくとも 1 つある場合。 | | infer-icd10cm-entity-text-concept-code | InferICD10CM サブ拡張に entityText に一致するエンティティが少なくとも 1 つあり、そのエンティティのコードに一致する conceptCode が少なくとも 1 つある場合。 entityText | | infer-icd10cm-entity-text-concept-score | InferICD10CM サブ拡張に entityText に一致するエンティティが少なくとも 1 つあり、そのエンティティの conceptScore がスコアに一致するエンティティが少なくとも 1 つある場合。 entityText | | infer-icd10cm-entity-concept-description-concept-score | InferICD10CM サブ拡張のエンティティ内に、概念の説明と conceptScore に一致する概念が少なくとも 1 つある場合。 conceptScore | | infer-rxnorm-entity-text-concept-code | InferRxNorm サブ拡張に entityText に一致するエンティティが少なくとも 1 つあり、そのエンティティのコードに一致する conceptCode が少なくとも 1 つある場合。 entityText | | infer-rxnorm-entity-text-concept-score | InferRxNorm サブ拡張機能に entityText に一致するエンティティが少なくとも 1 つあり、そのエンティティにスコアに一致する conceptScore が少なくとも 1 つある場合。 entityText | | infer-rxnorm-entity-concept-description-concept-score | InferRxNorm サブ拡張のエンティティ内に、概念の説明と conceptScore に一致する概念が少なくとも 1 つある場合。 | # HealthLake 統合 NLP リクエストの例 **例 1: HealthLake データストアに取り込まれた`Patient`レコード** 以下は、医療専門家との`Patient`遭遇に基づく臨床記録の例です。 **合成データ** 次の例のテキストは合成コンテンツであり、保護された医療情報 (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) ``` 注意点として、この情報は `DocumentReference`リソースの base64 形式でエンコードされます。このドキュメントが HealthLake に取り込まれ、Amazon Comprehend Medical API オペレーションが完了すると、結果を表示するには、`DocumentReference`リソースタイプの`GET`リクエストから開始できます。 ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/DocumentReference ``` Amazon Comprehend Medical API オペレーションが成功したら、以下`extension`にリンクされた 内でこれらのキーと値のペアを探します。 `"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." } ``` 次のタブは、リソースタイプに基づいて、取り込まれた医療記録が HealthLake データストアにどのように報告されるかを示しています。 ------ #### [ DocumentReference ] 単一の`DocumentReference`リソースタイプの結果を表示するには、特定のリソース`id`の が提供されている`GET`リクエストを行います。 ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/DocumentReference/0e938f03-da7f-4178-acd8-eea9586c46ed ``` 成功すると、`200`HTTP レスポンスコードと次の JSON レスポンス (わかりやすくするために切り捨てられています) を取得します。 以下にその`http://healthlake.amazonaws.com/system-generated-resources/`部分を示します。新しい `Linkage/e366d29f-2c22-4c19-866e-09603937935a` が追加されたことを確認できます。また、HealthLake が特定の `Observation`および`Condition`リソースタイプに推論ベースの検出結果を追加した場所を確認することもできます。 これらのリソースタイプがどのように修正されたかを確認するには、関連するタブを選択します。 ``` { "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 ] 単一の`Linkage`リソースタイプの結果を表示するには、特定のリソース`ID`の が提供されている`GET`リクエストを行います。 ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Linkage/e366d29f-2c22-4c19-866e-09603937935a ``` 成功すると、HTTP `200` レスポンスコードと、次の切り捨てられた JSON レスポンスを取得します。 レスポンスには `item`要素が含まれています。キーと値のペアは、 の変更に使用され、`"type": "alternate"`キー`Condition`と値のペアの下に`Observations`リストされている特定の`DocumentReference`エントリ`"type": "source"`を示します。 *また、 `meta`要素、およびこれらのリソースが HealthLake によって作成された`"tag": [{"display": "SYSTEM_GENERATED"}]`ことを示す対応するキーと値のペア も表示されます。* ``` { "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 ] 単一の`Observation`リソースタイプの結果を表示するには、特定のリソース`ID`の が提供されている`GET`リクエストを行います。 ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Observation/e366d29f-2c22-4c19-866e-09603937935a ``` Amazon Comprehend Medical API オペレーションの結果は`code`、、`meta`、および の要素に変更されます`modifierExtension`。 **`code`** タイプの 要素`CodeableConcept`。詳細については、**FHIR R4 ドキュメント**[https://hl7.org/fhir/R4/datatypes.html#CodeableConcept](https://hl7.org/fhir/R4/datatypes.html#CodeableConcept)の「」を参照してください。 HealthLake は、次の 3 つのキーと値のペアを追加します。 + `"system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/"`: URL は特定の Amazon Comprehend Medical API オペレーションを参照します。この場合、InferICD10CM。 + `"code": "A52.06"`: `A52.06`は、Centers for Disease Control のナレッジベースにある概念を識別する ICD-10-CM コードです。 + `"display": "Other syphilitic heart involvement"`: `"Other syphilitic heart involvement"`はオントロジー内の ICD-10-CM コードの長い説明です。 次の切り捨てられた JSON レスポンスには、 `code`要素のみが含まれます。 ``` "code": { "coding": [ { "system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/", "code": "A52.06", "display": "Other syphilitic heart involvement" } ], "text": "Other syphilitic heart involvement" } ``` 割り当てられた ICD-10-CM コードが正しいというモデルの信頼度を理解するには、 `modifierExtension`要素を使用します。 **`meta`** `meta` 要素には、Amazon Comprehend Medical API オペレーションによって追加された詳細が`code`要素に含まれているかどうかを示すメタデータが含まれています。 次の切り捨てられた JSON レスポンスには、 `meta`要素のみが含まれます。 ``` "meta": { "lastUpdated": "2022-10-21T19:38:30.879Z", "tag": [{ "display": "SYSTEM_GENERATED" }] } ``` **`modifierExtension`** `modifierExtension` 要素には、 `code`要素で見つかった割り当てられたコードの信頼度に関する詳細が含まれます。また、結果の生成に使用される元の DocumentReference へのリンクと関連する Linkage リソースタイプを提供するキーと値のペアもあります。 追加される`coding`要素ごとに、modifierExtension に `entity-score`と `entity-Concept-Score`が追加されます。キーと値のペアの値ごとに、スコアが表示されます。の場合`entity-score`、このスコアは Amazon Comprehend Medical が検出の精度に対して持っている信頼度です。の場合`entity-Concept-Score`、このスコアは、エンティティが ICD-10-CM 概念に正確にリンクされているという Amazon Comprehend Medical の信頼度です。 次の切り捨てられた JSON レスポンスには、 `modifierExtension`要素のみが含まれます。 ``` "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" } } ] ``` **完全な JSON レスポンス** ``` { "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 ] 単一の`Condition`リソースタイプの結果を表示するには、特定のリソース`ID`の が提供されている`GET`リクエストを行います。 ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Condition/b06d343d-ddb8-4f36-82cb-853fcd434dfd ``` Amazon Comprehend Medical API オペレーションの結果は`code`、、`meta`、および の要素に変更されます`modifierExtension`。 **`code`** タイプの 要素`CodeableConcept`。詳細については、**FHIR R4 ドキュメント**[https://hl7.org/fhir/R4/datatypes.html#CodeableConcept](https://hl7.org/fhir/R4/datatypes.html#CodeableConcept)の「」を参照してください。 HealthLake は、次の 3 つのキーと値のペアを追加します。 + `"system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/"`: URL は特定の Amazon Comprehend Medical API オペレーションを参照します。この場合、InferICD10CM。 + `"code": "I70.0"`: `A52.06`は、Centers for Disease Control のナレッジベースにある概念を識別する ICD-10-CM コードです。 + `"display": "Atherosclerosis of aorta"`: `"Other syphilitic heart involvement"`はオントロジー内の ICD-10-CM コードの長い説明です。 次の切り捨てられた JSON レスポンスには、 `code`要素のみが含まれます。 ``` "code": { "coding": [ { "system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/", "code": "I70.0", "display": "Atherosclerosis of aorta" } ], "text": "Atherosclerosis of aorta" } ``` 割り当てられた ICD-10-CM コードが正しいというモデルの信頼度を理解するには、 `modifierExtension`要素を使用します。 **`meta`** `meta` 要素には、Amazon Comprehend Medical API オペレーションによって追加された詳細が`code`要素に含まれているかどうかを示すメタデータが含まれています。 次の切り捨てられた JSON レスポンスには、 `meta`要素のみが含まれます。 ``` "meta": { "lastUpdated": "2022-10-21T19:38:30.877Z", "tag": [{ "display": "SYSTEM_GENERATED" }] } ``` **`modifierExtension`** `modifierExtension` 要素には、 `code`要素で見つかった割り当てられたコードの信頼度に関する詳細が含まれます。また、結果の生成に使用される元の DocumentReference へのリンクと関連する Linkage リソースタイプを提供するキーと値のペアもあります。 追加される`coding`要素ごとに、modifierExtension に `entity-score`と `entity-Concept-Score`が追加されます。キーと値のペアの値ごとに、スコアが表示されます。の場合`entity-score`、このスコアは Amazon Comprehend Medical が検出の精度に対して持っている信頼度です。の場合`entity-Concept-Score`、このスコアは、エンティティが ICD-10-CM 概念に正確にリンクされているという Amazon Comprehend Medical の信頼度です。 次の切り捨てられた JSON レスポンスには、 `modifierExtension`要素のみが含まれます。 ``` "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" } } ] ``` **完全な JSON レスポンス** ``` { "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" } ``` ------ **例 2: `MedicationStatement`リソースタイプ`DocumentReference`を含む ** 以下は、患者の医療専門家との出会いに基づく臨床メモの例です。 **合成データ** この例のテキストは合成コンテンツであり、保護された医療情報 (PHI) は含まれていません。 ``` Tom is not prescribed Advil ``` 次のタブは、リソースタイプに基づいて、取り込まれた医療記録が HealthLake データストアにどのように報告されるかを示しています。 ------ #### [ DocumentReference ] 単一の`DocumentReference`リソースタイプの結果を表示するには、特定のリソース`ID`の が提供されている`GET`リクエストを行います。 ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/DocumentReference/c549125d-a218-421f-b8bf-23614c5e796c ``` 成功すると、HTTP `200` レスポンスコードと、次の切り捨てられた JSON レスポンスを取得します。 キーと値のペア は`"url": "http://healthlake.amazonaws.com/system-generated-resources/"`、この中のリソースタイプ`extension`が Amazon Comprehend Medical API オペレーションによって追加されたことを示します。新しい`Linkage`リソースタイプと複数の`MedicationStatement`リソースを表示できます。 ``` "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 ] 単一の`Linkage`リソースタイプの結果を表示するには、特定のリソース`ID`の が提供されている`GET`リクエストを行います。 ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Linkage/394bb244-177b-4409-8657-26b20ed56dd7 ``` 成功すると、HTTP `200` レスポンスコードと次の JSON レスポンスを取得します。 レスポンスには `item`要素が含まれています。キーと値のペアは、`MedicationStatement`リソースタイプの変更に使用される特定の`DocumentReference`エントリ`"type": "source"`を示します。 また、 `meta`要素と対応するキーと値のペア を表示して`"tag": [{"display": "SYSTEM_GENERATED"}]`、これらのリソースが 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 ] 単一の`MedicationStatement`リソースタイプの結果を表示するには、特定のリソース`ID`の が提供されている`GET`リクエストを行います。 ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/MedicationStatement/9a89b0d3-6681-45ca-9926-27951edce5c7 ``` `MedicationStatement` リソースタイプは、Amazon Comprehend Medical InferRxNorm API オペレーションの結果が見つかった場所です。結果は、、`medicationCodeableConcept`、`meta`および の要素に修正されます`modifierExtension`。 **medicationCodeableConcept** タイプの 要素`CodeableConcept`。詳細については、**FHIR R4 ドキュメント**[https://hl7.org/fhir/R4/datatypes.html#CodeableConcept](https://hl7.org/fhir/R4/datatypes.html#CodeableConcept)の「」を参照してください。 HealthLake は、次の 3 つのキーと値のペアを追加します。 + `"system": ""http://healthlake.amazonaws.com/aws-cm/infer-rxnorm/`: URL は特定の Amazon Comprehend Medical API オペレーションを参照します。この場合、InferRxNorm。 + `"code": "731533"`: `731533`は、RxCUI とも呼ばれる RxNorm 概念 ID です。 RxCUI + `"display": "ibuprofen 200 MG Oral Capsule [Advil]"`: ここで、 `ibuprofen 200 MG Oral Capsule [Advil]`は RxNorm 概念の説明です。 次の切り捨てられた JSON レスポンスには、 `MedicationStatement`要素のみが含まれます。 ``` "medicationCodeableConcept": { "coding": [ { "system": "http://healthlake.amazonaws.com/aws-cm/infer-rxnorm/", "code": "731533", "display": "ibuprofen 200 MG Oral Capsule [Advil]" } ] } ``` **`meta`** `meta` 要素には、Amazon Comprehend Medical API オペレーションによって追加された詳細が`code`要素に含まれているかどうかを示すメタデータが含まれています。 次の切り捨てられた JSON レスポンスには、 `meta`要素のみが含まれます。 ``` "meta": { "lastUpdated": "2022-10-24T20:05:02.800Z", "tag": [ { "display": "SYSTEM_GENERATED" } ] } ``` **`modifierExtension`** `modifierExtension` 要素には、結果の生成`DocumentReference`に使用される元の および関連する Linkage リソースタイプへのリンクを提供するキーと値のペアが含まれています。 ``` "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" } } ] ``` ------