Biblioteca de cliente de Criação de Perfis para Cancro dos Serviços Cognitivos dos Serviços Cognitivos do Azure para .NET – versão 1.0.0-beta.1

  • Artigo

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

O modelo de Criação de Perfis de Cancro recebe registos clínicos de doentes com oncologia e produz testes de cancro, tais como categorias de TNM em fase clínica e categorias de TNM de fase patológica, bem como o local do tumor, a histologia.

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

Introdução

Pré-requisitos

  • Precisa de uma subscrição do Azure para utilizar este pacote.
  • Uma instância das Informações de Estado de Funcionamento dos Serviços Cognitivos existente.

Instalar o pacote

Instale a biblioteca de Criação de Perfis de Cancro do cliente do Azure Health Insights para .NET com 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 suportadas do serviço:

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

Autenticar o cliente

Pode encontrar o ponto final do recurso do serviço Informações de Estado de Funcionamento com 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

Pode obter a Chave de API a partir do recurso do serviço Informações de Estado de Funcionamento no portal do Azure. Em alternativa, pode utilizar o fragmento 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 a AzureKeyCredential

Assim que tiver o valor da chave de API, crie um AzureKeyCredential. Com o ponto final e a credencial da chave, pode criar o CancerProfilingClient:

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

Conceitos-chave

O modelo de Criação de Perfis de Cancro permite-lhe inferir atributos de cancro, como o local do tumor, a histologia, as categorias de TNM de fase clínica e as categorias de TNM de fase patológica a partir de documentos clínicos não estruturados.

Exemplos

Criação de Perfis para o 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}");
    }
}

Resolução de problemas

Configurar o registo da consola

A forma mais simples de ver os registos é ativar o registo da consola. Para criar um serviço de escuta de registo do SDK do Azure que produz mensagens para a consola, utilize o método AzureEventSourceListener.CreateConsoleLogger.

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

Para saber mais sobre outros mecanismos de registo, veja Diagnostics Samples (Exemplos de Diagnóstico).

Passos seguintes

Documentação adicional

Para obter documentação mais extensa sobre a Criação de Perfis para o Cancro do Azure Health Insights, veja a documentação sobre a Criação de Perfis de Cancro no docs.microsoft.com.

Contribuir

Agradecemos todas as contribuições e sugestões para este projeto. A maioria das contribuições requerem que celebre um Contrato de Licença de Contribuição (CLA) no qual se declare que tem o direito de conceder e que, na verdade, concede-nos os direitos para utilizar a sua contribuição. Para obter detalhes, visite cla.microsoft.com.

Quando submete um pedido Pull, um bot do CLA determina automaticamente se tem de fornecer um CLA e decorar o PR de forma adequada (por exemplo, etiqueta, comentário). Só tem de seguir as instruções fornecidas pelo bot. Apenas terá de fazer isto uma vez em todos os repositórios com o nosso CLA.

Este projeto adotou o Microsoft Open Source Code of Conduct (Código de Conduta do Microsoft Open Source). Para obter mais informações, consulte as FAQ do Código de Conduta ou contacte opencode@microsoft.com com quaisquer perguntas ou comentários adicionais.