Cómo filtrar la búsqueda de atención médica

Precaución:

• Restricciones para el cuidado de la salud: como cliente, no lo hará no permitir que los Usuarios Finales usen los Servicios de IA Generativa con fines fines de claridad, investigación no clínica, programación u otras tareas administrativas no están restringidas), como sustituto de asesoramiento médico profesional o cualquier otro modo que sea supervisado por o requiere la aprobación o aprobación de cualquier organismo regulador aplicable autoridad. Para obtener más información, consulta Condiciones específicas del servicio.

  A los efectos de la claridad, en relación con el uso de Vertex AI Search para recuperar y resumir información médica existente, la restricción del uso con fines clínicos significa la restricción del uso con fines de diagnóstico o tratamiento directos sin la revisión de un profesional con licencia de conformidad con las leyes y reglamentaciones aplicables.

• Es posible que el resultado generado no siempre sea completamente confiable. Debido a la naturaleza de los LLM y la IA generativa, los resultados pueden tener información incorrecta o sesgada (por ejemplo, estereotipos o algún otro contenido dañino) y deben revisarse. Todos los resúmenes o respuestas deben considerarse borradores y no definitivo.
• El uso previsto de este producto no es para proporcionar información relacionada para la prevención, el diagnóstico o el tratamiento de enfermedades o enfermedades. No se deben hacer preguntas relacionadas con el diagnóstico o las recomendaciones de tratamiento que el producto debería abordar. El uso previsto de este producto para recuperar y resumir la información médica existente proporcionada por usuarios.
• Debido a la limitación de datos de prueba, es posible que este producto sea aplicable o no a los grupos de edad de 0 a 18 años y de 85 años en adelante. Por lo tanto, cuando revises el resultado generado, los clientes deben considerar la representatividad de las subpoblaciones de sus datos de origen.

Cuando consultas datos de atención médica, puedes usar filtros para definir mejor las respuestas de la búsqueda. En una solicitud de búsqueda, puedes proporcionar filtros para aplicar criterios que incluir o excluir ciertas respuestas de búsqueda.

Por ejemplo, cuando estás buscar en los datos de un solo paciente, la solicitud de búsqueda body debe contener la siguiente expresión de filtro que especifique el ID del paciente:

"filter": "patient_id: ANY(\"PATIENT_ID\")"

En esta página, se muestra cómo definir filtros para la búsqueda de atención médica.

Antes de comenzar

Antes de comenzar, haz lo siguiente:

• Crea una app de búsqueda de atención médica y un almacén de datos de búsqueda de atención médica, y luego importa datos de FHIR R4. Para obtener más información, consulta Cómo crear una app de búsqueda de atención médica y Cómo crear un almacén de datos de búsqueda de atención médica.
• Revisa la lista de recursos de FHIR R4 que admite Vertex AI Search como campos indexables, que se pueden buscar y recuperar. Para obtener más información, consulta la Referencia de esquema de datos de FHIR R4 de Healthcare.
• Comprende la sintaxis de la expresión de filtro.

Definir filtros

Los filtros se especifican en el campo filter en el cuerpo de la solicitud del método servingConfigs.search.

La definición del filtro sigue la sintaxis de la expresión de filtro. En la expresión del filtro, el literal puede ser cualquier campo indexable de la respuesta a la búsqueda. Por ejemplo, si la respuesta contiene un recurso Observation, el patient_id al que hace referencia el recurso Observation se puede usar como un filtro literal.

En las siguientes secciones, se muestran algunos ejemplos sobre cómo construir filtros.

Define un filtro resource_datetime

En este ejemplo, se muestra cómo especificar un filtro para una búsqueda que incluye solo aquellos recursos que tienen un valor resource_datetime posterior a la fecha especificada y el valor del tiempo.

REST

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/dataStores/DATA_STORE_ID/servingConfigs/default_search:search" \
    -d '{
"query": "QUERY",
"filter": "patient_id: ANY(\"PATIENT_ID\") AND resource_datetime > \"DATE_TIME_VALUE,
"contentSearchSpec":{"snippetSpec":{"returnSnippet":true}}
}'

Reemplaza lo siguiente:

• PROJECT_ID: El ID del proyecto de Google Cloud.
• DATA_STORE_ID: Es el ID del almacén de datos de Vertex AI Search.
• QUERY: Es la búsqueda.
• PATIENT_ID: Es el ID de recurso del paciente cuyos datos deseas buscar.
• DATE_TIME_VALUE: Es el valor del campo resource_datetime que representa una fecha y hora en el formato dateTime de FHIR. Estos son algunos ejemplos de este campo:
  • Para especificar una fecha y una hora con una zona horaria separadas por un separador T, usa lo siguiente: 2022-08-05T01:00:00+00:00
  • Para especificar una fecha, sigue estos pasos: 2022-08-05
  • Para especificar un mes, usa 2022-08.
  • Para especificar un año: 2022

Respuesta

Deberías recibir una respuesta JSON similar a la siguiente respuesta truncada. La respuesta contiene resultados de búsqueda detallados que se enumeran en orden cronológico inverso con fragmentos, si están disponibles. El campo structData contiene los datos JSON estructurados del documento.

{
    "results": [
    {
        "id": "DOCUMENT_ID",
        "document": {
        "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID",
        "id": "DOCUMENT_ID",
        "structData": {
            ...
            "resource_type": "FHIR_RESOURCE_TYPE",
            "resource_datetime": "RESOURCE_DATETIME",
            "patient_id": "PATIENT_ID",
            "FHIR_RESOURCE_TYPE": { ... }
        },
        "derivedStructData": {
            "snippets": [
            {
                "snippet": "SNIPPET_TEXT",
                "snippet_status": "SUCCESS"
            }
            ]
        }
        }
    }]
}

Define un filtro de tipo de recurso

En el siguiente ejemplo, se muestra cómo crear un filtro que usa un operador AND para filtrar primero todos los recursos de composición y, luego, filtrar aquellos cuya fecha es posterior a una fecha y hora especificadas.

"filter": "resource_type: ANY("Composition") AND Composition.date > "2022-08-05T01:00:00+00:00""

Define un filtro de recursos de FHIR

Puedes usar un filtro para verificar si un recurso de FHIR está presente almacén de datos de Vertex AI Search. Por ejemplo, puedes buscar un recurso DocumentReference que tenga el ID 6112d1ac-c6bd-4755-d689-bfb71d59afc5 con el siguiente filtro.

"filter": "DocumentReference.id: ANY(\"6112d1ac-c6bd-4755-d689-bfb71d59afc5\")"