在健康状况文本分析中使用快速医疗保健互操作性资源 (FHIR) 结构化处理

使用健康状况文本分析处理非结构化数据时,可以请求输出响应包括快速医疗保健互操作性资源 (FHIR) 资源捆绑包。 通过将 FHIR 版本作为每个请求中选项的一部分传递来启用 FHIR 资源捆绑包输出。 传递 FHIR 版本的方式因使用的是 SDK 还是 REST API 而有所不同。

使用 REST API

如果将 REST API 作为生成请求有效负载的一部分,将包含 Task 对象。 每个任务都可以设置参数。 参数选项之一是 fhirVersion。 通过在 Task 对象参数中包含 fhirVersion 参数,除了常规的健康状况文本分析输出之外,还可以请求输出包括 FHIR 资源捆绑包。 以下示例演示了如何在请求参数中包含 fhirVersion

{
      "analysis input": {
            "documents:"[
                {
                text:"54 year old patient had pain in the left elbow with no relief from 100 mg Ibuprofen",
                "language":"en",
                "id":"1"
                }
            ]
        },
    "tasks"[
       {
       "taskId":"analyze 1",
       "kind":"Healthcare",
       "parameters":
            {
            "fhirVersion":"4.0.1"
            }
        }
    ]
}

在请求已完成健康状况文本分析处理并从 REST API 拉取响应后,将在输出中找到 FHIR 资源捆绑包。 可以在使用属性名称 fhirBundle 处理的每个文档中找到 FHIR 资源捆绑包。 以下部分示例是突出显示 fhirBundle 的输出。

{
  "jobID":"50d11b05-7a03-a611-6f1e95ebde07",
  "lastUpdatedDateTime":"2024-06-05T17:29:51Z",
  "createdDateTime:"2024-06-05T17:29:40Z",
  "expirationDateTime":"2024-06-05T17:29:40Z",
  "status":"succeeded",
  "errors":[],
  "tasks":{
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
        {
          "kind":"HealthcareLROResults",
          "lastUpdatedDateTime":"2024-06-05T17:29:51.5839858Z",
          "status":"succeeded",
          "results": {
              "documents": [
                  {
                    "id": "1",
                    "entities": [...
                    ],
                    "relations": [...
                    ].
                    "warnings":[],
                    "fhirBundle": {
                        "resourceType": "Bundle",
                        "id": "b4d907ed-0334-4186-9e21-8ed4d79e709f",
                        "meta": {
                            "profile": [
                                "http://hl7.org/fhir/4.0.1/StructureDefinition/Bundle"
                                  ]
                                },  

使用 REST SDK

还可以使用 SDK 提出健康状况文本分析请求,以在输出中包含 FHIR 资源捆绑包。 若要使用 SDK 完成此请求,需要创建 AnalyzeHealthcareEntitiesOptions 实例,并使用 FHIR 版本填充 FhirVersion 属性。 然后,将此选项对象传递给每个 StartAnalyzeHealthcareEntitiesAsync 方法调用,配置请求以在输出中包含 FHIR 资源捆绑包。

后续步骤