Klientská knihovna klinického párování azure Cognitive Services Health Insights pro .NET – verze 1.0.0-beta.1

Článek
04/06/2023

Health Insights je služba Azure Applied AI Service vytvořená pomocí rozhraní Azure Cognitive Services Framework, která využívá několik služeb Cognitive Services, služeb rozhraní API pro zdravotnictví a dalších prostředků Azure.

Model klinické shody přijímá data pacientů a protokoly klinických studií a poskytuje relevantní klinická hodnocení na základě kritérií způsobilosti.

Zdrojový kód | Balíček (NuGet) | Referenční dokumentace k | rozhraní API Dokumentace k produktu

Začínáme

Požadavky

K použití tohoto balíčku potřebujete předplatné Azure .
Existující instance Cognitive Services Health Insights.

Instalace balíčku

Nainstalujte klienta Azure Health Insights Clinical Matchinglibrary pro .NET pomocí NuGetu:

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

Tato tabulka ukazuje vztah mezi verzemi sady SDK a podporovanými verzemi rozhraní API služby:

SDK version (Verze sady SDK)	Podporovaná verze služby ROZHRANÍ API
1.0.0-beta.1	2023-03-01-preview

Ověření klienta

Koncový bod pro prostředek služby Health Insights můžete najít pomocí webu Azure Portal nebo 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"

Získání klíče rozhraní API

Klíč rozhraní API můžete získat z prostředku služby Health Insights na webu Azure Portal. Případně můžete pomocí fragmentu kódu Azure CLI níže získat klíč rozhraní API vašeho prostředku.

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

Vytvoření ClinicalMatchingClient pomocí AzureKeyCredential

Jakmile budete mít hodnotu klíče rozhraní API, vytvořte AzureKeyCredential. Pomocí přihlašovacích údajů koncového bodu a klíče můžete vytvořit ClinicalMatchingClient:

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

Klíčové koncepty

Zkušební matcher poskytuje uživatelům služeb dva hlavní režimy provozu: pacienti orientovaný a klinických studií.

V režimu zaměřeném na pacienta model Trial Matcher založí shodu s pacienty na klinickém stavu, umístění, prioritách, kritériích způsobilosti a dalších kritériích, pro která se pacient a/nebo uživatelé služeb mohou rozhodnout určit prioritu. Model pomáhá zúžit a upřednostnit sadu relevantních klinických studií na menší sadu studií, na které se konkrétní pacient zdá být způsobilý.
U klinických studií zaměřených na klinické hodnocení hledá nástroj Trial Matcher skupinu pacientů, kteří jsou potenciálně způsobilí ke klinickému hodnocení. Zkušební matcher zužuje pacienty, nejprve filtruje klinický stav a vybraná klinická pozorování a pak se zaměřuje na ty pacienty, kteří splňují základní kritéria, aby našli skupinu pacientů, kteří se zdá být způsobilými pacienty pro hodnocení.

Příklady

Shoda zkušebních verzí

Shoda zkušebních verzí

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

Řešení potíží

Nastavení protokolování konzoly

Nejjednodušší způsob, jak zobrazit protokoly, je povolit protokolování konzoly. K vytvoření naslouchacího procesu protokolu sady Azure SDK, který vypíše zprávy do konzoly, použijte metodu AzureEventSourceListener.CreateConsoleLogger.

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

Další informace o dalších mechanismech protokolování najdete v ukázce diagnostiky.

Další kroky

Další dokumentace

Rozsáhlejší dokumentaci k klinickému párování azure Health Insights najdete v dokumentaci ke klinickému párování docs.microsoft.com.

Přispívání

Tento projekt vítá příspěvky a návrhy. Většina příspěvků vyžaduje souhlas s licenční smlouvou s přispěvatelem (CLA), která stanoví, že máte právo udělit nám práva k používání vašeho příspěvku a skutečně tak činíte. Podrobnosti najdete na cla.microsoft.com.

Při odesílání žádosti o přijetí změn robot CLA automaticky určí, jestli je potřeba poskytnout smlouvu CLA, a příslušným způsobem žádost o přijetí změn upraví (např. přidáním jmenovky nebo komentáře). Stačí postupovat podle pokynů robota. Pro všechna úložiště používající naši smlouvu CLA to stačí udělat jenom jednou.

Tento projekt přijal pravidla chování pro Microsoft Open Source. Další informace najdete v nejčastějších dotazech k pravidlům chování nebo se obraťte na opencode@microsoft.com případné další dotazy nebo komentáře.

Sdílet prostřednictvím