適用于 .NET 的 Azure 認知服務健康情況深入解析臨床比對用戶端程式庫 - 1.0.0-Beta.1 版

發行項
04/06/2023

Health Insights 是使用 Azure 認知服務架構建置的 Azure 套用 AI 服務，可運用多個認知服務、醫療保健 API 服務和其他 Azure 資源。

臨床比對模型會接收病患資料和臨床實驗通訊協定，並根據資格準則提供相關的臨床實驗。

| 原始程式碼套件 (NuGet) | API 參考檔 | 產品檔

開始使用

Prerequisites

您需要 Azure 訂用帳戶才能使用此套件。
現有的認知服務健康情況深入解析實例。

安裝套件

使用 NuGet安裝適用于 .NET 的 Azure Health Insights 用戶端臨床比對程式庫：

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

下表顯示 SDK 版本與服務支援的 API 版本之間的關聯性：

SDK 版本	服務支援的 API 版本
1.0.0-Beta.1	2023-03-01-preview

驗證用戶端

您可以使用Azure入口網站或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 入口網站中的 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 (例如標籤、註解)。請遵循 bot 提供的指示。您只需要使用我們的 CLA 在所有存放庫上執行此動作一次。

此專案採用 Microsoft Open Source Code of Conduct (Microsoft 開放原始碼管理辦法)。如需詳細資訊，請參閱管理辦法常見問題集，如有任何其他問題或意見請連絡 opencode@microsoft.com。

共用方式為