Biblioteca cliente de Coincidencia clínica de Azure Cognitive Services Health Insights para .NET: versión 1.0.0-beta.1

Artículo
04/06/2023

Health Insights es un servicio de inteligencia artificial aplicado de Azure creado con Azure Cognitive Services Framework, que aprovecha varios servicios de Cognitive Services, Healthcare API y otros recursos de Azure.

El modelo de coincidencia clínica recibe datos de pacientes y protocolos de ensayos clínicos, y proporciona ensayos clínicos pertinentes en función de los criterios de idoneidad.

Código | fuente Paquete (NuGet) | Documentación | de referencia de API Documentación del producto

Introducción

Requisitos previos

Necesita una suscripción de Azure para usar este paquete.
Una instancia de Cognitive Services Health Insights existente.

Instalar el paquete

Instale la biblioteca De coincidencia clínica del cliente de Azure Health Insights para .NET con NuGet:

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

En esta tabla se muestra la relación entre las versiones del SDK y las versiones de la API admitidas del servicio:

Versión del SDK	Versión de la API admitidas del servicio
1.0.0-beta.1	2023-03-01-preview

Autenticar el cliente

Puede encontrar el punto de conexión del recurso del servicio Health Insights mediante Azure Portal o la CLI de 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"

Obtención de la clave de API

Puede obtener la clave de API del recurso del servicio Health Insights en Azure Portal. Como alternativa, puede usar el siguiente fragmento de código de la CLI de Azure para obtener la clave de API del recurso.

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

Creación de ClinicalMatchingClient con AzureKeyCredential

Una vez que tenga el valor de la clave de API, cree un AzureKeyCredential. Con el punto de conexión y la credencial de clave, puede crear :ClinicalMatchingClient

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

Conceptos clave

Trial Matcher proporciona al usuario de los servicios dos modos principales de funcionamiento: pacientes centrados en ensayos clínicos y centrados en ensayos clínicos.

En el modo centrado en el paciente, el modelo del buscador de coincidencias de prueba basa la coincidencia de pacientes en la condición clínica, la ubicación, las prioridades, los criterios de idoneidad y otros criterios que los usuarios del paciente o del servicio pueden elegir priorizar. El modelo ayuda a reducir y priorizar el conjunto de ensayos clínicos pertinentes a un conjunto más pequeño de ensayos con los que empezar, que parece que el paciente específico es calificado.
En el ensayo clínico centrado, el buscador de coincidencias de ensayos está buscando un grupo de pacientes potencialmente aptos para un ensayo clínico. El buscador de coincidencias de ensayo reduce los pacientes, primero filtrados sobre la condición clínica y las observaciones clínicas seleccionadas y, a continuación, se centra en aquellos pacientes que cumplen los criterios de línea base, para encontrar el grupo de pacientes que parecen ser pacientes aptos para un ensayo.

Ejemplos

Pruebas de coincidencia

Pruebas de coincidencia

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

Solución de problemas

Configuración del registro de la consola

La manera más sencilla de ver los registros es habilitar el registro de la consola. Para crear un agente de escucha de registro del SDK de Azure que genere mensajes en la consola, use el método AzureEventSourceListener.CreateConsoleLogger.

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

Para más información sobre otros mecanismos de registro, consulte Ejemplos de diagnóstico.

Pasos siguientes

Documentación adicional

Para obtener documentación más amplia sobre La coincidencia clínica de Azure Health Insights, consulte la documentación de Coincidencia clínica en docs.microsoft.com.

Contribuciones

Este proyecto agradece las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia para el colaborador (CLA) que declara que tiene el derecho a concedernos y nos concede los derechos para usar su contribución. Para obtener más información, visite cla.microsoft.com.

Cuando se envía una solicitud de incorporación de cambios, un bot de CLA determinará de forma automática si tiene que aportar un CLA y completar la PR adecuadamente (por ejemplo, la etiqueta, el comentario). Solo siga las instrucciones que le dará el bot. Solo será necesario que lo haga una vez en todos los repositorios con nuestro CLA.

Este proyecto ha adoptado el Código de conducta de Microsoft Open Source. Para más información, consulte las preguntas más frecuentes del código de conducta o póngase en contacto con opencode@microsoft.com si tiene cualquier otra pregunta o comentario.

Compartir a través de