Bibliothèque de client Azure Cognitive Services Health Insights Clinical Matching pour .NET - version 1.0.0-beta.1

  • Article

Health Insights est un service Azure Applied AI créé avec Azure Cognitive Services Framework, qui tire parti de plusieurs Cognitive Services, services d’API santé et autres ressources Azure.

Le modèle de correspondance clinique reçoit les données des patients et les protocoles d’essais cliniques, et fournit des essais cliniques pertinents basés sur des critères d’éligibilité.

| Code sourcePackage (NuGet) | Documentation de référence sur les | API Documentation produit

Prise en main

Prérequis

  • Vous avez besoin d’un abonnement Azure pour utiliser ce package.
  • Un instance Cognitive Services Health Insights existant.

Installer le package

Installez la bibliothèque de correspondance clinique du client Azure Health Insights pour .NET avec NuGet :

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

Ce tableau montre la relation entre les versions du kit de développement logiciel (SDK) et les versions d’API prises en charge du service :

Version du SDK Version d’API prise en charge du service
1.0.0-beta.1 Préversion du 01/03/2023

Authentifier le client

Vous pouvez trouver le point de terminaison de votre ressource de service Health Insights à l’aide du portail Azure ou d’Azure CLI.

# Get the endpoint for the Health Insights service resource
az cognitiveservices account show --name "resource-name" --resource-group "resource-group-name" --query "properties.endpoint"

Obtenir la clé API

Vous pouvez obtenir la clé API à partir de la ressource du service Health Insights dans le portail Azure. Vous pouvez également utiliser l’extrait de code Azure CLI ci-dessous pour obtenir la clé API de votre ressource.

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

Créer ClinicalMatchingClient avec AzureKeyCredential

Une fois que vous avez la valeur de la clé API, créez un AzureKeyCredential. Avec le point de terminaison et les informations d’identification de clé, vous pouvez créer le ClinicalMatchingClient:

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

Concepts clés

Trial Matcher fournit à l’utilisateur des services deux modes de fonctionnement main : centré sur les patients et centré sur les essais cliniques.

  • En mode centré sur le patient, le modèle Trial Matcher base la correspondance du patient sur l’état clinique, l’emplacement, les priorités, les critères d’éligibilité et d’autres critères que le patient et/ou les utilisateurs du service peuvent choisir de hiérarchiser. Le modèle permet d’affiner et de hiérarchiser l’ensemble des essais cliniques pertinents à un ensemble plus petit d’essais pour revenir au début, pour lequel le patient spécifique semble être qualifié.
  • En ce qui concerne les essais cliniques centrés, l’Essai Matcher trouve un groupe de patients potentiellement éligibles à un essai clinique. Le matcheur d’essai réduit les patients, d’abord filtrés sur l’état clinique et les observations cliniques sélectionnées, puis se concentre sur les patients qui répondent aux critères de base, pour trouver le groupe de patients qui semble être des patients éligibles à un essai.

Exemples

Mettre en correspondance les essais

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

Résolution des problèmes

Configuration de la journalisation de la console

Le moyen le plus simple de voir les journaux consiste à activer la journalisation de la console. Pour créer un écouteur de journal du SDK Azure qui génère des messages dans la console, utilisez la méthode AzureEventSourceListener.CreateConsoleLogger.

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

Pour en savoir plus sur les autres mécanismes de journalisation, consultez Exemples de diagnostics.

Étapes suivantes

Documentation complémentaire

Pour obtenir une documentation plus complète sur la correspondance clinique Azure Health Insights, consultez la documentation relative à la correspondance clinique sur docs.microsoft.com.

Contribution

Ce projet accepte les contributions et les suggestions. La plupart des contributions vous demandent d’accepter un contrat de licence de contribution (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez réellement, les droits d’utilisation de votre contribution. Pour plus d’informations, visitez cla.microsoft.com.

Quand vous envoyez une demande de tirage (pull request), un bot CLA détermine automatiquement si vous devez fournir un contrat CLA et agrémenter la demande de tirage de façon appropriée (par exemple, avec une étiquette ou un commentaire). Suivez simplement les instructions fournies par le bot. Vous ne devez effectuer cette opération qu’une seule fois sur tous les dépôts utilisant notre contrat CLA.

Ce projet a adopté le Code de conduite Open Source de Microsoft. Pour plus d’informations, consultez les Questions fréquentes (FAQ) sur le code de conduite ou envoyez vos questions ou vos commentaires à opencode@microsoft.com.