Biblioteca de clientes de Correspondência Clínica do Insights de Integridade dos Serviços Cognitivos do Azure 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 a Estrutura de Serviços Cognitivos do Azure, que aproveita vários Serviços Cognitivos, serviços de API de Saúde e outros recursos do Azure.

O modelo correspondência clínica recebe dados de pacientes e protocolos de ensaios clínicos e fornece ensaios clínicos relevantes com base em critérios de elegibilidade.

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 Insights de Integridade dos Serviços Cognitivos.

Instalar o pacote

Instale o cliente do Azure Health Insights Clinical Matchinglibrary para .NET com NuGet:

dotnet add package Azure.Health.Insights.ClinicalMatching --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 o 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 Insights de Integridade 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 ClinicalMatchingClient 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 ClinicalMatchingClient:

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

Principais conceitos

O Matcher de Avaliação fornece ao usuário dos serviços dois modos de operação main: centrado em pacientes e centrado em ensaio clínico.

No modo centrado no paciente, o modelo do Verificador de Avaliação baseia a correspondência do paciente na condição clínica, local, prioridades, critérios de qualificação e outros critérios que os usuários do paciente e/ou do serviço podem optar por priorizar. O modelo ajuda a restringir e priorizar o conjunto de ensaios clínicos relevantes para um conjunto menor de ensaios a serem iniciados, para os quais o paciente específico parece estar qualificado.
No ensaio clínico centrado, o Trial Matcher está encontrando um grupo de pacientes potencialmente elegíveis para um ensaio clínico. O Estudo Matcher restringe os pacientes, primeiro filtrados em condições clínicas e observações clínicas selecionadas, e depois se concentra nos pacientes que atenderam aos critérios de linha de base, para encontrar o grupo de pacientes que parecem ser pacientes elegíveis para um ensaio.

Exemplos

Corresponder avaliações

Corresponder avaliações

TrialMatcherResult trialMatcherResult = default;
try
{
    // Using ClinicalMatchingClient + MatchTrialsAsync
    Operation<TrialMatcherResult> operation = await clinicalMatchingClient.MatchTrialsAsync(WaitUntil.Completed, trialMatcherData);
    trialMatcherResult = operation.Value;
}
catch (Exception ex)
{
    Console.WriteLine(ex.ToString());
    return;
}

// View the match trials (eligible/ineligible)
if (trialMatcherResult.Status == JobStatus.Succeeded)
{
    TrialMatcherResults matcherResults = trialMatcherResult.Results;
    foreach (TrialMatcherPatientResult patientResult in matcherResults.Patients)
    {
        Console.WriteLine($"Inferences of Patient {patientResult.Id}");
        foreach (TrialMatcherInference tmInferences in patientResult.Inferences)
        {
            Console.WriteLine($"Trial Id {tmInferences.Id}");
            Console.WriteLine($"Type: {tmInferences.Type.ToString()}  Value: {tmInferences.Value}");
            Console.WriteLine($"Description {tmInferences.Description}");
        }
    }
}
else
{
    IReadOnlyList<ResponseError> matcherErrors = trialMatcherResult.Errors;
    foreach (ResponseError error in matcherErrors)
    {
        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 Correspondência Clínica do Azure Health Insights, consulte a documentação de Correspondência Clínica no 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