Azure Cognitive Services Health Insights-klientbibliotek för klinisk matchning för .NET – version 1.0.0-beta.1

Artikel
04/06/2023

Health Insights är en Azure Applied AI-tjänst som skapats med Azure Cognitive Services Framework och som utnyttjar flera Cognitive Services, Healthcare API-tjänster och andra Azure-resurser.

Modellen klinisk matchning tar emot patientdata och protokoll för kliniska prövningar och tillhandahåller relevanta kliniska prövningar baserat på berättigandekriterier.

Källkod | Paket (NuGet) | API-referensdokumentation | Produktdokumentation

Komma igång

Krav

Du behöver en Azure-prenumeration för att använda det här paketet.
En befintlig Cognitive Services Health Insights-instans.

Installera paketet

Installera Azure Health Insights-klienten Clinical Matchinglibrary för .NET med NuGet:

dotnet add package Azure.Health.Insights.ClinicalMatching --prerelease

Den här tabellen visar relationen mellan SDK-versioner och API-versioner som stöds av tjänsten:

SDK-version	API-version av tjänsten som stöds
1.0.0-beta.1	2023-03-01-preview

Autentisera klienten

Du hittar slutpunkten för din Health Insights-tjänstresurs med hjälp av Azure-portalen eller Azure CLI

# Get the endpoint for the Health Insights service resource
az cognitiveservices account show --name "resource-name" --resource-group "resource-group-name" --query "properties.endpoint"

Hämta API-nyckeln

Du kan hämta API-nyckeln från Health Insights-tjänstresursen i Azure-portalen. Du kan också använda Azure CLI-kodfragmentet nedan för att hämta API-nyckeln för din resurs.

az cognitiveservices account keys list --resource-group <your-resource-group-name> --name <your-resource-name>

Skapa ClinicalMatchingClient med AzureKeyCredential

När du har värdet för API-nyckeln skapar du en AzureKeyCredential. Med slutpunkten och nyckelautentiseringsuppgifterna kan du skapa :ClinicalMatchingClient

string endpoint = "<endpoint>";
string apiKey = "<apiKey>";
var credential = new AzureKeyCredential(apiKey);
var client = new ClinicalMatchingClient(new Uri(endpoint), credential);

Viktiga begrepp

Trial Matcher ger användaren av tjänsterna två huvudsakliga driftslägen: patienter centrerat och klinisk prövning centrerad.

I patientcentrerat läge baserar testmatchningsmodellen patientmatchningen på det kliniska tillståndet, platsen, prioriteringarna, berättigandekriterierna och andra kriterier som patienten och/eller tjänstanvändare kan välja att prioritera. Modellen hjälper till att begränsa och prioritera uppsättningen relevanta kliniska prövningar till en mindre uppsättning prövningar till att börja med, som den specifika patienten verkar vara kvalificerad för.
På klinisk prövning centrerad finner Trial Matcher en grupp patienter som potentiellt är berättigade till en klinisk prövning. Studiematchare begränsar patienterna, först filtrerade efter kliniskt tillstånd och valda kliniska observationer, och fokuserar sedan på de patienter som uppfyllde baslinjekriterierna, för att hitta den grupp patienter som verkar vara berättigade patienter till en studie.

Exempel

Matcha utvärderingsversioner

Matcha utvärderingsversioner

TrialMatcherResult trialMatcherResult = default;
try
{
    // Using ClinicalMatchingClient + MatchTrialsAsync
    Operation<TrialMatcherResult> operation = await clinicalMatchingClient.MatchTrialsAsync(WaitUntil.Completed, trialMatcherData);
    trialMatcherResult = operation.Value;
}
catch (Exception ex)
{
    Console.WriteLine(ex.ToString());
    return;
}

// View the match trials (eligible/ineligible)
if (trialMatcherResult.Status == JobStatus.Succeeded)
{
    TrialMatcherResults matcherResults = trialMatcherResult.Results;
    foreach (TrialMatcherPatientResult patientResult in matcherResults.Patients)
    {
        Console.WriteLine($"Inferences of Patient {patientResult.Id}");
        foreach (TrialMatcherInference tmInferences in patientResult.Inferences)
        {
            Console.WriteLine($"Trial Id {tmInferences.Id}");
            Console.WriteLine($"Type: {tmInferences.Type.ToString()}  Value: {tmInferences.Value}");
            Console.WriteLine($"Description {tmInferences.Description}");
        }
    }
}
else
{
    IReadOnlyList<ResponseError> matcherErrors = trialMatcherResult.Errors;
    foreach (ResponseError error in matcherErrors)
    {
        Console.WriteLine($"{error.Code} : {error.Message}");
    }
}

Felsökning

Konfigurera konsolloggning

Det enklaste sättet att se loggarna är att aktivera konsolloggning. Om du vill skapa en Azure SDK-logglyssnare som matar ut meddelanden till konsolen använder du metoden AzureEventSourceListener.CreateConsoleLogger.

// Setup a listener to monitor logged events.
using AzureEventSourceListener listener = AzureEventSourceListener.CreateConsoleLogger();

Mer information om andra loggningsmekanismer finns i Diagnostikexempel.

Nästa steg

Ytterligare dokumentation

Mer omfattande dokumentation om klinisk matchning i Azure Health Insights finns i dokumentationen om klinisk matchning på docs.microsoft.com.

Bidra

Det här projektet välkomnar bidrag och förslag. Merparten av bidragen kräver att du godkänner ett licensavtal för bidrag, där du deklarerar att du har behörighet att bevilja oss rättigheten att använda ditt bidrag, och att du dessutom uttryckligen gör så. Mer information finns i cla.microsoft.com.

När du skickar en pull-förfrågan avgör en CLA-robot automatiskt om du måste tillhandahålla ett licensavtal för bidrag med lämplig PR (t.ex. etikett eller kommentar). Följ bara robotens anvisningar. Du behöver bara göra detta en gång för alla repor som använder vårt licensavtal för bidrag.

Det här projektet använder sig av Microsofts uppförandekod för öppen källkod. Mer information finns i Vanliga frågor och svar om uppförandekod eller kontakt opencode@microsoft.com med ytterligare frågor eller kommentarer.

Dela via