Udostępnij za pośrednictwem


Biblioteka klienta dopasowywania klinicznego usługi Azure Cognitive Services Health Insights dla platformy .NET — wersja 1.0.0-beta.1

Health Insights to usługa Azure Applied AI Service utworzona za pomocą platformy Azure Cognitive Services Framework, która korzysta z wielu usług Cognitive Services, usług Healthcare API i innych zasobów platformy Azure.

Model dopasowywania klinicznego otrzymuje dane pacjentów i protokoły badań klinicznych oraz udostępnia odpowiednie badania kliniczne na podstawie kryteriów kwalifikowalności.

Kod | źródłowy Pakiet (NuGet) | Dokumentacja referencyjna interfejsu | API Dokumentacja produktu

Wprowadzenie

Wymagania wstępne

  • Do korzystania z tego pakietu potrzebna jest subskrypcja platformy Azure .
  • Istniejące wystąpienie usługi Cognitive Services Health Insights.

Instalowanie pakietu

Zainstaluj klienta usługi Azure Health Insights Clinical Matchinglibrary dla platformy .NET za pomocą narzędzia NuGet:

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

W tej tabeli przedstawiono relację między wersjami zestawu SDK i obsługiwanymi wersjami interfejsu API usługi:

Wersja zestawu SDK Obsługiwana wersja usługi interfejsu API
1.0.0-beta.1 2023-03-01-preview

Uwierzytelnianie klienta

Punkt końcowy zasobu usługi Health Insights można znaleźć za pomocą witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure

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

Pobieranie klucza interfejsu API

Klucz interfejsu API można uzyskać z zasobu usługi Health Insights w witrynie Azure Portal. Alternatywnie możesz użyć poniższego fragmentu kodu interfejsu wiersza polecenia platformy Azure , aby uzyskać klucz interfejsu API zasobu.

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

Tworzenie elementu ClinicalMatchingClient za pomocą elementu AzureKeyCredential

Po utworzeniu wartości klucza interfejsu API utwórz element AzureKeyCredential. Za pomocą punktu końcowego i poświadczeń klucza możesz utworzyć element ClinicalMatchingClient:

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

Kluczowe pojęcia

Element matcher badania zapewnia użytkownikowi usług dwa główne tryby działania: pacjentów skoncentrowanych na badaniach klinicznych i skoncentrowanych na badaniach klinicznych.

  • W trybie skoncentrowanym na pacjentach model dopasowywania próbnego opiera się na dopasowaniu pacjenta w stanie klinicznym, lokalizacji, priorytetach, kryteriach kwalifikowalności i innych kryteriach, które mogą być priorytetowe dla pacjentów i/lub użytkowników usług. Model pomaga zawęzić i określić priorytety zestawu odpowiednich badań klinicznych do mniejszego zestawu badań, od których należy rozpocząć, że konkretny pacjent wydaje się być zakwalifikowany.
  • W przypadku badania klinicznego, Matcher badania znajduje grupę pacjentów potencjalnie uprawnionych do badania klinicznego. Element matcher badania zawęża pacjentów, najpierw filtrowany pod warunkiem klinicznym i wybranych obserwacji klinicznych, a następnie koncentruje się na tych pacjentów, którzy spełniają kryteria odniesienia, aby znaleźć grupę pacjentów, którzy wydają się kwalifikować pacjentów do badania.

Przykłady

Dopasowywanie wersji próbnych

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

Rozwiązywanie problemów

Konfigurowanie rejestrowania konsoli

Najprostszym sposobem wyświetlenia dzienników jest włączenie rejestrowania konsoli. Aby utworzyć odbiornik dziennika zestawu Azure SDK, który generuje komunikaty do konsoli, użyj metody AzureEventSourceListener.CreateConsoleLogger.

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

Aby dowiedzieć się więcej na temat innych mechanizmów rejestrowania, zobacz Przykłady diagnostyczne.

Następne kroki

Dodatkowa dokumentacja

Aby uzyskać bardziej obszerną dokumentację dotyczącą dopasowywania klinicznego usługi Azure Health Insights, zobacz dokumentację dotyczącą dopasowywania klinicznego w docs.microsoft.com.

Współtworzenie

W tym projekcie zachęcamy do współtworzenia i zgłaszania sugestii. Współtworzenie w większości przypadków wymaga zgody na umowę licencyjną dotyczącą współautorów (CLA, Contributor License Agreement), zgodnie z którą współautor ma prawo udzielić i faktycznie udziela nam praw do używania wytworzonej przez siebie zawartości. Aby uzyskać szczegółowe informacje, odwiedź cla.microsoft.com.

Po przesłaniu żądania ściągnięcia robot CLA automatycznie określi, czy musisz przekazać umowę CLA, i doda odpowiednie informacje do tego żądania (na przykład etykietę czy komentarz). Po prostu postępuj zgodnie z instrukcjami robota. Wystarczy zrobić to raz dla wszystkich repozytoriów, w przypadku których jest używana nasza umowa CLA.

W tym projekcie przyjęto Kodeks postępowania oprogramowania Open Source firmy Microsoft. Aby uzyskać więcej informacji, zobacz Często zadawane pytania dotyczące kodeksu postępowania lub skontaktuj się z opencode@microsoft.com dodatkowymi pytaniami lub komentarzami.