Azure Cognitive Services Health Insights Clinical Matching ügyfélkódtár a .NET-hez – 1.0.0-beta.1-es verzió
A Health Insights egy azure-beli alkalmazott AI-szolgáltatás, amely az Azure Cognitive Services-keretrendszerrel van létrehozva, amely több Cognitive Services- és Healthcare API-szolgáltatást és más Azure-erőforrásokat használ.
A Clinical Matching modell fogadja a betegek adatait és a klinikai vizsgálatok protokolljait, és a jogosultsági kritériumok alapján releváns klinikai vizsgálatokat biztosít.
Forráskód | Csomag (NuGet) | API-referenciadokumentáció | Termékdokumentáció
Első lépések
Előfeltételek
- A csomag használatához Azure-előfizetésre van szüksége.
- Egy meglévő Cognitive Services Health Insights-példány.
A csomag telepítése
Telepítse a .NET-hez készült Azure Health Insights-ügyfél klinikai matchinglibraryt a NuGettel:
dotnet add package Azure.Health.Insights.ClinicalMatching --prerelease
Ez a táblázat a szolgáltatás SDK-verziói és támogatott API-verziói közötti kapcsolatot mutatja be:
SDK verziója | A szolgáltatás támogatott API-verziója |
---|---|
1.0.0-beta.1 | 2023-03-01-preview |
Az ügyfél hitelesítése
A Health Insights szolgáltatás erőforrásának végpontját az Azure Portal vagy az Azure CLI használatával találja meg
# Get the endpoint for the Health Insights service resource
az cognitiveservices account show --name "resource-name" --resource-group "resource-group-name" --query "properties.endpoint"
Az API-kulcs lekérése
Az API-kulcsot az Azure Portal Health Insights szolgáltatás-erőforrásából szerezheti be. Másik lehetőségként az alábbi Azure CLI-kódrészlettel lekérheti az erőforrás API-kulcsát.
az cognitiveservices account keys list --resource-group <your-resource-group-name> --name <your-resource-name>
ClinicalMatchingClient létrehozása az AzureKeyCredential használatával
Miután megkapta az API-kulcs értékét, hozzon létre egy AzureKeyCredential
. A végpont és a kulcs hitelesítő adataival létrehozhatja a következőt ClinicalMatchingClient
:
string endpoint = "<endpoint>";
string apiKey = "<apiKey>";
var credential = new AzureKeyCredential(apiKey);
var client = new ClinicalMatchingClient(new Uri(endpoint), credential);
Fő fogalmak
A Trial Matcher a szolgáltatások felhasználójának két fő működési módot nyújt: a betegek központú és a klinikai vizsgálat központú.
- A betegközpontú módban a Próbaegyeztető modell a beteget a klinikai állapot, a hely, a prioritások, a jogosultsági feltételek és egyéb feltételek alapján állítja össze, amelyeket a beteg és/vagy a szolgáltatás felhasználói rangsorolhatnak. A modell segít leszűkíteni és rangsorolni a releváns klinikai vizsgálatok halmazát egy kisebb, az adott betegnek megfelelőnek tűnő vizsgálathalmazra.
- A klinikai vizsgálat központú, a Trial Matcher olyan betegek csoportját keresi, akik potenciálisan jogosultak a klinikai vizsgálatra. A Trial Matcher leszűkíti a betegeket, először a klinikai állapotra szűr, majd kiválasztja a klinikai megfigyeléseket, majd azokra a betegekre összpontosít, akik megfelelnek az alapfeltételeknek, hogy megtalálják azoknak a betegeknek a csoportját, akik úgy tűnik, hogy jogosultak a vizsgálatra.
Példák
Próbaverziók egyeztetése
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}");
}
}
Hibaelhárítás
Konzolnaplózás beállítása
A naplók megtekintésének legegyszerűbb módja a konzolnaplózás engedélyezése. Ha olyan Azure SDK-naplófigyelőt szeretne létrehozni, amely üzeneteket küld a konzolra, használja az AzureEventSourceListener.CreateConsoleLogger metódust.
// Setup a listener to monitor logged events.
using AzureEventSourceListener listener = AzureEventSourceListener.CreateConsoleLogger();
További információ az egyéb naplózási mechanizmusokról: Diagnosztikai minták.
Következő lépések
További dokumentáció
Az Azure Health Insights klinikai egyeztetésével kapcsolatos részletesebb dokumentációért tekintse meg a Klinikai egyeztetés dokumentációját a docs.microsoft.com.
Közreműködés
A projektben szívesen fogadjuk a hozzájárulásokat és a javaslatokat. A legtöbb hozzájáruláshoz el kell fogadnia egy Közreműködői licencszerződést (CLA-t), amelyben kijelenti, hogy jogosult arra, hogy ránk ruházza hozzájárulása felhasználási jogát, és ezt ténylegesen meg is teszi. A részletekért látogasson el a cla.microsoft.com.
A lekéréses kérelmek elküldésekor egy CLA-robot automatikusan meghatározza, hogy kell-e biztosítania CLA-t, és megfelelően kitölti a lekéréses kérelmet (például címke, megjegyzés). Egyszerűen csak kövesse a robot által megadott utasításokat. Ezt csak egyszer kell elvégeznie az összes olyan tárházban, amely a CLA-t használja.
A projekt a Microsoft nyílt forráskódú projekteket szabályozó etikai kódexe, a Microsoft Open Source Code of Conduct hatálya alá esik. További információkért lásd a viselkedési szabályzattal kapcsolatos gyakori kérdéseket , vagy vegye fel a kapcsolatot opencode@microsoft.com az esetleges további kérdésekkel vagy megjegyzésekkel.
Azure SDK for .NET
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: