Início Rápido: use o modelo Trial Matcher
Este início rápido fornece uma visão geral sobre como usar o Trial Matcher.
Pré-requisitos
Para usar o Trial Matcher, você deve ter uma conta dos serviços de IA do Azure criada. Se você ainda não criou uma conta dos serviços de IA do Azure, confira Implantar as Informações de Integridade de IA do Azure usando o portal do Azure.
Após a implantação ter sido concluída, use o portal do Azure para navegar até a conta dos serviços de IA do Azure recém-criada e ver os detalhes, incluindo o URL do seu Serviço. A URL do serviço para acessar seu serviço é: https://YOUR-NAME.cognitiveservices.azure.com/.
Enviar uma solicitação e receber os resultados
Para enviar uma solicitação de API, você precisa do ponto de extremidade e da chave da sua conta dos serviços de IA do Azure.
Importante
O Trial Matcher é uma API assíncrona. A previsão do Trial Matcher é realizada após o recebimento da solicitação de API e os resultados são retornados de forma assíncrona. Os resultados da API estão disponíveis por 24 horas a partir do momento em que a solicitação foi ingerida e é indicada na resposta. Após esse período, os resultados são eliminados e não estão mais disponíveis para recuperação.
Solicitação de exemplo
Para enviar uma solicitação para o Trial Matcher, você precisa fazer uma solicitação POST para o ponto de extremidade.
No exemplo abaixo, os pacientes correspondem à fonte Clinicaltrials_gov, para uma condição lung cancer com locais de instalação para a cidade 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"
}
]
}
Você também pode encontrar uma exibição completa dos parâmetros de solicitação aqui
A resposta inclui o local da operação no cabeçalho da resposta. O valor parece semelhante à seguinte URL: https://eastus.api.cognitive.microsoft.com/healthinsights/trialmatcher/jobs/b58f3776-c6cb-4b19-a5a7-248a0d9481ff?api_version=2022-01-01-preview
Resposta de exemplo
Para obter os resultados da solicitação, faça a seguinte solicitação GET para a URL especificada no cabeçalho de localização da operação de resposta 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}
Um exemplo de resposta:
{
"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"
}
Você também pode encontrar uma exibição completa dos parâmetros de resposta aqui
Limites de dados
| Limite | Valor |
|---|---|
| Número máximo de pacientes por solicitação | 1 |
| Máximo de # ensaios por paciente | 5.000 |
| Máximo de # filtro de local por solicitação | 1 |
Próximas etapas
Para obter os melhores insights sobre a solicitação e as respostas, leia mais nas páginas a seguir: