Azure Cognitive Services Health Insights-clientbibliotheek voor kankerprofilering 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 kankerprofileringsmodel ontvangt klinische records van oncologiepatiënten en voert kankerfasering uit, zoals TNM-categorieën voor klinische fase en pathologisch stadium TNM-categorieën, evenals tumorsite, histologie.

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

Aan de slag

Vereisten

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

Het pakket installeren

Installeer de Azure Health Insights-clientbibliotheek voor kankerprofilering voor .NET met NuGet:

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

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

SDK-versie	Ondersteunde API-versie van de 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 de 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>

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

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

Belangrijkste concepten

Met het kankerprofileringsmodel kunt u kankerkenmerken zoals tumorplaats, histologie, TNM-categorieën voor klinische stadia en pathologische fase-TNM-categorieën afleiden uit ongestructureerde klinische documenten.

Voorbeelden

Kankerprofilering afleiden

Kankerprofilering

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

Problemen oplossen

Consolelogboekregistratie instellen

De eenvoudigste manier om de logboeken te bekijken, is door de logboekregistratie van de console in te schakelen. Gebruik de methode AzureEventSourceListener.CreateConsoleLogger om een Azure SDK-logboeklister te maken waarmee berichten worden verzonden naar de console.

// 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 Kankerprofilering van Azure Health Insights op docs.microsoft.com voor uitgebreidere documentatie over Kankerprofilering van Azure Health Insights.

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 de Veelgestelde vragen over de gedragscode voor meer informatie of neem contact op opencode@microsoft.com met eventuele aanvullende vragen of opmerkingen.

Delen via