Configuração do modelo Trial Matcher
O Trial Matcher inclui um grafo de conhecimento integrado, que usa ensaios obtidos de clinicaltrials.gov e está sendo atualizado periodicamente.
Quando você está correspondendo pacientes com ensaios, você pode definir uma lista de filtros para consultar um subconjunto de ensaios clínicos. Cada filtro pode ser definido com base em trial conditions, types, recruitment statuses, sponsors, phases, purposes, facility names, locations,ou trial IDs.
- A especificação de vários valores para a mesma categoria de filtro resulta em um conjunto de ensaios clínicos que é uma união dos dois conjuntos.
Observação
Os exemplos deste artigo são baseados na versão da API: 2023-03-01-preview. Poderá haver alterações entre as versões de API. No caso de uma versão específica de API, use a referência à API REST para ver a descrição completa.
Na seguinte configuração, o modelo consulta os ensaios que estão em status de recrutamento recruiting ou not yet recruiting.
"recruitmentStatuses": ["recruiting", "notYetRecruiting"]
- A especificação de várias categorias de filtro resulta em um conjunto de ensaios que é a combinação dos conjuntos. No caso a seguir, apenas os ensaios para diabetes que estão recrutando em Illinois são consultados. Deixar uma categoria vazia não está limitando os ensaios por essa categoria.
"registryFilters": [
{
"conditions": [
"Diabetes"
],
"sources": [
"clinicaltrials.gov"
],
"facilityLocations": [
{
"country": "United States",
"state": "IL"
}
],
"recruitmentStatuses": [
"recruiting"
]
}
]
Evidência
A evidência é uma indicação de que a saída do modelo deve incluir evidências para as inferências. O valor padrão é true. Para cada ensaio clínico que ao qual o modelo concluiu que o paciente não é elegível, o modelo retorna as informações relevantes do paciente e os critérios de elegibilidade que foram usados para excluir o paciente do ensaio.
{
"type": "trialEligibility",
"evidence": [
{
"eligibilityCriteriaEvidence": "Inclusion: Patient must have an Eastern Cooperative Oncology Group performance status of 0 or 1 The diagnosis of invasive adenocarcinoma of the breast must have been made by core needle biopsy.",
"patientInfoEvidence": {
"system": "http://www.nlm.nih.gov/research/umls",
"code": "C1512162",
"name": "Eastern Cooperative Oncology Group",
"value": "2"
}
},
{
"eligibilityCriteriaEvidence": "Inclusion: Blood counts performed within 6 weeks prior to initiating chemotherapy must meet the following criteria: absolute neutrophil count must be greater than or equal 1200 / mm3 ;, platelet count must be greater than or equal 100,000 / mm3 ; and",
"patientInfoEvidence": {
"system": "http://www.nlm.nih.gov/research/umls",
"code": "C0032181",
"name": "Platelet Count measurement",
"value": "75000"
}
}
],
"id": "NCT03412643",
"source": "clinicaltrials.gov",
"value": "Ineligible",
}
Detalhado
Verbose é uma indicação de se o modelo deve retornar informações de ensaios. O valor padrão é false. Se definido para True, o modelo retorna informações de ensaios, incluindo Title, Phase, Type, Recruitment status, Sponsors, Contacts, e Facilities.
Se você usar a combinação gradual, o modo detalhado é usado normalmente na última etapa do processo de qualificação, antes de exibir os resultados do ensaio.
{
"type": "trialEligibility",
"id": "NCT03513939",
"source": "clinicaltrials.gov",
"metadata": {
"phases": [
"phase1",
"phase2"
],
"studyType": "interventional",
"recruitmentStatus": "recruiting",
"sponsors": [
"Sernova Corp",
"CTI Clinical Trial and Consulting Services",
"Juvenile Diabetes Research Foundation",
"University of Chicago"
],
"contacts": [
{
"name": "Frank, MD, PhD",
"email": "frank@surgery.uchicago.edu",
"phone": "999-702-2447"
}
],
"facilities": [
{
"name": "University of Chicago Medical Center",
"city": "Chicago",
"state": "Illinois",
"country": "United States"
}
]
},
"value": "Eligible",
"description": "A Safety, Tolerability and Efficacy Study of Sernova's Cell Pouch™ for Clinical Islet Transplantation",
}
Adicionando ensaios personalizados
O Trial Matcher pode receber os critérios de elegibilidade de um ensaio clínico no formato de um ensaio personalizado. O usuário do serviço deve fornecer a seção de critérios de elegibilidade do ensaio personalizado, como um texto, em um formato similar ao formato de clinicaltrials.gov (mesmo recuo e estrutura).
Um ensaio personalizado pode ser fornecido como um ensaio clínico exclusivo para corresponder um paciente , como uma lista de ensaios personalizados, ou como adição ao grafo de conhecimento de clinicaltrials.gov.
Para fornecer um ensaio personalizado, a entrada para o serviço Trial Matcher deve incluir ClinicalTrialRegisteryFilter.sources com o valor custom.
{
"Configuration":{
"ClinicalTrials":{
"CustomTrials":[
{
"Id":"CustomTrial1",
"EligibilityCriteriaText":"INCLUSION CRITERIA:\n\n 1. Patients diagnosed with Diabetes\n\n2. patients diagnosed with cancer\n\nEXCLUSION CRITERIA:\n\n1. patients with RET gene alteration\n\n 2. patients taking Aspirin\n\n3. patients treated with Chemotherapy\n\n",
"Demographics":{
"AcceptedSex":"female",
"acceptedAgeRange":{
"MinimumAge":{
"Unit":"Years",
"Value":0
},
"MaximumAge":{
"Unit":"Years",
"Value":100
}
}
},
"Metadata":{
"Phases":[
"Phase1"
],
"StudyType":"Interventional",
"RecruitmentStatus":"Recruiting",
"Conditions":[
"Diabetes"
],
"Sponsors":[
"sponsor1",
"sponsor2"
],
"Contacts":[
{
"Name":"contact1",
"Email":"email1",
"Phone":"01"
},
{
"Name":"contact2",
"Email":"email2",
"Phone":"03"
}
]
}
}
]
},
"Verbose":true,
"IncludeEvidence":true
},
"Patients":[
{
"Id":"Patient1",
"Info":{
"Gender":"Female",
"BirthDate":"2002-07-19T10:58:02.7500649+00:00",
"ClinicalInfo":[
{
"System":"http://www.nlm.nih.gov/research/umls",
"Code":"C0011849",
"Name":"Diabetes",
"Value":"True;EntityType:DIAGNOSIS"
},
{
"System":"http://www.nlm.nih.gov/research/umls",
"Code":"C0004057",
"Name":"aspirin",
"Value":"False;EntityType:MedicationName"
}
]
}
}
]
}
Próximas etapas
Para começar a usar o modelo Trial Matcher, consulte