Inicio rápido: Uso del modelo de buscador de coincidencias de prueba
En este inicio rápido se proporciona información general sobre cómo usar el buscador de coincidencias de prueba.
Requisitos previos
Para usar el buscador de coincidencias de prueba, debe tener creada una cuenta de servicios de Azure AI creada. Si aún no ha creado una cuenta de servicios de Azure AI, consulte Implementar Análisis prospectivo de estado de Azure AI mediante Azure Portal.
Una vez completada la implementación, use Azure Portal para ir a la cuenta de servicios de Azure AI recién creada para ver los detalles, incluida la dirección URL del servicio. La dirección URL del servicio para acceder al servicio es: https://YOUR-NAME.cognitiveservices.azure.com/.
Enviar una solicitud y obtener resultados
Para enviar una solicitud de API, necesita el punto de conexión y la clave de su cuenta de servicios de Azure AI.
Importante
El buscador de coincidencias de prueba es una API asincrónica. La predicción del buscador de coincidencias de prueba se realiza al recibir la solicitud de API y los resultados se devuelven 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 indica 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
Para enviar una solicitud al buscador de coincidencias de prueba, debe realizar una solicitud POST al punto de conexión.
En el ejemplo siguiente, los pacientes coinciden con el origen Clinicaltrials_gov, para una condición lung cancer con ubicaciones de instalaciones para la ciudad Orlando.
PUT https://{your-cognitive-service-endpoint}/health-insights/trial-matcher/jobs/id?api-version=2024-08-01-preview
Content-Type: application/json
Ocp-Apim-Subscription-Key: {your-cognitive-services-api-key}
{
"Configuration": {
"ClinicalTrials": {
"RegistryFilters": [
{
"Sources": [
"Clinicaltrials_gov"
],
"Conditions": ["lung cancer"],
"facilityLocations": [
{
"State": "FL",
"City": "Orlando",
"countryOrRegion": "United States"
}
]
}
]
},
"IncludeEvidence": false,
"Verbose": false
},
"Patients": [
{
"Info": {
"sex": "female",
"birthDate": "01/01/1987",
"ClinicalInfo": [
]
},
"id": "12"
}
]
}
También puede encontrar una vista completa de los parámetros de solicitud aquí.
La respuesta incluye la ubicación de la operación en el encabezado de respuesta. El valor tiene un aspecto similar a la siguiente dirección URL: https://eastus.api.cognitive.microsoft.com/healthinsights/trialmatcher/jobs/b58f3776-c6cb-4b19-a5a7-248a0d9481ff?api_version=2022-01-01-preview
Respuesta de ejemplo
Para obtener los resultados de la solicitud, realice la siguiente solicitud GET a la dirección URL especificada en el encabezado de ubicación de la operación de respuesta POST.
GET https://{your-cognitive-service-endpoint}/healthinsights/trialmatcher/jobs/{job-id}?api-version=2022-01-01-preview
Content-Type: application/json
Ocp-Apim-Subscription-Key: {your-cognitive-services-api-key}
Una respuesta de ejemplo:
{
"results": {
"patients": [
{
"id": "12",
"inferences": [
{
"type": "trialEligibility",
"id": "NCT03318939",
"source": "clinicaltrials.gov",
"value": "Eligible"
},
{
"type": "trialEligibility",
"id": "NCT03417882",
"source": "clinicaltrials.gov",
"value": "Eligible"
},
{
"type": "trialEligibility",
"id": "NCT02628067",
"source": "clinicaltrials.gov",
"value": "Eligible"
},
{
"type": "trialEligibility",
"id": "NCT04948554",
"source": "clinicaltrials.gov",
"value": "Eligible"
},
{
"type": "trialEligibility",
"id": "NCT04616924",
"source": "clinicaltrials.gov",
"value": "Eligible"
},
{
"type": "trialEligibility",
"id": "NCT04504916",
"source": "clinicaltrials.gov",
"value": "Eligible"
},
{
"type": "trialEligibility",
"id": "NCT02635009",
"source": "clinicaltrials.gov",
"value": "Eligible"
},
...
],
"neededClinicalInfo": [
{
"system": "http://www.nlm.nih.gov/research/umls",
"code": "METASTATIC",
"name": "metastatic"
},
{
"semanticType": "T000",
"system": "http://www.nlm.nih.gov/research/umls",
"code": "C0032961",
"name": "Pregnancy"
},
{
"semanticType": "T000",
"system": "http://www.nlm.nih.gov/research/umls",
"code": "C1512162",
"name": "Eastern Cooperative Oncology Group"
}
]
}
],
"modelVersion": "2022.03.24",
"knowledgeGraphLastUpdateDate": "2022.03.29"
},
"jobId": "26484d27-f5d7-4c74-a078-a359d1634a63",
"createdDateTime": "2022-04-04T16:56:00Z",
"expirationDateTime": "2022-04-04T17:56:00Z",
"lastUpdateDateTime": "2022-04-04T16:56:00Z",
"status": "succeeded"
}
También puede encontrar una vista completa de los parámetros de respuesta aquí.
Límites de datos
| Límite | Valor |
|---|---|
| Número máximo de pacientes por solicitud | 1 |
| Número máximo de pruebas por paciente | 5000 |
| Número máximo de filtro de ubicación por solicitud | 1 |
Pasos siguientes
Para obtener una mejor información sobre la solicitud y las respuestas, lea más en estas páginas: