Trial Matcher - Get Job

Referencia

Servicio:: Cognitive Services

Versión de la API:: 2023-09-01-preview

Obtención de los detalles del trabajo del buscador de coincidencias de prueba
Obtiene el estado y los detalles del trabajo Del buscador de coincidencias de prueba.

GET {endpoint}/health-insights/trial-matcher/jobs/{id}?api-version=2023-09-01-preview

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string uri	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus2.api.cognitive.microsoft.com).
id	path	True	string uuid	Identificador de trabajo de procesamiento.
api-version	query	True	string	Versión de API que se usará para la operación.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Respuestas

Nombre	Tipo	Description
200 OK	TrialMatcherResult	La solicitud se ha realizado correctamente. Encabezados Retry-After: integer
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Nombre

Tipo

Description

200 OK

TrialMatcherResult

La solicitud se ha realizado correctamente.

Encabezados

Retry-After: integer

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Una respuesta de error inesperada.

Encabezados

x-ms-error-code: string

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

Ejemplos

Gets the status and details of the Trial Matcher job.

Solicitud de ejemplo

HTTP

GET {endpoint}/health-insights/trial-matcher/jobs/a4d3d73e-2be3-4ca1-bd4f-66a5bdd19754?api-version=2023-09-01-preview

Respuesta de muestra

status code:: 200

{
  "id": "a4d3d73e-2be3-4ca1-bd4f-66a5bdd19754",
  "createdDateTime": "2021-11-28T09:13:11.046Z",
  "expirationDateTime": "2021-11-28T09:13:11.046Z",
  "lastUpdateDateTime": "2021-11-28T09:13:11.046Z",
  "status": "succeeded",
  "result": {
    "patientResults": [
      {
        "patientId": "Patient ID Example 2",
        "inferences": [
          {
            "type": "trialEligibility",
            "value": "Eligible",
            "description": "SwEaTB - Diagnosing of Acute Tuberculosis",
            "confidenceScore": 1,
            "evidence": [
              {
                "eligibilityCriteriaEvidence": "In-patients with acute tuberculosis",
                "patientInfoEvidence": {
                  "system": "UMLS",
                  "code": "C0019046",
                  "name": "tuberculosis"
                },
                "importance": 1
              }
            ],
            "clinicalTrialId": "NCT03667742",
            "source": "clinicaltrials.gov",
            "metadata": {
              "phases": [
                "phase3"
              ],
              "studyType": "observational",
              "recruitmentStatus": "recruiting",
              "conditions": [
                "Tuberculosis"
              ],
              "sponsors": [
                "University Hospital, Basel, Switzerland"
              ],
              "contacts": [
                {
                  "name": "John Doe, PD Dr. Med",
                  "email": "John@contoso.com",
                  "phone": "+55-555-5555-55"
                }
              ],
              "facilities": [
                {
                  "name": "University Hospital, Basel",
                  "city": "Basel",
                  "countryOrRegion": "Switzerland"
                }
              ]
            }
          },
          {
            "type": "trialEligibility",
            "value": "Ineligible",
            "description": "Design of an Integrative Algorithm for Staging Tuberculosis (STAGE-TB)",
            "confidenceScore": 1,
            "evidence": [
              {
                "eligibilityCriteriaEvidence": "negative for Quantiferon- TB Gold Plus Test or ELISpot",
                "patientInfoEvidence": {
                  "system": "UMLS",
                  "code": "C0920508",
                  "name": "Enzyme-Linked Immunospot Assay",
                  "value": "30,000 PBMC cells per 10ul"
                },
                "importance": 1
              }
            ],
            "clinicalTrialId": "NCT03691883",
            "source": "clinicaltrials.gov"
          }
        ],
        "neededClinicalInfo": [
          {
            "system": "UMLS",
            "code": "C4317078",
            "name": "Mycobacterium Tuberculosis Measurement ",
            "semanticType": "Laboratory Procedure",
            "category": "EXAMINATION_NAME"
          },
          {
            "system": "UMLS",
            "code": "C0008031",
            "name": "Chest Pain",
            "semanticType": "Sign or Symptom",
            "category": "SYMPTOM_OR_SIGN"
          }
        ]
      }
    ],
    "modelVersion": "2021-10-28",
    "knowledgeGraphLastUpdateDate": "2021-11-26"
  }
}

Definiciones

