Guida introduttiva: Usare il modello Di Radiologia Insights
Questo argomento di avvio rapido offre una panoramica su come usare Le informazioni dettagliate sull'uso di Radiologia.
Prerequisiti
Per usare il modello di Informazioni dettagliate di Radiologia (anteprima), è necessario avere creato un servizio Azure AI Health Insights.
Se non si dispone di un servizio Azure AI Health Insights, vedere Distribuire Informazioni dettagliate sull'integrità dell'intelligenza artificiale di Azure usando il portale di Azure.
Al termine della distribuzione, usare il portale di Azure per passare al servizio Azure AI Health Insights appena creato per visualizzare i dettagli, incluso l'URL del servizio.
L'URL del servizio per accedere al servizio è: https://YOUR-NAME.cognitiveservices.azure.com.
Richiesta e risultati di esempio
Per inviare una richiesta API, è necessario l'endpoint e la chiave del servizio Azure AI Health Insights.
È anche possibile trovare una visualizzazione completa dei parametri della richiesta qui.
Importante
La stima viene eseguita al ricevimento della richiesta API e i risultati verranno restituiti in modo asincrono. I risultati dell'API sono disponibili per 24 ore dal momento in cui la richiesta è stata inserita ed è indicata nella risposta. Dopo questo periodo di tempo, i risultati vengono rimossi e non sono più disponibili per il recupero.
Richiesta di esempi
Nota
Gli esempi seguenti sono basati sulla versione dell'API 2024-04-01. Potrebbero esserci modifiche tra le versioni dell'API. Per una versione api specifica, usare il riferimento all'API REST per visualizzare la descrizione completa.
A partire da una richiesta che contiene un caso
È possibile usare i dati di questo esempio per testare la prima richiesta al modello Di Insights di Radiologia.
Definizione {jobid}
- unique identifier
- massimo 36 caratteri
- senza spazi
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"
}
}
]
}
]
}
}
È anche possibile trovare una visualizzazione completa dei parametri della richiesta qui.
Valutazione di una risposta che contiene un caso
Per ottenere lo stato del processo, inviare una richiesta al modello Di Radiologia Insights aggiungendo l'ID processo dalla richiesta iniziale nell'URL.
Frammento di codice di esempio:
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"
}
È anche possibile trovare una visualizzazione completa dei parametri della richiesta qui.
Limiti dei dati
Limit, Value
- Numero massimo di pazienti per richiesta, 1
- Numero massimo di documenti pazienti per richiesta, 1
- Numero massimo di incontri per richiesta, 1
- Numero massimo di caratteri per paziente, 50.000 per i dati[i].content.value combinati
Convalida delle richieste
Ogni richiesta contiene campi obbligatori e facoltativi che devono essere forniti al modello Di Insights di Radiologia. Quando si inviano dati al modello, assicurarsi di prendere in considerazione le proprietà seguenti:
All'interno di una richiesta:
- i pazienti devono essere impostati
- i pazienti devono contenere una voce
- L'ID nella voce dei pazienti deve essere impostato
All'interno della configurazione: se impostata, le impostazioni locali di configurazione devono essere uno dei valori seguenti (senza distinzione tra maiuscole e minuscole):
- en-CA
- en-US
- en-AU
- en-DE
- en-IE
- en-NZ
- En-GB
All'interno dei pazienti:
- deve contenere una voce patientDocument
- L'ID in patientDocument deve essere impostato
- se vengono usate informazioni e/o rilevazioni, l'ID deve essere impostato
Per il pazienteDocuments all'interno di un paziente:
- createdDateTime (serviceDate) deve essere impostato
- La lingua del documento dei pazienti deve essere EN (senza distinzione tra maiuscole e minuscole)
- documentType deve essere impostato su nota (senza distinzione tra maiuscole e minuscole)
- Patient Document clinicalType deve essere impostato su radiologiaReport o patologiaReport (senza distinzione tra maiuscole e minuscole, in una sola parola)
- La specializzazione documento pazienteTipo deve essere radiologia o patologia
- Se impostato, orderedProcedures in administrativeMetadata deve contenere codice con codice e visualizzazione e descrizione
- Il contenuto del documento non deve essere vuoto/vuoto/null
Facoltativo: sesso e birthDate sono campi facoltativi.
"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. "
}
} ]
Passaggi successivi
Per ottenere informazioni più dettagliate sulla richiesta e sulle risposte, è possibile leggere altre informazioni sulle pagine seguenti: