Cómo ordenar los resultados de la búsqueda de atención médica

De forma predeterminada, cuando buscas datos de atención médica, los resultados de la búsqueda se muestran en orden cronológico inverso. Cuando realizas una búsqueda en los siguientes tipos de recursos de FHIR que contienen texto no estructurado, puedes ordenar los resultados de la búsqueda según su relevancia para tu consulta:

  • Composición
  • DiagnosticReport
  • DocumentReference

Situación de ejemplo

Supongamos que buscas la palabra clave insulin para un paciente determinado y filtraste los resultados en los recursos que contienen texto no estructurado. Entre otros resultados, recibirás los siguientes documentos:

  • Resultado 1: Un recurso DocumentReference, con fecha del 24 de abril de 2024, que contiene notas sobre los niveles de "HbA1c" del paciente.
  • Resultado 2: Un recurso DiagnosticReport, con fecha del 11 de enero de 2024, que contiene notas sobre el “régimen de insulina” que debe seguir el paciente.

De forma predeterminada, el resultado 1 se muestra más arriba en los resultados porque es un documento más reciente, pero cuando ordenas por relevancia, el resultado 2 aparece más arriba en los resultados. Esto se debe a que es más relevante para la búsqueda insulin.

Ordena los resultados de la búsqueda de atención médica

Para ordenar los resultados de la búsqueda según la relevancia, completa los siguientes pasos:

Console

  1. En la consola de Google Cloud, ve a la página Agent Builder.

    Agent Builder

  2. Selecciona la app de búsqueda de atención médica que quieras consultar.

  3. En el menú de navegación, haz clic en Vista previa.

  4. En el campo ID de paciente, ingresa el ID del paciente cuyos datos deseas consultar. Los IDs de paciente distinguen mayúsculas de minúsculas.

  5. Presiona Intro o haz clic en Obtener vista previa para enviar el ID del paciente.

  6. En la barra de búsqueda Buscar aquí, ingresa tu búsqueda.

    Si habilitaste el autocompletado, verás una lista de sugerencias de autocompletado debajo de la barra de búsqueda a medida que escribes.

  7. Presiona Intro para enviar la consulta.

    • Los resultados de la búsqueda se muestran en tablas paginadas que se clasifican según su tipo de recurso de FHIR.
    • De forma predeterminada, los resultados de la búsqueda de todos los tipos de recursos de FHIR se muestran en orden cronológico inverso.
  8. Para los recursos de Composition, DocumentReference y DiagnosticReport, haz clic en el filtro Ordenar: Cronológico inverso y selecciona Relevancia en la lista. Luego, los resultados de estos recursos se ordenan según la relevancia.

REST

Para ordenar los resultados de la búsqueda según la relevancia, modifica tu solicitud search de la siguiente manera:

  • Agrega el campo filter a tu solicitud para limitar los resultados de la búsqueda solo a los recursos de FHIR que contienen texto no estructurado: Composition, DiagnosticReport y DocumentReference.
  • Agrega el campo orderBy a tu solicitud de búsqueda y establece su valor en _RELEVANCE para obtener respuestas de búsqueda que se ordenen según su relevancia.
  1. Envía la solicitud de búsqueda.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
      -d '{
    "query": "KEYWORD_QUERY",
    "filter": "patient_id: ANY(\"PATIENT_ID\") AND resource_type: ANY(\"Composition\", \"DiagnosticReport\", \"DocumentReference\")",
    "orderBy": "_RELEVANCE"
    }'
    

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto de Google Cloud.
    • APP_ID: El ID de la app de Vertex AI Search que quieres consultar.
    • KEYWORD_QUERY: Es la palabra clave que deseas buscar en los datos clínicos del paciente filtrado, como “diabetes” o “a1c”.
    • PATIENT_ID: Es el ID del recurso del paciente cuyos datos deseas buscar.

    Deberías recibir una respuesta JSON que contenga resultados de la búsqueda detallados, que se enumeran en orden de relevancia.