Nombre	Description
Azure.Core.Foundations.Error	Objeto de error.
Azure.Core.Foundations.ErrorResponse	Respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError	Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
ClinicalCodedElement	Un fragmento de información clínica, expresado como código en un sistema de codificación clínica.
ClinicalNoteEvidence	Un fragmento de evidencia de una nota clínica (documento de texto).
ClinicalTrialMetadata	Datos de prueba que son de interés para el posible participante.
ClinicalTrialPhase	Posibles fases de un ensayo clínico.
ClinicalTrialRecruitmentStatus	Posible estado de reclutamiento de un ensayo clínico.
ClinicalTrialResearchFacility	Detalles de un centro de investigación donde se lleva a cabo un ensayo clínico.
ClinicalTrialSource	Posibles fuentes de un ensayo clínico.
ClinicalTrialStudyType	Posibles tipos de estudio de un ensayo clínico.
ContactDetails	Detalles de contacto de una persona.
ExtendedClinicalCodedElement	Un fragmento de información clínica, expresado como código en un sistema de codificación clínica, extendido por información semántica.
JobStatus	Estado del trabajo de procesamiento.
TrialMatcherInference	Una inferencia realizada por el modelo del buscador de coincidencias de prueba con respecto a un paciente.
TrialMatcherInferenceEvidence	Una prueba correspondiente a una inferencia del buscador de coincidencias de prueba.
TrialMatcherInferenceResult	Los resultados de la inferencia para la solicitud del buscador de coincidencias de prueba.
TrialMatcherInferenceType	Tipo de inferencia del buscador de coincidencias de prueba.
TrialMatcherPatientResult	Los resultados del trabajo del modelo para un solo paciente.
TrialMatcherResult	Respuesta de la solicitud del buscador de coincidencias de prueba.

Azure.Core.Foundations.Error

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	Azure.Core.Foundations.Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	Azure.Core.Foundations.InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Representación legible del error.
target	string	Destino del error.

Azure.Core.Foundations.ErrorResponse

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	Azure.Core.Foundations.Error	Objeto de error.

Azure.Core.Foundations.InnerError

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
innererror	Azure.Core.Foundations.InnerError	Error interno.

ClinicalCodedElement

Un fragmento de información clínica, expresado como código en un sistema de codificación clínica.

Nombre	Tipo	Description
code	string	Código dentro del sistema de codificación clínica determinado.
name	string	Nombre de este concepto codificado en el sistema de codificación.
system	string	El sistema de codificación clínica, por ejemplo, ICD-10, SNOMED-CT, UMLS.
value	string	Valor asociado al código dentro del sistema de codificación clínica determinado.

ClinicalNoteEvidence

Un fragmento de evidencia de una nota clínica (documento de texto).

Nombre	Tipo	Description
id	string	Identificador del documento que contiene la evidencia.
length	integer	Longitud del intervalo de texto de evidencia.
offset	integer	Índice inicial del intervalo de texto de evidencia en el documento (basado en 0).
text	string	Intervalo de texto real que es evidencia de la inferencia.

ClinicalTrialMetadata

Datos de prueba que son de interés para el posible participante.

Nombre	Tipo	Description
conditions	string[]	Condiciones médicas y sus sinónimos que son relevantes para el ensayo clínico, dados como cadenas.
contacts	ContactDetails[]	Póngase en contacto con los detalles de los administradores del ensayo para los pacientes que quieran participar en el ensayo.
facilities	ClinicalTrialResearchFacility[]	Instalaciones de investigación en las que se lleva a cabo el ensayo clínico.
phases	ClinicalTrialPhase[]	Fases que son relevantes para el ensayo clínico. Cada ensayo clínico puede estar en una fase determinada o en varias fases.
recruitmentStatus	ClinicalTrialRecruitmentStatus	Posible estado de reclutamiento de un ensayo clínico.
sponsors	string[]	Patrocinadores/colaboradores implicados en el juicio.
studyType	ClinicalTrialStudyType	Posibles tipos de estudio de un ensayo clínico.

ClinicalTrialPhase

Posibles fases de un ensayo clínico.

Nombre	Tipo	Description
earlyPhase1	string
notApplicable	string
phase1	string
phase2	string
phase3	string
phase4	string

ClinicalTrialRecruitmentStatus

Posible estado de reclutamiento de un ensayo clínico.

Nombre	Tipo	Description
enrollingByInvitation	string
notYetRecruiting	string
recruiting	string
unknownStatus	string

ClinicalTrialResearchFacility

Detalles de un centro de investigación donde se lleva a cabo un ensayo clínico.

Nombre	Tipo	Description
city	string	Nombre de la ciudad.
countryOrRegion	string	Nombre del país o región.
name	string	Nombre de la instalación.
state	string	Nombre de estado.

ClinicalTrialSource

Posibles fuentes de un ensayo clínico.

Nombre	Tipo	Description
clinicaltrials.gov	string
custom	string

ClinicalTrialStudyType

Posibles tipos de estudio de un ensayo clínico.

Nombre	Tipo	Description
expandedAccess	string
interventional	string
observational	string
patientRegistries	string

ContactDetails

Detalles de contacto de una persona.

Nombre	Tipo	Description
email	string	Correo electrónico de la persona.
name	string	Nombre de la persona.
phone	string	Número de teléfono de una persona.

