Schnellstart: Verwenden des Radiology Insights-Modells
Dieser Schnellstart bietet eine Übersicht über die Verwendung von Radiology Insights.
Voraussetzungen
Um das Radiology Insights-Modell (Preview) verwenden zu können, muss ein Azure KI Health Insights-Dienst vorhanden sein.
Wenn Sie nicht über einen Azure KI Health Insights-Dienst verfügen, finden Sie weitere Informationen unter Bereitstellen von Azure KI Health Insights mithilfe des Azure-Portals.
Nach Abschluss der Bereitstellung verwenden Sie das Azure-Portal, um zum neu erstellten Azure KI Health Insights-Dienst zu navigieren. Dort finden Sie die Details einschließlich Ihrer Dienst-URL.
Die Dienst-URL für den Zugriff auf Ihren Dienst lautet: https://YOUR-NAME.cognitiveservices.azure.com/.
Beispielanforderung und -ergebnisse
Zum Senden einer API-Anforderung benötigen Sie den Endpunkt und den Schlüssel Ihres Azure KI Health Insights-Diensts.
Hier finden Sie auch eine vollständige Ansicht der Anforderungsparameter.
Wichtig
Die Vorhersage wird nach Erhalt der API-Anforderung durchgeführt, und die Ergebnisse werden asynchron zurückgegeben. Die API-Ergebnisse sind ab dem Zeitpunkt, an dem die Anforderung erfasst wurde, 24 Stunden lang verfügbar und werden in der Antwort angegeben. Nach diesem Zeitraum werden die Ergebnisse endgültig gelöscht und stehen nicht mehr zum Abruf zur Verfügung.
Beispielanforderung
Hinweis
Die Beispiele unten basieren auf der API-Version 2024-04-01. Zwischen API-Versionen können Änderungen vorkommen. Für eine bestimmte API-Version verwenden Sie bitte den Verweis auf die REST-API, um eine vollständige Beschreibung anzuzeigen.
Starten mit einer Anforderung, die einen Fall enthält
Sie können die Daten aus diesem Beispiel verwenden, um Ihre erste Anforderung für das Radiology Insights-Modell zu testen.
Definition {jobid}
- unique identifier
- maximal 36 Zeichen
- keine Leerzeichen
PUT
https://{cognitive-services-account-endpoint}/health-insights/radiology-insights/jobs/{jobid}?api-version=2024-04-01
Content-Type: application/json
Ocp-Apim-Subscription-Key: {cognitive-services-account-key}
{
"jobData": {
"configuration": {
"inferenceOptions": {
"followupRecommendationOptions": {
"includeRecommendationsWithNoSpecifiedModality": false,
"includeRecommendationsInReferences": false,
"provideFocusedSentenceEvidence": false
},
"findingOptions": {
"provideFocusedSentenceEvidence": false
}
},
"inferenceTypes": ["lateralityDiscrepancy"],
"locale": "en-US",
"verbose": false,
"includeEvidence": false
},
"patients": [
{
"id": "111111",
"details": {
"sex": "female",
"birthDate" : "1986-07-01T21:00:00+00:00",
"clinicalInfo": [
{
"resourceType": "Observation",
"status": "unknown",
"code": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls",
"code": "C0018802",
"display": "MalignantNeoplasms"
}
]
},
"valueBoolean": "true"
}
]
},
"encounters": [
{
"id": "encounterid1",
"period": {
"start": "2021-8-28T00:00:00",
"end": "2021-8-28T00:00:00"
},
"class": "inpatient"
}
],
"patientDocuments": [
{
"type": "note",
"clinicalType": "radiologyReport",
"id": "docid1",
"language": "en",
"authors": [
{
"id": "authorid1",
"fullName": "authorname1"
}
],
"specialtyType": "radiology",
"createdAt": "2021-8-28T00:00:00",
"administrativeMetadata": {
"orderedProcedures": [
{
"code": {
"coding": [
{
"system": "https://loinc.org",
"code": "26688-1",
"display": "US BREAST - LEFT LIMITED"
}
]
},
"description": "US BREAST - LEFT LIMITED"
}
],
"encounterId": "encounterid1"
},
"content": {
"sourceType": "inline",
"value" : "Exam: US LT BREAST TARGETED\r\n\r\nTechnique: Targeted imaging of the right breast is performed.\r\n\r\nFindings:\r\n\r\nTargeted imaging of the left breast is performed from the 6:00 to the 9:00 position. \r\n\r\nAt the 6:00 position, 5 cm from the nipple, there is a 3 x 2 x 4 mm minimally hypoechoic mass with a peripheral calcification. This may correspond to the mammographic finding. No other cystic or solid masses visualized.\r\n"
}
}
]
}
]
}
}
Hier finden Sie auch eine vollständige Ansicht der Anforderungsparameter.
Auswerten einer Antwort, die einen Fall enthält
Sie erhalten den Status des Auftrags, indem Sie eine Anforderung an das Radiology Insights-Modell senden und die Auftrags-ID aus der anfänglichen Anforderung in der URL hinzufügen.
Beispielcodeschnipsel:
GET
https://{cognitive-services-account-endpoint}/health-insights/radiology-insights/jobs/{jobid}?api-version=2024-04-01
Ocp-Apim-Subscription-Key: {cognitive-services-account-key}
{
"result": {
"patientResults": [
{
"patientId": "11111",
"inferences": [
{
"kind": "lateralityDiscrepancy",
"lateralityIndication": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "24028007",
"display": "RIGHT (QUALIFIER VALUE)"
}
]
},
"discrepancyType": "orderLateralityMismatch"
}
]
}
]
},
"id": "jobid",
"createdDateTime": "2023-12-18T12:25:37.8942771Z",
"expirationDateTime": "2023-12-18T12:42:17.8942771Z",
"lastUpdateDateTime": "2023-12-18T12:25:49.7221986Z",
"status": "succeeded"
}
Hier finden Sie auch eine vollständige Ansicht der Anforderungsparameter.
Datengrenzwerte
Grenzwert, Wert
- Maximale Anzahl von Patient*innen pro Anforderung, 1
- Maximale Anzahl von Patientendokumenten pro Anforderung, 1
- Maximale Anzahl von Begegnungen pro Anforderung, 1
- Maximale Anzahl von Zeichen pro Patient*in, insgesamt 50.000 für alle data[i].content.value
Anforderungsvalidierung
Jede Anforderung enthält Pflichtfelder und optionale Felder, die für das Radiology Insights-Modell bereitgestellt werden sollten. Achten Sie beim Senden von Daten an das Modell darauf, dass Sie die folgenden Eigenschaften berücksichtigen:
Innerhalb einer Anforderung:
- „patients“ sollte festgelegt werden.
- „patients“ sollte genau einen Eintrag enthalten.
- Die ID im Eintrag „patients“ sollte festgelegt werden.
Innerhalb der Konfiguration: Bei Festlegung sollte das Konfigurationsgebietsschema einen der folgenden Werte aufweisen (Groß-/Kleinschreibung wird nicht beachtet):
- en-CA
- de-De
- en-AU
- en-DE
- en-IE
- en-NZ
- en-GB
Innerhalb von „patients“:
- sollte einen Eintrag „patientDocument“ enthalten
- ID in „patientDocument“ sollte festgelegt werden.
- Wenn Begegnungen oder Informationen verwendet werden, sollte die ID festgelegt werden.
Für „patientDocuments“ für einen Patienten:
- „createdDateTime“ („serviceDate“) sollte festgelegt werden
- Die Sprache des Patientendokuments sollte „EN“ sein (Groß-/Kleinschreibung wird nicht beachtet).
- documentType sollte auf Notiz festgelegt werden (Groß-/Kleinschreibung wird nicht beachtet)
- Die Variable clinicalType des Patientendokuments sollte auf radiologyReport oder pathologyReport festgelegt werden (Groß-/Kleinschreibung wird nicht beachtet, in einem Wort)
- „specialtyType“ für das Patientendokument sollte auf „radiology“ oder „pathology“ festgelegt werden.
- Bei Festlegung sollte „orderedProcedures“ in „administrativeMetadata“ Code – mit Code und Anzeige – und eine Beschreibung enthalten.
- Der Dokumentinhalt darf nicht inhaltslos/leer/NULL sein.
Optional: sex und birthDate sind optionale Felder.
"patientDocuments" : [ {
"type" : "note",
"clinicalType" : "radiologyReport",
"id" : "docid1",
"language" : "en",
"authors" : [ {
"id" : "authorid1",
"name" : "authorname1"
} ],
"specialtyType" : "radiology",
"createdDateTime" : "2021-8-28T00:00:00",
"administrativeMetadata" : {
"orderedProcedures" : [ {
"code" : {
"coding" : [ {
"system" : "https://loinc.org",
"code" : "41806-1",
"display" : "CT ABDOMEN"
} ]
},
"description" : "CT ABDOMEN"
} ],
"encounterId" : "encounterid1"
},
"content" : {
"sourceType" : "inline",
"value" : "CT ABDOMEN AND PELVIS\n\nProvided history: \n78 years old Female\nAbnormal weight loss\n\nTechnique: Routine protocol helical CT of the abdomen and pelvis were performed after the injection of intravenous nonionic iodinated contrast. Axial, Sagittal and coronal 2-D reformats were obtained. Oral contrast was also administered.\n\nFindings:\nLimited evaluation of the included lung bases demonstrates no evidence of abnormality. \n\nGallbladder is absent. "
}
} ]
Nächste Schritte
Um einen besseren Einblick in die Anforderungen und Antworten zu erhalten, können Sie auf den folgenden Seiten weiterlesen: