Biblioteca de cliente do Azure Cognitive Services Health Insights Clinical Matching para .NET – versão 1.0.0-beta.1
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 Correspondência Clínica recebe dados dos 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 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 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 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 ClinicalMatchingClient com 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 ClinicalMatchingClient
:
string endpoint = "<endpoint>";
string apiKey = "<apiKey>";
var credential = new AzureKeyCredential(apiKey);
var client = new ClinicalMatchingClient(new Uri(endpoint), credential);
Conceitos-chave
O Trial Matcher fornece ao utilizador dos serviços dois modos principais de funcionamento: pacientes centrados e centrados no ensaio clínico.
- No modo centrado no paciente, o modelo Do Matcher de Avaliação baseia a correspondência do paciente na condição clínica, na localização, nas prioridades, nos critérios de elegibilidade e noutros critérios que os utilizadores do paciente e/ou do serviço podem optar por atribuir prioridades. O modelo ajuda a reduzir e priorizar o conjunto de ensaios clínicos relevantes para um conjunto mais pequeno de ensaios, para começar, para o qual o paciente específico parece estar qualificado.
- No ensaio clínico centrado, o Matcher de Ensaio está a encontrar um grupo de pacientes potencialmente elegíveis para um ensaio clínico. O Matcher de Ensaio restringe os pacientes, primeiro filtrado em condição clínica e observações clínicas selecionadas, e depois foca-se nos pacientes que cumpriram os critérios de linha de base, para encontrar o grupo de pacientes que parece ser pacientes elegíveis para um ensaio.
Exemplos
Corresponder a 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}");
}
}
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 Correspondência Clínica do Azure Health Insights, veja a documentação de Correspondência Clínica sobre 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.
Azure SDK for .NET
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários