Snabbstart: Använda modellen Utvärderingsmatchning

Den här snabbstarten ger en översikt över hur du använder utvärderingsmatchningen.

Förutsättningar

Om du vill använda Utvärderingsmatchning måste du ha ett Azure AI-tjänstkonto skapat. Om du inte redan har skapat ett Azure AI-tjänstkonto kan du läsa Distribuera Azure AI Health Insights med azure-portalen.

När distributionen är klar använder du Azure-portalen för att gå till det nyligen skapade Azure AI-tjänstkontot för att se informationen, inklusive din tjänst-URL. Tjänst-URL:en för åtkomst till tjänsten är: https://YOUR-NAME.cognitiveservices.azure.com/.

Skicka en begäran och få resultat

Om du vill skicka en API-begäran behöver du slutpunkten och nyckeln för ditt Azure AI-tjänstkonto.

Viktigt!

Utvärderingsmatchare är ett asynkront API. Förutsägelse av utvärderingsmatchare utförs när API-begäran tas emot och resultaten returneras asynkront. API-resultaten är tillgängliga i 24 timmar från det att begäran matades in och anges i svaret. Efter tidsperioden rensas resultaten och är inte längre tillgängliga för hämtning.

Exempelbegäran

Om du vill skicka en begäran till Utvärderingsmatchare måste du göra en POST-begäran till slutpunkten.

I exemplet nedan är patienterna matchningar till Clinicaltrials_gov källan, för ett lung cancer villkor med anläggningsplatser för staden 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"
        }
    ]
}

Du hittar också en fullständig vy över parametrarna för begäran här

Svaret innehåller åtgärdsplatsen i svarshuvudet. Värdet ser ut ungefär som följande URL: https://eastus.api.cognitive.microsoft.com/healthinsights/trialmatcher/jobs/b58f3776-c6cb-4b19-a5a7-248a0d9481ff?api_version=2022-01-01-preview

Exempelsvar

Om du vill få resultatet av begäran gör du följande GET-begäran till den URL som anges i postsvarets åtgärdsplatsrubrik.

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}

Ett exempelsvar:

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

Du hittar också en fullständig vy över svarsparametrarna här

Databegränsningar

Gräns	Värde
Maximalt antal patienter per begäran	1
Maximalt antal försök per patient	5000
Maximalt #-platsfilter per begäran	1

Nästa steg

Om du vill få bättre insikter om begäran och svar kan du läsa mer på följande sidor:

Modellkonfiguration

Patientinformation