As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Processamento de linguagem natural (NLP) integrado para HealthLake AWS HealthLake fornece bibliotecas integradas de processamento de linguagem natural (NLP) para analisar, identificar e mapear dados não estruturados armazenados em tipos de recursos [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)FHIR. **Importante** A PNL integrada para HealthLake está desativada por padrão. Para ativá-lo, envie um caso de suporte usando [AWS Support Center Console](https://console.aws.amazon.com/support/home#/). Para criar seu caso, faça login no seu Conta da AWS e escolha **Criar caso**. HealthLake A PNL integrada funciona chamando as ações Amazon Comprehend `DetectEntities-V2` Medical `InferICD10-CM` e API. `InferRxNorm` As ações anexam seus resultados como uma extensão ao `DocumentReference` recurso. Quando as ações da API Amazon Comprehend Medical detectam características que são`SIGN`, e/ou `SYMPTOM``DIAGNOSIS`, elas geram um recurso FHIR. [https://hl7.org/fhir/R4/linkage.html](https://hl7.org/fhir/R4/linkage.html) `Observation`Recursos novos `Condition` e são criados a partir de entidades identificadas com as características de `SIGN``SYMPTOM`,, ou `DIAGNOSIS` e são vinculados ao documento de origem usando o `Linkage` recurso. **nota** Embora as `GET` solicitações sejam suportadas para recursos FHIR gerados pela PNL HealthLake integrada, a funcionalidade da API FHIR não é. `search` Para saber mais sobre como pesquisar extensões de PNL usando a integração com HealthLake o Athena, consulte. [Índice e consulta SQL](integrating-athena.md) **Contents** + [HealthLake Bibliotecas de PNL integradas](med-example.md) + [Usando interações da API FHIR REST](nlp-rest-api.md) + [Parâmetros de pesquisa para HealthLake PNL integrada](search-parameters-med.md) + [HealthLake exemplos de solicitações de PNL integradas](cm-api-results.md) # HealthLake Bibliotecas de PNL integradas HealthLake infere dados encontrados no tipo de `DocumentReference` recurso usando as bibliotecas Amazon Comprehend Medical. *A API Amazon Comprehend Medical opera e `InferRxNorm` detecta `DetectEntities-V2` condições `InferICD10-CM` médicas como características.* Cada operação fornece informações diferentes. **Suporte a idiomas** As operações da API Amazon Comprehend Medical só detectam entidades médicas em textos em inglês. + **DetectEntities-V2**: inspeciona o texto clínico de uma variedade de entidades médicas e retorna informações específicas sobre elas, como categoria da entidade, localização e pontuação de confiança. + **Inferir ICD1 0-CM**: Detecta condições médicas em um prontuário de paciente como entidades e vincula essas entidades a identificadores de conceitos normalizados na base de conhecimento CID-10-CM do National Center for Health Statistics do CDC, sob autorização da Organização Mundial da Saúde (OMS). + **InferRxNorm**: Detecta medicamentos como entidades listadas em um prontuário de paciente e os vincula aos identificadores de conceitos normalizados no RxNorm banco de dados da National Library of Medicine. As características suportadas para cada operação de API são `SIGN``SYMPTOM`, `DIAGNOSIS` e. Se características forem detectadas, elas serão adicionadas como extensões compatíveis com FHIR em diferentes locais em seu armazenamento de dados. HealthLake **Locais onde as extensões são adicionadas.** + `DocumentReference`: Os resultados das operações da API Amazon Comprehend Medical são adicionados como um `extension` a cada documento encontrado dentro do tipo de recurso. `DocumentReference` Os resultados da extensão são divididos em dois grupos. Você pode encontrá-los nos resultados com base em seus`URL`. + `http://healthlake.amazonaws.com/system-generated-resources/` + Esses são tipos de recursos que foram criados ou adicionados por HealthLake. + `http://healthlake.amazonaws.com/aws-cm/` + Onde a saída bruta das operações da API Amazon Comprehend Medical é adicionada ao seu armazenamento de dados. HealthLake + `Linkage`: esse tipo de recurso é adicionado ou criado como resultado da PNL integrada. Uma `GET` solicitação em um específico `Linkage` retorna uma lista de recursos vinculados. Para identificar se a `Linkage` foi adicionado por HealthLake, procure o par de `"tag": [{"display": "SYSTEM_GENERATED"}]` valores-chave adicionados. Para saber mais sobre as especificações do FHIR para o Linkage, consulte [https://hl7.org/fhir/R4/linkage.html](https://hl7.org/fhir/R4/linkage.html)a documentação do **FHIR** R4. + Tipos de recursos FHIR gerados como resultado das operações do Amazon Comprehend Medical. + `Observation`: inclui resultados das ações da API Amazon Comprehend Medical `DetectEntities-V2` e `InferICD10-CM` quando as características são ou. `SIGN` `SYMPTOM` + `Condition`: inclui resultados das ações da API Amazon Comprehend Medical `DetectEntities-V2` e `InferICD10-CM` quando a característica é. `DIAGNOSIS` + `MedicationStatement`: inclui resultados das ações da API Amazon Comprehend Medical. `InferRxNorm` # Usando interações da API FHIR REST Por padrão, as características detectadas pelas operações da API Amazon Comprehend Medical não são retornadas ao fazer uma solicitação. `GET` Para ver os resultados das operações integradas de PNL, você deve especificar um conhecido `ID` para os seguintes tipos de recursos do FHIR. + `Linkage` + `Observation` + `Condition` + `MedicationStatement` Os resultados das ações HealthLake integradas de PNL fora do tipo de `DocumentReference` recurso estão disponíveis por meio de uma `GET` solicitação em que `ID` se sabe que o especificado contém resultados das operações da API Amazon Comprehend Medical. # Parâmetros de pesquisa para HealthLake PNL integrada A tabela a seguir lista os atributos pesquisáveis para a PNL HealthLake integrada. **Parâmetros de pesquisa para HealthLake PNL** | Parâmetros de pesquisa | Encontra correspondências para | | --- | --- | | Detecte ntities-entity-category | Categoria de entidade dentro da DetectEntities subextensão dentro da extensão AWS CM | | Detecte ntities-entity-text | Texto da entidade dentro da DetectEntities subextensão dentro da extensão AWS CM | | Detecte ntities-entity-type | Tipo de entidade dentro da DetectEntities subextensão dentro da extensão AWS CM | | Detecte ntities-entity-score | Pontuação da entidade dentro da DetectEntities subextensão dentro da extensão AWS CM | | infer-icd10 cm-entity-text | Texto da entidade dentro da subextensão Infer ICD1 0CM dentro da extensão CM AWS | | infer-icd10 cm-entity-score | Pontuação da entidade dentro da subextensão Infer ICD1 0CM dentro da extensão CM AWS | | infer-icd10 cm-entity-concept-code | Código de conceito de entidade dentro da subextensão Infer ICD1 0CM dentro da extensão CM AWS | | infer-icd10 cm-entity-concept-description | Descrição do conceito de entidade dentro da subextensão Infer ICD1 0CM dentro da extensão CM AWS | | infer-icd10 cm-entity-concept-score | Pontuação do conceito de entidade na subextensão Infer ICD1 0CM na extensão CM AWS | | infer-rxnorm-entity-score | Pontuação da entidade dentro da InferRxNorm subextensão dentro da extensão AWS CM | | infer-rxnorm-entity-text | Texto da entidade dentro da InferRxNorm subextensão dentro da extensão AWS CM | | infer-rxnorm-entity-concept-código | Código de conceito de entidade dentro da InferRxNorm subextensão dentro da extensão AWS CM | | infer-rxnorm-entity-concept-descrição | Descrição do conceito de entidade dentro da InferRxNorm subextensão dentro da extensão AWS CM | | infer-rxnorm-entity-concept-pontuação | Pontuação do conceito de entidade dentro da InferRxNorm subextensão dentro da extensão AWS CM | HealthLake fornece uma pesquisa especial para corresponder aos critérios em que `EntityText` e `EntityCategory` fazem parte da mesma entidade. A tabela a seguir descreve os parâmetros de pesquisa especiais suportados pelo HealthLake. **Parâmetros de pesquisa** | Parâmetros de pesquisa | Partidas devolvidas | | --- | --- | | Detecte ntities-entity-text-category | Se houver pelo menos uma entidade na DetectEntities subextensão que corresponda tanto à EntityText quanto à EntityCategory. | | Detecte ntities-entity-type-score | Se houver pelo menos uma entidade na DetectEntities subextensão que corresponda ao entityType e ao entityScore. | | Detecte ntities-entity-text-score | Se houver pelo menos uma entidade na DetectEntities subextensão que corresponda tanto ao EntityText quanto ao EntityScore. | | Detecte ntities-entity-text-type | Se houver pelo menos uma entidade na DetectEntities subextensão que corresponda tanto ao EntityText quanto ao EntityType. | | Detecte ntities-entity-category-score | Se houver pelo menos uma entidade que corresponda tanto à EntityCategory quanto à EntityScore. | | código cm-entity-text-concept infer-icd10 | Se houver pelo menos uma entidade na subextensão Infer ICD1 0CM que corresponda ao EntityText e houver pelo menos um ConceptCode para essa entidade que corresponda ao código. | | infer-icd10 - pontuação cm-entity-text-concept | Se houver pelo menos uma entidade na subextensão Infer ICD1 0CM que corresponda ao EntityText e houver pelo menos um ConceptScore para essa entidade que corresponda à pontuação. | | cm-entity-concept-descriptioninfer-icd10 - pontuação conceitual | Se houver pelo menos um conceito dentro da entidade na subextensão Infer ICD1 0CM que corresponda à descrição do conceito e ao ConceptScore. | | infer-rxnorm-entity-text-código conceitual | Se houver pelo menos uma entidade na InferRxNorm subextensão que corresponda ao EntityText e houver pelo menos um ConceptCode para essa entidade que corresponda ao código. | | infer-rxnorm-entity-text-pontuação conceitual | Se houver pelo menos uma entidade na InferRxNorm subextensão que corresponda ao EntityText e houver pelo menos um ConceptScore para essa entidade que corresponda à pontuação. | | infer-rxnorm-entity-concept-description-concept-score | Se houver pelo menos um conceito dentro da entidade na InferRxNorm subextensão que corresponda à descrição do conceito e ao ConceptScore. | # HealthLake exemplos de solicitações de PNL integradas **Exemplo 1: `Patient` registro ingerido em um armazenamento de HealthLake dados** A seguir está um exemplo de uma nota clínica baseada em um `Patient` encontro com um profissional de saúde. **Dados sintéticos** O texto no exemplo a seguir é conteúdo sintético e não contém informações de saúde protegidas (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) ``` Como lembrete, essas informações são codificadas no formato base64 no recurso. `DocumentReference` Quando esse documento é inserido HealthLake e as operações da API Amazon Comprehend Medical são concluídas, para ver os resultados, você pode começar com a solicitação sobre `GET` o tipo de recurso. `DocumentReference` ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/DocumentReference ``` Quando as operações da API Amazon Comprehend Medical forem bem-sucedidas, procure esses pares de valores-chave nos links a seguir `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." } ``` As guias a seguir mostram como o prontuário médico ingerido é relatado em seu armazenamento de HealthLake dados com base no tipo de recurso. ------ #### [ DocumentReference ] Para ver os resultados de um único tipo de `DocumentReference` recurso, faça uma `GET` solicitação em que o `id` de um recurso específico seja fornecido. ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/DocumentReference/0e938f03-da7f-4178-acd8-eea9586c46ed ``` Quando bem-sucedido, você recebe um código de resposta `200` HTTP e a seguinte resposta JSON (que foi truncada para maior clareza). Aqui está a `http://healthlake.amazonaws.com/system-generated-resources/` porção. Você pode ver que um novo `Linkage/e366d29f-2c22-4c19-866e-09603937935a` foi adicionado. Você também pode ver onde HealthLake foram adicionadas descobertas baseadas em inferências a tipos específicos `Observation` e de `Condition` recursos. Para ver como esses tipos de recursos foram alterados, escolha as guias relacionadas. ``` { "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 ] Para ver os resultados de um único tipo de `Linkage` recurso, faça uma `GET` solicitação em que o `ID` de um recurso específico seja fornecido. ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Linkage/e366d29f-2c22-4c19-866e-09603937935a ``` Quando bem-sucedido, você recebe um código de resposta `200` HTTP e a seguinte resposta JSON truncada. A resposta contém o `item` elemento. Nele, o par de valores-chave `"type": "source"` indica a `DocumentReference` entrada específica usada para modificar `Condition` e `Observations` listada sob o par de `"type": "alternate"` valores-chave. *Você também vê o `meta` elemento e um par de valores-chave correspondente`"tag": [{"display": "SYSTEM_GENERATED"}]`, indicando que esses recursos foram criados por. 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 ] Para ver os resultados de um único tipo de `Observation` recurso, faça uma `GET` solicitação em que o `ID` de um recurso específico seja fornecido. ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Observation/e366d29f-2c22-4c19-866e-09603937935a ``` Os resultados das operações da API Amazon Comprehend Medical são alterados para os seguintes elementos:`code`,, e. `meta` `modifierExtension` **`code`** Um elemento do tipo`CodeableConcept`. Para saber mais, consulte a [https://hl7.org/fhir/R4/datatypes.html#CodeableConcept](https://hl7.org/fhir/R4/datatypes.html#CodeableConcept)documentação do **FHIR R4**. HealthLake acrescenta os três pares de valores-chave a seguir. + `"system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/"`: onde o URL se refere a uma operação específica da API Amazon Comprehend Medical. Nesse caso, inferir ICD1 0CM. + `"code": "A52.06"`: Onde `A52.06` está o código ICD-10-CM que identifica o conceito encontrado na base de conhecimento dos Centros de Controle de Doenças. + `"display": "Other syphilitic heart involvement"`: Onde `"Other syphilitic heart involvement"` está a descrição longa do código ICD-10-CM na ontologia. A resposta JSON truncada a seguir contém somente o elemento. `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" } ``` Para entender a confiança do modelo de que o código ICD-10-CM atribuído está correto, use o elemento. `modifierExtension` **`meta`** O `meta` elemento contém metadados que indicam se o `code` elemento contém detalhes que foram adicionados pelas operações da API Amazon Comprehend Medical. A resposta JSON truncada a seguir contém somente o elemento. `meta` ``` "meta": { "lastUpdated": "2022-10-21T19:38:30.879Z", "tag": [{ "display": "SYSTEM_GENERATED" }] } ``` **`modifierExtension`** O `modifierExtension` elemento contém mais detalhes sobre o nível de confiança dos códigos atribuídos encontrados no `code` elemento. Ele também tem pares de valores-chave que fornecem um link para o original DocumentReference usado para gerar os resultados e o tipo de recurso Linkage relacionado. Para cada `coding` elemento adicionado, você verá um `entity-score` e um `entity-Concept-Score` adicionados à ModifierExtension. Para cada valor no par de valores-chave, você vê uma pontuação. Pois`entity-score`, essa pontuação é o nível de confiança que o Amazon Comprehend Medical tem na precisão da detecção. Pois`entity-Concept-Score`, essa pontuação é o nível de confiança que o Amazon Comprehend Medical tem de que a entidade está vinculada com precisão a um conceito do ICD-10-CM. A resposta JSON truncada a seguir contém somente o elemento. `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" } } ] ``` **Resposta JSON completa** ``` { "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 ] Para ver os resultados de um único tipo de `Condition` recurso, faça uma `GET` solicitação em que o `ID` de um recurso específico seja fornecido. ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Condition/b06d343d-ddb8-4f36-82cb-853fcd434dfd ``` Os resultados das operações da API Amazon Comprehend Medical são alterados para os seguintes elementos:`code`,, e. `meta` `modifierExtension` **`code`** Um elemento do tipo`CodeableConcept`. Para saber mais, consulte a [https://hl7.org/fhir/R4/datatypes.html#CodeableConcept](https://hl7.org/fhir/R4/datatypes.html#CodeableConcept)documentação do **FHIR R4**. HealthLake acrescenta os três pares de valores-chave a seguir. + `"system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/"`: onde o URL se refere a uma operação específica da API Amazon Comprehend Medical. Nesse caso, inferir ICD1 0CM. + `"code": "I70.0"`: Onde `A52.06` está o código ICD-10-CM que identifica o conceito encontrado na base de conhecimento dos Centros de Controle de Doenças. + `"display": "Atherosclerosis of aorta"`: Onde `"Other syphilitic heart involvement"` está a descrição longa do código ICD-10-CM na ontologia. A resposta JSON truncada a seguir contém somente o elemento. `code` ``` "code": { "coding": [ { "system": "http://healthlake.amazonaws.com/aws-cm/infer-icd10/", "code": "I70.0", "display": "Atherosclerosis of aorta" } ], "text": "Atherosclerosis of aorta" } ``` Para entender a confiança do modelo de que o código ICD-10-CM atribuído está correto, use o elemento. `modifierExtension` **`meta`** O `meta` elemento contém metadados que indicam se o `code` elemento contém detalhes que foram adicionados pelas operações da API Amazon Comprehend Medical. A resposta JSON truncada a seguir contém somente o elemento. `meta` ``` "meta": { "lastUpdated": "2022-10-21T19:38:30.877Z", "tag": [{ "display": "SYSTEM_GENERATED" }] } ``` **`modifierExtension`** O `modifierExtension` elemento contém mais detalhes sobre o nível de confiança dos códigos atribuídos encontrados no `code` elemento. Ele também tem pares de valores-chave que fornecem um link para o original DocumentReference usado para gerar os resultados e o tipo de recurso Linkage relacionado. Para cada `coding` elemento adicionado, você verá um `entity-score` e um `entity-Concept-Score` adicionados à ModifierExtension. Para cada valor no par de valores-chave, você vê uma pontuação. Pois`entity-score`, essa pontuação é o nível de confiança que o Amazon Comprehend Medical tem na precisão da detecção. Pois`entity-Concept-Score`, essa pontuação é o nível de confiança que o Amazon Comprehend Medical tem de que a entidade está vinculada com precisão a um conceito do ICD-10-CM. A resposta JSON truncada a seguir contém somente o elemento. `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" } } ] ``` **Resposta JSON completa** ``` { "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" } ``` ------ **Exemplo 2: A `DocumentReference` que contém o tipo `MedicationStatement` de recurso** Aqui está um exemplo de uma nota clínica baseada no encontro de um paciente com um profissional médico. **Dados sintéticos** O texto neste exemplo é conteúdo sintético e não contém informações de saúde protegidas (PHI). ``` Tom is not prescribed Advil ``` As guias a seguir mostram como o prontuário médico ingerido é relatado em seu armazenamento de HealthLake dados com base no tipo de recurso. ------ #### [ DocumentReference ] Para ver os resultados de um único tipo de `DocumentReference` recurso, faça uma `GET` solicitação em que o `ID` de um recurso específico seja fornecido. ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/DocumentReference/c549125d-a218-421f-b8bf-23614c5e796c ``` Quando bem-sucedido, você recebe um código de resposta `200` HTTP e a seguinte resposta JSON truncada. O par de valores-chave,`"url": "http://healthlake.amazonaws.com/system-generated-resources/"`, indica que os tipos de recursos dentro dele `extension` foram adicionados pelas operações da API Amazon Comprehend Medical. Você pode ver o novo tipo de `Linkage` recurso e vários `MedicationStatement` recursos. ``` "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 ] Para ver os resultados de um único tipo de `Linkage` recurso, faça uma `GET` solicitação em que o `ID` de um recurso específico seja fornecido. ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/Linkage/394bb244-177b-4409-8657-26b20ed56dd7 ``` Em caso de sucesso, você recebe um código de resposta `200` HTTP e a seguinte resposta JSON. A resposta contém o `item` elemento. Nele, o par de valores-chave `"type": "source"` indica a `DocumentReference` entrada específica usada para modificar os tipos de `MedicationStatement` recursos. Você também pode ver o `meta` elemento e um par de valores-chave correspondente`"tag": [{"display": "SYSTEM_GENERATED"}]`, indicando que esses recursos foram criados por. 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 ] Para ver os resultados de um único tipo de `MedicationStatement` recurso, faça uma `GET` solicitação em que o `ID` de um recurso específico seja fornecido. ``` GET https://https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/eeb8005725ae22b35b4edbdc68cf2dfd/r4/MedicationStatement/9a89b0d3-6681-45ca-9926-27951edce5c7 ``` O tipo de `MedicationStatement` recurso é onde os resultados da operação da InferRxNorm API Amazon Comprehend Medical são encontrados. Os resultados são alterados para os seguintes elementos: `medicationCodeableConcept``meta`, `modifierExtension` e. **medicationCodeableConcept** Um elemento do tipo`CodeableConcept`. Para saber mais, consulte a [https://hl7.org/fhir/R4/datatypes.html#CodeableConcept](https://hl7.org/fhir/R4/datatypes.html#CodeableConcept)documentação do **FHIR R4**. HealthLake acrescenta os três pares de valores-chave a seguir. + `"system": ""http://healthlake.amazonaws.com/aws-cm/infer-rxnorm/`: onde o URL se refere a uma operação específica da API Amazon Comprehend Medical. Nesse caso, InferRxNorm. + `"code": "731533"`: Onde `731533` está um ID de RxNorm conceito, também conhecido como RxCUI. + `"display": "ibuprofen 200 MG Oral Capsule [Advil]"`: Onde `ibuprofen 200 MG Oral Capsule [Advil]` está a descrição do RxNorm conceito. A resposta JSON truncada a seguir contém somente o elemento. `MedicationStatement` ``` "medicationCodeableConcept": { "coding": [ { "system": "http://healthlake.amazonaws.com/aws-cm/infer-rxnorm/", "code": "731533", "display": "ibuprofen 200 MG Oral Capsule [Advil]" } ] } ``` **`meta`** O `meta` elemento contém metadados que indicam se o `code` elemento contém detalhes que foram adicionados pelas operações da API Amazon Comprehend Medical. A resposta JSON truncada a seguir contém somente o elemento. `meta` ``` "meta": { "lastUpdated": "2022-10-24T20:05:02.800Z", "tag": [ { "display": "SYSTEM_GENERATED" } ] } ``` **`modifierExtension`** O `modifierExtension` elemento contém pares de valores-chave que fornecem um link para o original `DocumentReference` usado para gerar os resultados e o tipo de recurso Linkage relacionado. ``` "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" } } ] ``` ------