Condividi tramite


Configurazione del modello Matcher di prova

Il matcher di valutazione include un grafo knowledge base predefinito, che usa le versioni di valutazione prese da clinicaltrials.gov e viene aggiornato periodicamente.

Quando si abbinano i pazienti alle prove, è possibile definire un elenco di filtri per eseguire query su un subset di studi clinici. Ogni filtro può essere definito in trial conditionsbase a , recruitment statusestypes, , phasessponsors, purposes, facility nameslocationso trial IDs.

  • Se si specificano più valori per la stessa categoria di filtro, viene restituito un set di prova che è un'unione dei due set.

Nota

Gli esempi in questo articolo sono basati sulla versione dell'API 2023-03-01-preview. Potrebbero esserci modifiche tra le versioni dell'API. Per una versione api specifica, usare il riferimento all'API REST per visualizzare la descrizione completa.

Nella configurazione seguente il modello esegue una query sulle prove in stato recruiting di reclutamento o not yet recruiting.

"recruitmentStatuses": ["recruiting", "notYetRecruiting"]
  • Se si specificano più categorie di filtro, viene restituito un set di prova che corrisponde alla combinazione dei set. Nel caso seguente, vengono eseguite query solo le prove per il diabete che stanno reclutando in Illinois. Lasciare vuota una categoria non limita le prove in base a tale categoria.
"registryFilters": [
    {
        "conditions": [
            "Diabetes"
        ],
        "sources": [
            "clinicaltrials.gov"
        ],
        "facilityLocations": [
            {
                "country": "United States",
                "state": "IL"
            }
        ],
        "recruitmentStatuses": [
            "recruiting"
        ]
    }
]

Evidence

L'evidenza indica se l'output del modello deve includere prove per le inferenze. Il valore predefinito è true. Per ogni prova a cui il modello ha concluso che il paziente non è idoneo, il modello restituisce le informazioni pertinenti sul paziente e i criteri di idoneità usati per escludere il paziente dal processo.

{
    "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",
}

Verbose

Verbose indica se il modello deve restituire informazioni sulla versione di valutazione. Il valore predefinito è false. Se impostato su True, il modello restituisce informazioni sulla versione di valutazione, tra cui Title, TypePhase, Recruitment statusSponsors, Contacts, e Facilities.

Se si usa la corrispondenza graduale, viene usato in genere nell'ultima fase del processo di qualificazione, prima di visualizzare i risultati della prova.

{
    "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",
}

Aggiunta di versioni di valutazione personalizzate

Matcher di prova può ricevere i criteri di idoneità di uno studio clinico nel formato di un test personalizzato. L'utente del servizio deve fornire la sezione criteri di idoneità della versione di valutazione personalizzata, come testo, in un formato simile al formato di clinicaltrials.gov (stesso rientro e struttura). Una versione di valutazione personalizzata può essere fornita come prova univoca per trovare una corrispondenza con un paziente, come elenco di prove personalizzate o come aggiunta a clinicaltrials.gov grafico delle conoscenze. Per fornire una versione di valutazione personalizzata, l'input per il servizio Matcher di valutazione deve includere ClinicalTrialRegisteryFilter.sources con il valore 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"
               }
            ]
         }
      }
   ]
}

Passaggi successivi

Per iniziare a usare il modello Matcher di valutazione, vedere