Клиентская библиотека azure Cognitive Services Health Insights для .NET, версия 1.0.0-beta.1

Статья
04/06/2023

Health Insights — это служба прикладного ИИ Azure, созданная с помощью Azure Cognitive Services Framework, которая использует несколько Cognitive Services, службы API для здравоохранения и другие ресурсы Azure.

Модель клинического сопоставления получает данные пациентов и протоколы клинических испытаний, а также предоставляет соответствующие клинические испытания на основе критериев соответствия.

Исходный код | Пакет (NuGet) | Справочная документация по | API Документация по продукту

Начало работы

Предварительные требования

Для использования этого пакета требуется подписка Azure .
Существующий экземпляр Cognitive Services Health Insights.

Установка пакета

Установите клиент Azure Health Insights Clinical Matchinglibrary для .NET с помощью NuGet:

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

В этой таблице показано отношение между версиями пакета SDK и поддерживаемыми версиями API службы:

Версия пакета SDK	Поддерживаемая версия API службы
1.0.0-beta.1	2023-03-01-preview

Аутентификация клиента

Вы можете найти конечную точку для ресурса службы Health Insights с помощью портала Azure или 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"

Получение ключа API

Ключ API можно получить из ресурса службы Health Insights на портале Azure. Кроме того, вы можете использовать приведенный ниже фрагмент кода Azure CLI , чтобы получить ключ API ресурса.

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

Создание ClinicalMatchingClient с помощью AzureKeyCredential

Получив значение для ключа API, создайте AzureKeyCredential. С помощью конечной точки и учетных данных ключа можно создать ClinicalMatchingClient:

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

Основные понятия

Пробная версия Matcher предоставляет пользователю служб два main режимов работы: пациентов и клинических испытаний.

В режиме, ориентированном на пациента, модель пробного сопоставителя основывает сопоставление пациента на клиническом состоянии, расположении, приоритетах, критериях соответствия и других критериях, которые могут быть выбраны пользователями пациентов и служб. Модель помогает сузить и приоритизировать набор соответствующих клинических испытаний до меньшего набора испытаний, чтобы начать с, что конкретный пациент, как представляется, имеет право на.
На клинических испытаниях, ориентированных, пробный Матчер находит группу пациентов, потенциально имеющих право на клиническое испытание. Пробный matcher сужает пациентов, сначала отфильтровывается по клиническому состоянию и выбранным клиническим наблюдениям, а затем фокусируется на тех пациентах, которые соответствовали базовым критериям, чтобы найти группу пациентов, которые, как представляется, имеют право на участие в испытании.

Примеры

Сопоставление пробных версий

Сопоставление пробных версий

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

Устранение неполадок

Настройка ведения журнала консоли

Самый простой способ просмотреть журналы — включить ведение журнала консоли. Чтобы создать прослушиватель журнала пакета Azure SDK, который выводит сообщения в консоль, используйте метод AzureEventSourceListener.CreateConsoleLogger.

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

Дополнительные сведения о других механизмах ведения журнала см. в разделе Примеры диагностики.

Дальнейшие действия

Дополнительная документация

Более подробную документацию по клиническому сопоставлению Azure Health Insights см. в документации по клиническому сопоставлению по docs.microsoft.com.

Участие

На этом проекте приветствуются публикации и предложения. Для участия в большинстве процессов по разработке документации необходимо принять лицензионное соглашение участника (CLA), в котором указывается, что вы предоставляете нам права на использование ваших публикаций. Дополнительные сведения см. на странице cla.microsoft.com.

При отправке запроса на включение внесенных изменений CLA-бот автоматически определит необходимость предоставления соглашения CLA и соответствующего оформления запроса на включение внесенных изменений (например, добавление метки, комментария). Просто следуйте инструкциям бота. Будет достаточно выполнить их один раз для всех репозиториев, поддерживающих соглашение CLA.

В рамках этого проекта действуют правила поведения в отношении продуктов с открытым исходным кодом Майкрософт. Дополнительные сведения см. в разделе часто задаваемых вопросов о правилах поведения или обратитесь к opencode@microsoft.com с любыми дополнительными вопросами или комментариями.