Biblioteca de clientes do Cancer Profiling dos Serviços Cognitivos do Azure Health Insights para .NET – versão 1.0.0-beta.1

Artigo
04/06/2023

O Health Insights é um Serviço de IA Aplicada do Azure criado com o Azure Cognitive Services Framework, que aproveita vários Serviços Cognitivos, serviços de API de Saúde e outros recursos do Azure.

O modelo criação de perfil de câncer recebe registros clínicos de pacientes oncológicos e gera o preparo do câncer, como categorias de TNM de estágio clínico e categorias de TNM de estágio patológico, bem como local do tumor, histologia.

Código-fonte | Pacote (NuGet) | Documentação | de referência da API Documentação do produto

Introdução

Pré-requisitos

Você precisa de uma assinatura do Azure para usar esse pacote.
Uma instância existente do Cognitive Services Health Insights.

Instalar o pacote

Instale a biblioteca de Criação de Perfil de Câncer do cliente do Azure Health Insights para .NET com o NuGet:

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

Esta tabela mostra a relação entre as versões do SDK e as versões de API com suporte do serviço:

Versão do SDK	Versão da API do serviço com suporte
1.0.0-beta.1	2023-03-01-preview

Autenticar o cliente

Você pode encontrar o ponto de extremidade para seu recurso de serviço do Health Insights usando o Portal do Azure ou a CLI do 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"

Obter a chave de API

Você pode obter a Chave de API do recurso de serviço health insights no Portal do Azure. Como alternativa, você pode usar o snippet da CLI do Azure abaixo para obter a chave de API do recurso.

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

Criar CancerProfilingClient com AzureKeyCredential

Depois de ter o valor da chave de API, crie um AzureKeyCredential. Com o ponto de extremidade e a credencial de chave, você pode criar o CancerProfilingClient:

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

Principais conceitos

O modelo criação de perfil de câncer permite inferir atributos de câncer, como local do tumor, histologia, categorias de TNM de estágio clínico e categorias de TNM de estágio patológico de documentos clínicos não estruturados.

Exemplos

Inferir criação de perfil de câncer

Criação de perfil de câncer

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

Solução de problemas

Configuração do registro em log do console

A maneira mais simples de ver os logs é habilitar o log do console. Para criar um ouvinte de log do SDK do Azure que gera mensagens para o console, use o método AzureEventSourceListener.CreateConsoleLogger.

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

Para saber mais sobre outros mecanismos de registro em log, confira Exemplos de diagnóstico.

Próximas etapas

Documentação adicional

Para obter uma documentação mais abrangente sobre a Criação de Perfil de Câncer do Azure Health Insights, consulte a documentação sobre criação de perfil de câncer em docs.microsoft.com.

Contribuição

Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um CLA (Contrato de Licença do Colaborador) declarando que você tem o direito de nos conceder, e de fato concede, os direitos de usar sua contribuição. Para obter detalhes, visite cla.microsoft.com.

Quando você envia uma solicitação de pull, um bot do CLA determina automaticamente se você precisa fornecer um CLA e preencher a PR corretamente (por exemplo, rótulo, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que usam nosso CLA.

Este projeto adotou o Código de Conduta de Software Livre da Microsoft. Para obter mais informações, confira as Perguntas frequentes sobre o Código de Conduta ou contate opencode@microsoft.com para enviar outras perguntas ou comentários.

Compartilhar via