Inicio rápido: Uso del modelo de Radiology Insights
En este inicio rápido se proporciona información general sobre cómo usar Radiology Insights.
Requisitos previos
Para usar el modelo de Radiology Insights (versión preliminar), debe tener un servicio Azure AI Health Insights creado.
Si no tiene ningún servicio Azure AI Health Insights, consulte Implementación de Azure AI Health Insights mediante Azure Portal.
Una vez completada la implementación, use Azure Portal para ir al servicio Azure AI Health Insights recién creado para ver los detalles, incluida la dirección URL del servicio.
La dirección URL para acceder a su servicio es: https://YOUR-NAME.cognitiveservices.azure.com/.
Ejemplo de solicitud y resultados
Para enviar una solicitud de API, necesita el punto de conexión y la clave del servicio Azure AI Health Insights.
También puede encontrar una vista completa de los parámetros de solicitud aquí.
Importante
La predicción se realiza al recibir la solicitud de API y los resultados se devolverán de forma asincrónica. Los resultados de la API están disponibles durante 24 horas desde el momento en que se ingirió la solicitud y se indican en la respuesta. Después de este período de tiempo, los resultados se purgan y ya no están disponibles para la recuperación.
Solicitud de ejemplo
Nota:
Los ejemplos siguientes se basan en la versión de API: 2024-04-01. Es posible que haya cambios entre versiones de API. Para obtener una versión específica de la API, use la referencia a la API de REST para ver la descripción completa.
A partir de una solicitud que contiene un caso
Puede usar los datos de este ejemplo para probar la primera solicitud al modelo de Radiology Insights.
Definición {jobid}
- identificador único
- máximo de 36 caracteres
- sin espacios
PUT
https://{cognitive-services-account-endpoint}/health-insights/radiology-insights/jobs/{jobid}?api-version=2024-04-01
Content-Type: application/json
Ocp-Apim-Subscription-Key: {cognitive-services-account-key}
{
"jobData": {
"configuration": {
"inferenceOptions": {
"followupRecommendationOptions": {
"includeRecommendationsWithNoSpecifiedModality": false,
"includeRecommendationsInReferences": false,
"provideFocusedSentenceEvidence": false
},
"findingOptions": {
"provideFocusedSentenceEvidence": false
}
},
"inferenceTypes": ["lateralityDiscrepancy"],
"locale": "en-US",
"verbose": false,
"includeEvidence": false
},
"patients": [
{
"id": "111111",
"details": {
"sex": "female",
"birthDate" : "1986-07-01T21:00:00+00:00",
"clinicalInfo": [
{
"resourceType": "Observation",
"status": "unknown",
"code": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls",
"code": "C0018802",
"display": "MalignantNeoplasms"
}
]
},
"valueBoolean": "true"
}
]
},
"encounters": [
{
"id": "encounterid1",
"period": {
"start": "2021-8-28T00:00:00",
"end": "2021-8-28T00:00:00"
},
"class": "inpatient"
}
],
"patientDocuments": [
{
"type": "note",
"clinicalType": "radiologyReport",
"id": "docid1",
"language": "en",
"authors": [
{
"id": "authorid1",
"fullName": "authorname1"
}
],
"specialtyType": "radiology",
"createdAt": "2021-8-28T00:00:00",
"administrativeMetadata": {
"orderedProcedures": [
{
"code": {
"coding": [
{
"system": "Https://loinc.org",
"code": "26688-1",
"display": "US BREAST - LEFT LIMITED"
}
]
},
"description": "US BREAST - LEFT LIMITED"
}
],
"encounterId": "encounterid1"
},
"content": {
"sourceType": "inline",
"value" : "Exam: US LT BREAST TARGETED\r\n\r\nTechnique: Targeted imaging of the right breast is performed.\r\n\r\nFindings:\r\n\r\nTargeted imaging of the left breast is performed from the 6:00 to the 9:00 position. \r\n\r\nAt the 6:00 position, 5 cm from the nipple, there is a 3 x 2 x 4 mm minimally hypoechoic mass with a peripheral calcification. This may correspond to the mammographic finding. No other cystic or solid masses visualized.\r\n"
}
}
]
}
]
}
}
También puede encontrar una vista completa de los parámetros de solicitud aquí.
Evaluación de una respuesta que contiene un caso
Para obtener el estado del trabajo, envíe una solicitud al modelo de Radiology Insights y agregue el identificador de trabajo de la solicitud inicial a la dirección URL.
Fragmento de código de ejemplo:
GET
https://{cognitive-services-account-endpoint}/health-insights/radiology-insights/jobs/{jobid}?api-version=2024-04-01
Ocp-Apim-Subscription-Key: {cognitive-services-account-key}
{
"result": {
"patientResults": [
{
"patientId": "11111",
"inferences": [
{
"kind": "lateralityDiscrepancy",
"lateralityIndication": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "24028007",
"display": "RIGHT (QUALIFIER VALUE)"
}
]
},
"discrepancyType": "orderLateralityMismatch"
}
]
}
]
},
"id": "jobid",
"createdDateTime": "2023-12-18T12:25:37.8942771Z",
"expirationDateTime": "2023-12-18T12:42:17.8942771Z",
"lastUpdateDateTime": "2023-12-18T12:25:49.7221986Z",
"status": "succeeded"
}
También puede encontrar una vista completa de los parámetros de solicitud aquí.
Límites de datos
Límite, valor
- N.º máximo de pacientes por solicitud, 1
- N.º máximo de documentos de pacientes por solicitud, 1
- N.º máximo de encuentros por solicitud, 1
- N.º máximo de caracteres por paciente, 50 000 para datos[i].content.value combinados
Validación de solicitudes
Todas las solicitudes contienen campos obligatorios y opcionales que se deben rellenar para al modelo de Radiology Insights. Al enviar datos al modelo, asegúrese de tener en cuenta las siguientes propiedades:
Dentro de una solicitud:
- se deben establecer pacientes
- los pacientes deben contener una entrada
- se debe establecer el identificador cuando se especifiquen los pacientes
En la configuración: si se establece, la configuración regional debe ser uno de los siguientes valores (sin distinción entre mayúsculas y minúsculas):
- en-CA
- en-US
- en-AU
- en-DE
- en-IE
- en-NZ
- en-GB
En los pacientes:
- debe contener una entrada patientDocument
- se debe establecer el identificador en patientDocument
- si se usan los encuentros o la información, se debe establecer el identificador
Para patientDocuments en un paciente:
- debe establecerse createdDateTime (serviceDate)
- El idioma del documento del paciente debe ser EN (sin distinción entre mayúsculas y minúsculas)
- documentType debe ser igual a note (no distingue mayúsculas de minúsculas)
- El documento del paciente clinicalType debe establecerse como radiologyReport o pathologyReport (sin distinción entre mayúsculas y minúsculas, en una sola palabra)
- el valor de specialtyType en el documento del paciente debe ser radiología o patología
- si se establece orderedProcedures en administrativeMetadata, debe contener código (con código y visualización) y descripción
- el contenido del documento no debe estar en blanco o vacío ni ser nulo
Opcional: sex y birthDate son campos opcionales.
"patientDocuments" : [ {
"type" : "note",
"clinicalType" : "radiologyReport",
"id" : "docid1",
"language" : "en",
"authors" : [ {
"id" : "authorid1",
"name" : "authorname1"
} ],
"specialtyType" : "radiology",
"createdDateTime" : "2021-8-28T00:00:00",
"administrativeMetadata" : {
"orderedProcedures" : [ {
"code" : {
"coding" : [ {
"system" : "Https://loinc.org",
"code" : "41806-1",
"display" : "CT ABDOMEN"
} ]
},
"description" : "CT ABDOMEN"
} ],
"encounterId" : "encounterid1"
},
"content" : {
"sourceType" : "inline",
"value" : "CT ABDOMEN AND PELVIS\n\nProvided history: \n78 years old Female\nAbnormal weight loss\n\nTechnique: Routine protocol helical CT of the abdomen and pelvis were performed after the injection of intravenous nonionic iodinated contrast. Axial, Sagittal and coronal 2-D reformats were obtained. Oral contrast was also administered.\n\nFindings:\nLimited evaluation of the included lung bases demonstrates no evidence of abnormality. \n\nGallbladder is absent. "
}
} ]
Pasos siguientes
Para obtener mejor información sobre la solicitud y las respuestas, puede leer más en las páginas siguientes: