Démarrage rapide : Utiliser le modèle Radiology Insights
Ce démarrage rapide fournit une présentation de la façon d’utiliser Radiology Insights.
Prérequis
Pour utiliser le modèle Radiology Insights (préversion), vous devez avoir un service Insights Santé Azure AI créé.
Si vous n’avez pas de service Insights Santé Azure AI, consultez Déployer Insights Santé Azure AI à l’aide du Portail Microsoft Azure.
Une fois le déploiement terminé, vous utilisez le portail Azure pour accéder au service Insights Santé Azure AI nouvellement créé pour voir les détails, y compris votre URL de service.
L'URL du service pour accéder à votre service est : https://YOUR-NAME.cognitiveservices.azure.com.
Exemple de requête et de résultats
Pour envoyer une demande d’API, vous avez besoin du point de terminaison et de la clé de votre service Insights Santé Azure AI.
Vous pouvez également trouver une vue complète des paramètres de la requête ici.
Important
La prédiction est effectuée à la réception de la requête d’API et les résultats sont retournés de manière asynchrone. Les résultats de l’API sont disponibles pendant 24 heures à partir du moment où la requête a été ingérée et sont indiqués dans la réponse. Après cette période, les résultats sont purgés et ne sont plus disponibles pour récupération.
Exemple de requête
Remarque
Les exemples ci-dessous sont basés sur la version de l’API du 01/04/2024. Il peut y avoir des modifications entre les versions de l’API. Pour obtenir une version spécifique de l’API, veuillez utiliser la référence à l’API REST pour afficher une description complète.
À partir d’une requête qui contient un cas
Vous pouvez utiliser les données de cet exemple pour tester votre première requête au modèle Radiology Insights.
Définition {jobid}
- Identificateur unique
- 36 caractères au maximum
- aucun espace
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"
}
}
]
}
]
}
}
Vous pouvez également trouver une vue complète des paramètres de la requête ici.
Évaluation d’une réponse qui contient un cas
Vous obtenez le statut de la tâche en envoyant une requête au modèle Radiology Insights en ajoutant l'ID de tâche de la requête initiale dans l'URL.
Exemple d'extrait de code :
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"
}
Vous pouvez également trouver une vue complète des paramètres de la requête ici.
Limites de données
Limite, valeur
- # maximal de patients par requête, 1
- # maximum de documents patient par requête : 1
- # maximum de rencontres par requête : 1
- # maximum de caractères par patient, 50 000 pour data[i].content.value tous combinés
Validation des demandes
Chaque requête contient des champs obligatoires et facultatifs qui doivent être fournis au modèle Radiology Insights. Lorsque vous envoyez des données au modèle, veillez à prendre en compte les propriétés suivantes :
Dans une requête :
- les patients doivent être définis
- les patients doivent contenir une entrée
- L’ID dans l’entrée des patients doit être défini
Dans la configuration : si elles sont définies, les paramètres régionaux de configuration doivent être l'une des valeurs suivantes (insensible à la casse) :
- en-CA
- fr-FR
- en-AU
- en-DE
- en-IE
- en-NZ
- en-GB
Au sein des patients :
- doit contenir une entrée patientDocument
- L'ID dans patientDocument doit être défini
- si des rencontres et/ou des informations sont utilisées, l'identifiant doit être défini
Pour les documents patient au sein d'un patient :
- createDateTime (serviceDate) doit être défini
- La langue du document patient doit être EN (insensible à la casse)
- documentType doit être défini sur note (sans sensibilité à la casse)
- Le champ clinicalType du document patient doit être défini sur radiologyReport ou pathologyReport (sans sensibilité à la casse, en un seul mot)
- Le type de spécialité du document patient doit être radiologie ou pathologie
- Si défini, les procédures ordonnées dans les métadonnées administratives doivent contenir du code – avec code et affichage – et une description
- Le contenu du document ne doit pas être vide/vide/nul
Facultatif : le sexe et la date de naissance sont des champs facultatifs.
"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. "
}
} ]
Étapes suivantes
Pour obtenir de meilleurs insights sur la requête et les réponses, vous pouvez en savoir plus dans les pages suivantes :