使用健康状况文本分析处理非结构化数据时,可以请求输出响应包括快速医疗保健互操作性资源 (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 资源捆绑包。