ExtendedClinicalCodedElement

Un fragmento de información clínica, expresado como código en un sistema de codificación clínica, extendido por información semántica.

Nombre	Tipo	Description
category	string	Categoría bio-médica relacionada con el concepto codificado, por ejemplo, Diagnóstico, Síntoma, Medicamento, Examen.
code	string	Código dentro del sistema de codificación clínica determinado.
name	string	Nombre de este concepto codificado en el sistema de codificación.
semanticType	string	El tipo semántico UMLS asociado al concepto codificado.
system	string	El sistema de codificación clínica, por ejemplo, ICD-10, SNOMED-CT, UMLS.
value	string	Valor asociado al código dentro del sistema de codificación clínica determinado.

JobStatus

Estado del trabajo de procesamiento.

Nombre	Tipo	Description
canceled	string
failed	string
notStarted	string
running	string
succeeded	string

TrialMatcherInference

Una inferencia realizada por el modelo del buscador de coincidencias de prueba con respecto a un paciente.

Nombre	Tipo	Description
clinicalTrialId	string	Identificador del ensayo clínico.
confidenceScore	number	Puntuación de confianza para esta inferencia.
description	string	Descripción correspondiente al valor de inferencia.
evidence	TrialMatcherInferenceEvidence[]	Evidencia correspondiente al valor de inferencia.
metadata	ClinicalTrialMetadata	Datos de prueba que son de interés para el posible participante.
source	ClinicalTrialSource	Posibles fuentes de un ensayo clínico.
type	TrialMatcherInferenceType	Tipo de inferencia del buscador de coincidencias de prueba.
value	string	Valor de la inferencia, según corresponda para el tipo de inferencia especificado.

TrialMatcherInferenceEvidence

Una prueba correspondiente a una inferencia del buscador de coincidencias de prueba.

Nombre	Tipo	Description
eligibilityCriteriaEvidence	string	Un fragmento de evidencia del texto de los criterios de idoneidad de un ensayo clínico.
importance	number	Valor que indica la importancia de esta prueba para la inferencia.
patientDataEvidence	ClinicalNoteEvidence	Un fragmento de evidencia de una nota clínica (documento de texto).
patientInfoEvidence	ClinicalCodedElement	Un fragmento de información clínica, expresado como código en un sistema de codificación clínica.

TrialMatcherInferenceResult

Los resultados de la inferencia para la solicitud del buscador de coincidencias de prueba.

Nombre	Tipo	Description
knowledgeGraphLastUpdateDate	string	Fecha en la que se actualizó por última vez el gráfico de conocimiento de los ensayos clínicos.
modelVersion	string	La versión del modelo que se usa para la inferencia, expresada como la fecha del modelo.
patientResults	TrialMatcherPatientResult[]	Resultados para los pacientes dados en la solicitud.

TrialMatcherInferenceType

Tipo de inferencia del buscador de coincidencias de prueba.

Nombre	Tipo	Description
trialEligibility	string

TrialMatcherPatientResult

Los resultados del trabajo del modelo para un solo paciente.

Nombre	Tipo	Description
inferences	TrialMatcherInference[]	Los resultados de la inferencia para el paciente.
neededClinicalInfo	ExtendedClinicalCodedElement[]	Información clínica necesaria para proporcionar mejores resultados de coincidencia de ensayos para el paciente.
patientId	string	Identificador especificado para el paciente en la solicitud.

TrialMatcherResult

Respuesta de la solicitud del buscador de coincidencias de prueba.

Nombre	Tipo	Description
createdDateTime	string	La fecha y hora en que se creó el trabajo de procesamiento.
error	Azure.Core.Foundations.Error	Objeto error que describe el error cuando el estado es "Failed".
expirationDateTime	string	La fecha y hora en que el trabajo de procesamiento está establecido para que expire.
id	string	El identificador único de la operación.
lastUpdateDateTime	string	La fecha y hora en que el trabajo de procesamiento se actualizó por última vez.
result	TrialMatcherInferenceResult	Resultado de la operación.
status	JobStatus	El estado de la operación

Compartir a través de

Trial Matcher - Get Job

Parámetros de identificador URI

Encabezado de la solicitud

Respuestas

Seguridad

Ocp-Apim-Subscription-Key

Ejemplos

Gets the status and details of the Trial Matcher job.

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

ClinicalCodedElement

ClinicalNoteEvidence

ClinicalTrialMetadata

ClinicalTrialPhase

ClinicalTrialRecruitmentStatus

ClinicalTrialResearchFacility

ClinicalTrialSource

ClinicalTrialStudyType

ContactDetails

ExtendedClinicalCodedElement

JobStatus

TrialMatcherInference

TrialMatcherInferenceEvidence

TrialMatcherInferenceResult

TrialMatcherInferenceType

TrialMatcherPatientResult

TrialMatcherResult

Recursos adicionales