Libreria client di Corrispondenza clinica di Servizi cognitivi di Azure per .NET - versione 1.0.0-beta.1

Health Insights è un servizio di intelligenza artificiale applicato di Azure creato con Il framework di Servizi cognitivi di Azure, che sfrutta più servizi cognitivi, servizi API per il settore sanitario e altre risorse di Azure.

Il modello di corrispondenza clinica riceve i dati dei pazienti e i protocolli di sperimentazione clinica e fornisce studi clinici pertinenti in base ai criteri di idoneità.

Codice | sorgente Pacchetto (NuGet) | Documentazione | di riferimento sulle APIDocumentazione del prodotto

Introduzione

Prerequisiti

• Per usare questo pacchetto è necessaria una sottoscrizione di Azure .
• Istanza esistente di Informazioni dettagliate sull'integrità di Servizi cognitivi.

Installare il pacchetto

Installare il client di Azure Health Insights Clinical Matchinglibrary per .NET con NuGet:

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

Questa tabella illustra la relazione tra le versioni dell'SDK e le versioni API supportate del servizio:

Autenticare il client

È possibile trovare l'endpoint per la risorsa del servizio Health Insights usando il portale di Azure o l'interfaccia della riga di comando di 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"

Ottenere la chiave API

È possibile ottenere la chiave API dalla risorsa del servizio Health Insights nel portale di Azure. In alternativa, è possibile usare il frammento di interfaccia della riga di comando di Azure seguente per ottenere la chiave API della risorsa.

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

Creare ClinicalMatchingClient con AzureKeyCredential

Dopo aver ottenuto il valore per la chiave API, creare un oggetto AzureKeyCredential. Con l'endpoint e le credenziali della chiave, è possibile creare :ClinicalMatchingClient

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

Concetti chiave

Matcher di valutazione fornisce all'utente dei servizi due modalità principali di funzionamento: i pazienti incentrati e la sperimentazione clinica incentrati.

• In modalità incentrata sui pazienti, il modello Matcher di valutazione basa la corrispondenza dei pazienti sulla condizione clinica, la posizione, le priorità, i criteri di idoneità e altri criteri che gli utenti del paziente e/o del servizio possono scegliere di assegnare priorità. Il modello aiuta a restringere e classificare in ordine di priorità il set di studi clinici pertinenti a un set più piccolo di prove da iniziare, che il paziente specifico sembra essere qualificato per.
• Nello studio clinico incentrato, il matcher di valutazione sta trovando un gruppo di pazienti potenzialmente idonei a uno studio clinico. Il matcher di valutazione restringe i pazienti, filtrati prima in base alle condizioni cliniche e alle osservazioni cliniche selezionate, e poi si concentra su quei pazienti che soddisfano i criteri di base, per trovare il gruppo di pazienti che sembrano essere idonei a una sperimentazione.

Esempio

• Corrispondenza versioni di valutazione

Corrispondenza versioni di valutazione

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

Risoluzione dei problemi

Configurazione della registrazione della console

Il modo più semplice per visualizzare i log consiste nell'abilitare la registrazione della console. Per creare un listener di log di Azure SDK che restituisce messaggi nella console, usare il metodo AzureEventSourceListener.CreateConsoleLogger.

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

Per altre informazioni su altri meccanismi di registrazione, vedere Esempi di diagnostica.

Passaggi successivi

Documentazione aggiuntiva

Per una documentazione più completa sulla corrispondenza clinica di Azure Health Insights, vedere la documentazione sulla corrispondenza clinica su docs.microsoft.com.

Contributo

In questo progetto sono benvenuti i contributi e i suggerimenti. Per la maggior parte dei contenuti è necessario sottoscrivere un contratto di licenza di collaborazione (CLA, Contributor License Agreement) che stabilisce che l'utente ha il diritto di concedere, e di fatto concede a Microsoft i diritti d'uso del suo contributo. Per informazioni dettagliate, visitare cla.microsoft.com.

Quando si invia una richiesta pull, un bot CLA determina automaticamente se è necessario specificare un contratto CLA e completare la richiesta pull in modo appropriato (ad esempio con un'etichetta e un commento). Seguire le istruzioni specificate dal bot. È sufficiente eseguire questa operazione una sola volta per tutti i repository che usano il contratto CLA Microsoft.

Questo progetto ha adottato il Codice di comportamento di Microsoft per l'open source. Per altre informazioni, vedere Code of Conduct FAQ (Domande frequenti sul Codice di comportamento Open Source di Microsoft) oppure contattare opencode@microsoft.com per eventuali altre domande o commenti.