Azure Cognitive Services Health Insights Cancer Profiling ügyfélkódtár a .NET-hez – 1.0.0-beta.1-es verzió

Cikk
04/06/2023

A Health Insights egy azure-beli alkalmazott AI-szolgáltatás, amely az Azure Cognitive Services-keretrendszerrel van létrehozva, amely több Cognitive Services- és Healthcare API-szolgáltatást és más Azure-erőforrásokat használ.

A Cancer Profiling modell megkapja az onkológiai betegek klinikai rekordjait, és rákelőtagolást ad ki, például klinikai szakasz TNM-kategóriákat és patológiai szakasz TNM-kategóriákat, valamint tumorhelyet, hisztológiát.

Forráskód | Csomag (NuGet) | API-referenciadokumentáció | Termékdokumentáció

Első lépések

Előfeltételek

A csomag használatához Azure-előfizetésre van szüksége.
Egy meglévő Cognitive Services Health Insights-példány.

A csomag telepítése

Telepítse a .NET-hez készült Azure Health Insights-ügyfél rákprofilozási kódtárát a NuGet használatával:

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

Ez a táblázat a szolgáltatás SDK-verziói és támogatott API-verziói közötti kapcsolatot mutatja be:

SDK verziója	A szolgáltatás támogatott API-verziója
1.0.0-beta.1	2023-03-01-preview

Az ügyfél hitelesítése

A Health Insights szolgáltatás erőforrásának végpontját az Azure Portal vagy az Azure CLI használatával találja meg

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

Az API-kulcs lekérése

Az API-kulcsot az Azure Portal Health Insights szolgáltatás-erőforrásából szerezheti be. Másik lehetőségként az alábbi Azure CLI-kódrészlettel lekérheti az erőforrás API-kulcsát.

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

CancerProfilingClient létrehozása az AzureKeyCredential használatával

Miután megkapta az API-kulcs értékét, hozzon létre egy AzureKeyCredential. A végpont és a kulcs hitelesítő adataival létrehozhatja a következőt CancerProfilingClient:

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

Fő fogalmak

A Cancer Profiling modell lehetővé teszi, hogy a strukturálatlan klinikai dokumentumokból olyan rákattribútumokat vonjon le, mint a tumor helye, a hisztológia, a klinikai szakasz TNM-kategóriái és a patológiai szakasz TNM-kategóriái.

Példák

A rák profilkészítésének következtetése

Rákprofilozás

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

Hibaelhárítás

Konzolnaplózás beállítása

A naplók megtekintésének legegyszerűbb módja a konzolnaplózás engedélyezése. Ha olyan Azure SDK-naplófigyelőt szeretne létrehozni, amely üzeneteket küld a konzolra, használja az AzureEventSourceListener.CreateConsoleLogger metódust.

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

További információ az egyéb naplózási mechanizmusokról: Diagnosztikai minták.

Következő lépések

További dokumentáció

Az Azure Health Insights rákprofilozásával kapcsolatos részletesebb dokumentációért tekintse meg a rákprofilozási dokumentációt a docs.microsoft.com.

Közreműködés

A projektben szívesen fogadjuk a hozzájárulásokat és a javaslatokat. A legtöbb hozzájáruláshoz el kell fogadnia egy Közreműködői licencszerződést (CLA-t), amelyben kijelenti, hogy jogosult arra, hogy ránk ruházza hozzájárulása felhasználási jogát, és ezt ténylegesen meg is teszi. A részletekért látogasson el a cla.microsoft.com.

A lekéréses kérelmek elküldésekor egy CLA-robot automatikusan meghatározza, hogy kell-e biztosítania CLA-t, és megfelelően kitölti a lekéréses kérelmet (például címke, megjegyzés). Egyszerűen csak kövesse a robot által megadott utasításokat. Ezt csak egyszer kell elvégeznie az összes olyan tárházban, amely a CLA-t használja.

A projekt a Microsoft nyílt forráskódú projekteket szabályozó etikai kódexe, a Microsoft Open Source Code of Conduct hatálya alá esik. További információkért lásd a viselkedési szabályzattal kapcsolatos gyakori kérdéseket , vagy vegye fel a kapcsolatot opencode@microsoft.com az esetleges további kérdésekkel vagy megjegyzésekkel.

Share via