Início Rápido: usar o modelo do Radiology Insights
Este início rápido fornece uma visão geral de como usar o Radiology Insights.
Pré-requisitos
Para usar o modelo do Radiology Insights (Versão prévia), você precisa ter um serviço de Informações de Integridade de IA do Azure criado.
Se você não tiver nenhum serviços de Informações de Integridade de IA do Azure, consulte Implantar as Informações de Integridade de IA do Azure usando o portal do Microsoft Azure.
Após a implantação ter sido concluída, use o portal do Azure para navegar até a conta dos serviços de Informações de Integridade de IA do Azure recém-criada e ver os detalhes, incluindo a URL do seu serviço.
A URL do serviço para acessar seu serviço é: https://YOUR-NAME.cognitiveservices.azure.com.
Exemplo de solicitação e resultados
Para enviar uma solicitação de API, você precisa do ponto de extremidade e da chave do serviço de Informações de Integridade de IA do Azure.
Você também pode encontrar uma exibição completa dos parâmetros de solicitação aqui.
Importante
A previsão será realizada após o recebimento da solicitação da API e os resultados serão retornados de forma assíncrona. Os resultados da API estão disponíveis por 24 horas a partir do momento em que a solicitação foi ingerida e são indicados na resposta. Após esse período de tempo, os resultados são limpos e não estão mais disponíveis para recuperação.
Solicitação de exemplo
Observação
Os exemplos abaixo são baseados na versão da API 2024-04-01. Poderá haver alterações entre as versões de API. No caso de uma versão específica de API, use a referência à API REST para ver a descrição completa.
Começando com uma solicitação que contenha um caso
Você pode usar os dados desse exemplo para testar sua primeira solicitação para o modelo do Radiology Insights.
Definição {jobid}
- identificador exclusivo
- máximo de 36 caracteres
- não são permitidos espaços
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"
}
}
]
}
]
}
}
Você também pode encontrar uma exibição completa dos parâmetros de solicitação aqui.
Avaliando uma resposta que contenha um caso
Você obtém o status do trabalho enviando uma solicitação ao modelo do Radiology Insights, adicionando a ID do trabalho da solicitação inicial na URL.
Exemplo de trecho de código:
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"
}
Você também pode encontrar uma exibição completa dos parâmetros de solicitação aqui.
Limites de dados
Limite, valor
- Número máximo de pacientes por solicitação, 1
- Número máximo de documentos do paciente por solicitação, 1
- Número máximo de encontros por solicitação, 1
- Número máximo de caracteres por paciente, 50.000 para data[i].content.value todos combinados
Validação da solicitação
Cada solicitação contém campos obrigatórios e opcionais que devem ser fornecidos ao modelo do Radiology Insights. Ao enviar dados para o modelo, certifique-se de levar em consideração as seguintes propriedades:
Dentro de uma solicitação:
- os pacientes devem ser definidos
- Os pacientes devem conter uma entrada
- A ID na entrada do paciente deve ser definida
Na configuração: se definido, o local da configuração deve ser um dos seguintes valores (não diferencia maiúsculas de minúsculas):
- en-CA
- en-US
- en-AU
- en-DE
- en-IE
- en-NZ
- en-GB
Dentro dos pacientes:
- deve conter uma entrada patientDocument
- A ID no patientDocument deve estar definida
- se encontros e/ou informações forem usados, a ID deverá ser definida
Para os patientDocuments em um paciente:
- createdDateTime (serviceDate) deve ser definido
- O idioma do documento do paciente deve ser EN (não diferencia maiúsculas de minúsculas)
- documentType deve ser definido como observação (não diferencia maiúsculas de minúsculas)
- Patient Document clinicalType deve ser definido como radiologyReport ou pathologyReport (não diferencia maiúsculas de minúsculas, em uma palavra)
- O Documento do Paciente specialtyType deve ser radiologia ou patologia
- Se definido, orderedProcedures em administrativeMetadata deverá conter código, com código e exibição, e descrição
- O conteúdo do documento não deve estar em branco/vazio/nulo
Opcional: sex e birthDate são campos opcionais.
"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. "
}
} ]
Próximas etapas
Para obter melhores informações sobre a solicitação e as respostas, você pode ler mais nas páginas a seguir: