Clientbibliotheek voor klinische matching van Azure Cognitive Services Health Insights voor .NET - versie 1.0.0-beta.1

Artikel
04/06/2023

Health Insights is een Azure Applied AI-service die is gebouwd met het Azure Cognitive Services Framework, dat gebruikmaakt van meerdere Cognitive Services, Healthcare API-services en andere Azure-resources.

Het clinical matching-model ontvangt gegevens van patiënten en protocollen voor klinische proeven en biedt relevante klinische onderzoeken op basis van geschiktheidscriteria.

Broncode | Pakket (NuGet) | API-referentiedocumentatie | Productdocumentatie

Aan de slag

Vereisten

U hebt een Azure-abonnement nodig om dit pakket te gebruiken.
Een bestaand Cognitive Services Health Insights-exemplaar.

Het pakket installeren

Installeer de Klinische matchingbibliotheek van de Azure Health Insights-client voor .NET met NuGet:

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

In deze tabel ziet u de relatie tussen SDK-versies en ondersteunde API-versies van de service:

SDK-versie	Ondersteunde API-versie van service
1.0.0-beta.1	2023-03-01-preview

De client verifiëren

U kunt het eindpunt voor uw Health Insights-serviceresource vinden met behulp van azure portal of 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"

De API-sleutel ophalen

U kunt de API-sleutel ophalen uit de Health Insights-serviceresource in Azure Portal. U kunt ook het onderstaande Azure CLI-fragment gebruiken om de API-sleutel van uw resource op te halen.

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

ClinicalMatchingClient maken met AzureKeyCredential

Zodra u de waarde voor de API-sleutel hebt, maakt u een AzureKeyCredential. Met het eindpunt en de sleutelreferentie kunt u de ClinicalMatchingClientmaken:

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

Belangrijkste concepten

Trial Matcher biedt de gebruiker van de services twee belangrijke werkingsmodi: patiëntengericht en klinisch onderzoekgericht.

In de patiëntgerichte modus baseert het Proefmatcher-model de patiëntmatching op de klinische toestand, locatie, prioriteiten, geschiktheidscriteria en andere criteria die de patiënt en/of servicegebruikers kunnen kiezen om prioriteit te geven. Het model helpt bij het beperken en prioriteren van de reeks relevante klinische onderzoeken tot een kleinere reeks onderzoeken om mee te beginnen, waarvoor de specifieke patiënt lijkt te zijn gekwalificeerd.
Bij een klinische studie wordt met de Trial Matcher een groep patiënten gevonden die mogelijk in aanmerking komen voor een klinische studie. De trial matcher beperkt de patiënten, eerst gefilterd op klinische toestand en geselecteerde klinische waarnemingen, en richt zich vervolgens op de patiënten die voldoen aan de basislijncriteria, om de groep patiënten te vinden die in aanmerking lijkt te komen voor een proef.

Voorbeelden

Overeenkomende proefversies

Overeenkomende proefversies

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}");
    }
}

Problemen oplossen

Consolelogboekregistratie instellen

De eenvoudigste manier om de logboeken te bekijken, is door de consolelogboekregistratie in te schakelen. Als u een Azure SDK-logboeklistener wilt maken waarmee berichten worden verzonden naar de console, gebruikt u de methode AzureEventSourceListener.CreateConsoleLogger.

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

Zie Diagnostische voorbeelden voor meer informatie over andere mechanismen voor logboekregistratie.

Volgende stappen

Aanvullende documentatie

Zie de documentatie over klinische matching van Azure Health Insights over docs.microsoft.com voor uitgebreidere documentatie over Azure Health Insights Clinical Matching.

Bijdragen

Wij verwelkomen bijdragen en suggesties voor dit project. Voor de meeste bijdragen moet u instemmen met een licentieovereenkomst voor bijdragers (CLA: Contributor License Agreement) waarin u verklaart dat u gerechtigd bent ons het recht te geven uw bijdrage te gebruiken, en dat u dit ook doet. Ga naar cla.microsoft.com voor meer informatie.

Wanneer u een pull-aanvraag indient, wordt met een CLA-bot automatisch bepaald of u een CLA moet verschaffen en wordt de pull-aanvraag dienovereenkomstig opgemaakt (bijvoorbeeld met een label of commentaar). Volg gewoon de instructies van de bot. U hoeft dit maar eenmaal te doen voor alle repo's waar gebruik wordt gemaakt van onze CLA.

Op dit project is de Microsoft Open Source Code of Conduct (Microsoft Open Source-gedragscode) van toepassing. Zie voor meer informatie de veelgestelde vragen over de gedragscode of neem contact op opencode@microsoft.com met eventuele aanvullende vragen of opmerkingen.

Delen via