.NET용 Azure Cognitive Services Health Insights 임상 일치 클라이언트 라이브러리 - 버전 1.0.0-beta.1

아티클
04/06/2023

Health Insights 는 여러 Cognitive Services, Healthcare API 서비스 및 기타 Azure 리소스를 활용하는 Azure Cognitive Services 프레임워크를 사용하여 빌드된 Azure Applied AI Service입니다.

임상 일치 모델은 환자 데이터 및 임상 시험 프로토콜을 수신하고 자격 기준에 따라 관련 임상 시험을 제공합니다.

소스 코드 | 패키지(NuGet) | API 참조 설명서 | 제품 설명서

시작

필수 조건

이 패키지를 사용하려면 Azure 구독 이 필요합니다.
기존 Cognitive Services Health Insights instance.

패키지 설치

NuGet을 사용하여 .NET용 Azure Health Insights 클라이언트 Clinical Matchinglibrary를 설치합니다.

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

다음 표에서는 SDK 버전 및 지원되는 API 버전의 서비스 간 관계를 보여 줍니다.

SDK 버전	지원되는 API 버전의 서비스
1.0.0-beta.1	2023-03-01-preview

클라이언트 인증

Azure Portal 또는 Azure CLI를 사용하여 Health Insights 서비스 리소스에 대한 엔드포인트를 찾을 수 있습니다.

# 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 키 가져오기

Azure Portal의 Health Insights 서비스 리소스에서 API 키를 가져올 수 있습니다. 또는 아래 의 Azure CLI 코드 조각을 사용하여 리소스의 API 키를 가져올 수 있습니다.

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

AzureKeyCredential을 사용하여 ClinicalMatchingClient 만들기

API 키에 대한 값이 있으면 을 만듭니다 AzureKeyCredential. 엔드포인트 및 키 자격 증명을 사용하여 를 만들 ClinicalMatchingClient수 있습니다.

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

주요 개념

평가판 검사기는 서비스 사용자에게 두 가지 기본 작업 모드인 환자 중심 및 임상 시험 중심을 제공합니다.

환자 중심 모드에서 평가판 검사기 모델은 환자 및/또는 서비스 사용자가 우선 순위를 지정할 수 있는 임상 상태, 위치, 우선 순위, 자격 기준 및 기타 기준에 따라 환자 일치를 기반으로 합니다. 이 모델은 특정 환자가 자격을 갖춘 것으로 보이는 더 작은 임상 시험 세트로 관련 임상 시험 세트를 좁히고 우선 순위를 지정하는 데 도움이됩니다.
임상 시험 중심에서, 평가판 검사기는 잠재적으로 임상 시험에 자격이 있는 환자의 그룹을 찾고 있습니다. 예심 검사기는 임상 상태에 첫째로 필터링되고 선택된 임상 관측을 가진 환자를 좁혀, 그 후에 기준 기준을 충족한 그 환자에 집중합니다, 예심에 적격한 환자인 것처럼 보이는 환자의 단을 찾아내기 위하여.

예제

평가판 일치

평가판 일치

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-bot은 CLA를 제공하고 PR을 적절하게 데코레이팅해야 하는지 여부를 자동으로 결정합니다(예: 레이블, 설명). 봇에서 제공하는 지침을 따르기만 하면 됩니다. 이 작업은 CLA를 사용하여 모든 리포지토리에서 한 번만 수행하면 됩니다.

이 프로젝트에는 Microsoft Open Source Code of Conduct(Microsoft 오픈 소스 준수 사항)가 적용됩니다. 자세한 내용은 Code of Conduct FAQ(규정 FAQ)를 참조하세요. 또는 추가 질문이나 의견은 opencode@microsoft.com으로 문의하세요.

다음을 통해 공유