Cómo filtrar la búsqueda de servicios de salud

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 incluyan o excluyan ciertas respuestas de búsqueda.

Por ejemplo, cuando buscas los datos de un solo paciente, el cuerpo de la solicitud de búsqueda debe contener la siguiente expresión de filtro que especifica 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 Crea una app de búsqueda de atención médica y Crea 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, aptos para la búsqueda y recuperables. Para obtener más información, consulta la referencia del esquema de datos de FHIR R4 de Healthcare.
• Comprende la sintaxis de la expresión de filtro.

Cómo definir filtros

Los filtros se especifican en el campo filter del 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 de filtro, el literal puede ser cualquier campo indexable de la respuesta a la búsqueda. Por ejemplo, si la respuesta contiene un recurso de Observation, el patient_id al que hace referencia el recurso de Observation se puede usar como un literal de filtro.

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

Cómo definir un filtro de resource_datetime

En este ejemplo, se muestra cómo especificar un filtro para una búsqueda que incluya solo aquellos recursos que tengan un valor de resource_datetime posterior al valor de fecha y hora especificado.

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}}
}'

{
    "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 construir un filtro que usa un operador AND para filtrar primero todos los recursos de Composition y, luego, filtrar aquellos cuya fecha sea posterior a una fecha y hora especificadas.

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

Cómo definir un filtro de recursos de FHIR

Puedes usar un filtro para verificar si un recurso de FHIR está presente en el 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\")"