Libreria client di Profilatura del cancro di Servizi cognitivi di Azure per .NET - versione 1.0.0-beta.1

Articolo
04/06/2023

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 profilatura del cancro riceve record clinici di pazienti oncologia e restituisce la gestione temporanea del cancro, ad esempio le categorie TNM della fase clinica e le categorie TNM della fase patologia, nonché il sito del tumore, l'istologia.

Codice | sorgente Pacchetto (NuGet) | Documentazione | di riferimento sulle API Documentazione 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 la libreria di profilatura del cancro del client di Azure Health Insights per .NET con NuGet:

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

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

Versione dell'SDK	Versione api supportata del servizio
1.0.0-beta.1	2023-03-01-preview

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 CancerProfilingClient 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 :CancerProfilingClient

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

Concetti chiave

Il modello di profilatura del cancro consente di dedurre attributi del cancro, ad esempio il sito del tumore, l'istologia, le categorie TNM della fase clinica e le categorie TNM della fase patologia da documenti clinici non strutturati.

Esempio

Dedurre la profilatura del cancro

Profilatura del cancro

OncoPhenotypeResult oncoPhenotypeResult = default;
try
{
    Operation<OncoPhenotypeResult> operation = await client.InferCancerProfileAsync(WaitUntil.Completed, oncoPhenotypeData);
    oncoPhenotypeResult = operation.Value;
}
catch (Exception ex)
{
    Console.WriteLine(ex.ToString());
    return;
}

// View operation results
if (oncoPhenotypeResult.Status == JobStatus.Succeeded)
{
    OncoPhenotypeResults oncoResults = oncoPhenotypeResult.Results;
    foreach (OncoPhenotypePatientResult patientResult in oncoResults.Patients)
    {
        Console.WriteLine($"\n==== Inferences of Patient {patientResult.Id} ====");
        foreach (OncoPhenotypeInference oncoInference in patientResult.Inferences)
        {
            Console.WriteLine($"\n=== Clinical Type: {oncoInference.Type.ToString()}  Value: {oncoInference.Value}   ConfidenceScore: {oncoInference.ConfidenceScore} ===");
            foreach (InferenceEvidence evidence in oncoInference.Evidence)
            {
                if (evidence.PatientDataEvidence != null)
                {
                    var dataEvidence = evidence.PatientDataEvidence;
                    Console.WriteLine($"Evidence {dataEvidence.Id} {dataEvidence.Offset} {dataEvidence.Length} {dataEvidence.Text}");
                }
                if (evidence.PatientInfoEvidence != null)
                {
                    var infoEvidence = evidence.PatientInfoEvidence;
                    Console.WriteLine($"Evidence {infoEvidence.System} {infoEvidence.Code} {infoEvidence.Name} {infoEvidence.Value}");
                }
            }
        }
    }
}
else
{
    IReadOnlyList<ResponseError> oncoErrors = oncoPhenotypeResult.Errors;
    foreach (ResponseError error in oncoErrors)
    {
        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 profilatura del cancro di Azure Health Insights, vedere la documentazione sulla profilatura del cancro 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.

Condividi tramite