Crea una app de búsqueda de atención médica

Para buscar datos clínicos en Vertex AI Search, puedes seguir uno de estos flujos de trabajo:

  • Crea un almacén de datos de atención médica, importa datos de FHIR R4 al almacén de datos, conéctalo a una app de búsqueda de atención médica y consulta los datos clínicos. Para obtener más información, consulta Cómo crear un almacén de datos de atención médica.
  • Crea una app de búsqueda de atención médica, crea un almacén de datos de atención médica y, luego, importa datos de FHIR R4 al almacén de datos durante el proceso de creación de la app y consulta los datos clínicos.

En esta página, se describe el segundo método.

Acerca de la frecuencia de importación de datos

Puedes importar datos de FHIR R4 a un almacén de datos de las siguientes maneras:

  • Importación por lotes: Es una importación única. Los datos se importan a un almacén de datos. Para obtener más información sobre las importaciones incrementales, consulta Cómo actualizar los datos de atención médica.

  • Importación de transmisión (versión preliminar): Es una importación de datos de transmisión casi en tiempo real. Cualquier cambio incremental en el almacén de FHIR de origen se sincroniza en el almacén de datos de Vertex AI Search. La transmisión requiere un conector de datos, que es un tipo de almacén de datos que contiene una entidad. Una entidad también es una instancia del almacén de datos.

    La tasa de transmisión de datos de un proyecto de Google Cloud determinado depende de las siguientes cuotas. Si superas la cuota, es posible que experimentes retrasos en la transmisión.

    • Es la cantidad de operaciones de escritura de transmisión pendientes de FHIR o BigQuery por minuto. Para obtener más información, consulta Cuotas y límites.
    • Es la cantidad de operaciones de lectura de FHIR por minuto por región. Para obtener más información, consulta Cuotas de FHIR de la API de Cloud Healthcare.

Puedes seleccionar la frecuencia de importación de datos en el momento de la creación del almacén de datos y no puedes cambiar esta configuración más adelante.

La importación de transmisión está disponible para todos los recursos que admite Vertex AI Search. Para obtener más información, consulta la referencia del esquema de datos de FHIR R4 para la atención médica.

Antes de comenzar

Antes de crear la app de búsqueda de atención médica, completa estos requisitos:

  • Comprende la relación entre las apps y los almacenes de datos para la búsqueda de atención médica. Para obtener más información, consulta Acerca de las apps y los almacenes de datos.

  • Prepara tus datos de FHIR para la transferencia.

  • Vertex AI Search para atención médica proporciona servicios de búsqueda solo en la multirregión de EE.UU. (us). Por lo tanto, tu app de búsqueda de atención médica y tus almacenes de datos deben residir en la multirregión us.

Crea una app

Puedes crear una app de búsqueda de atención médica en la consola de Google Cloud o con la API. Los dos enfoques difieren de la siguiente manera:

  • En la consola de Google Cloud, selecciona el almacén de FHIR de origen en la API de Cloud Healthcare y, luego, importa los datos de FHIR como parte del proceso de creación de la app de búsqueda de atención médica. Para transmitir datos de FHIR (versión preliminar), tu almacén de FHIR de origen debe estar en el mismo proyecto de Google Cloud que la app de búsqueda de Vertex AI de destino.
  • A través de la API de REST: Puedes importar datos de FHIR desde un almacén de FHIR de la API de Cloud Healthcare. El almacén de FHIR puede estar en el mismo proyecto de Google Cloud o en uno diferente.
    1. Usa el método dataStores.create para crear un almacén de datos de atención médica.
    2. Usa el método documents.import para especificar el almacén de FHIR en la API de Cloud Healthcare y para importar datos de FHIR.
    3. Usa el método engines.create para crear la app de búsqueda de atención médica y especificar un almacén de datos de atención médica existente.

Para crear una app de búsqueda de atención médica, sigue estos pasos:

Console

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

    Agent Builder

  2. En la página Apps, haz clic en Nueva app.

  3. En la página Crear app, en Búsqueda de atención médica, haz clic en Crear.

  4. En el panel Configuración de la app de búsqueda, selecciona Atención médica.

  5. Para activar las funciones avanzadas de LLM para esta app, haz clic en el botón de activación Funciones avanzadas de LLM.

    Activa las funciones avanzadas de LLM para obtener resúmenes de búsqueda, que son resúmenes breves de uno o más de los resultados principales de la búsqueda.

    Cuando activas las funciones de LLM, es posible que las funciones compatibles tarden hasta cinco minutos en estar disponibles.

  6. En el campo Nombre de tu app, ingresa un nombre para ella.

  7. En el campo Nombre externo de tu organización o empresa, ingresa el nombre común de tu organización o empresa. No es necesario que incluyas sufijos, como Inc. o LLC. Este campo es útil para que el LLM identifique la empresa a la que representa la app.

  8. Haga clic en Continuar.

  9. Para conectarte a un almacén de datos, en la página Almacenes de datos, haz una de las siguientes acciones:

    • Selecciona un almacén de datos de atención médica existente para la importación por lotes o un conector de datos existente para la importación de transmisión. Para crear un almacén de datos o un conector de datos antes de crear una app, consulta Cómo crear un almacén de datos de atención médica.
    • Crea un almacén de datos (para la importación por lotes única) o un conector de datos, que es una instancia de un almacén de datos (para la importación de transmisión):
      1. Haz clic en Crear almacén de datos.
      2. En el panel Selecciona una fuente de datos, elige API de Healthcare (FHIR) como fuente de datos.
      3. Para importar datos de tu almacén de FHIR, haz una de las siguientes acciones:
        • Selecciona el almacén de FHIR de la lista de almacenes de FHIR disponibles:
          1. Expande el campo Tienda de FHIR.
          2. En esta lista, selecciona un conjunto de datos que resida en una ubicación permitida y, luego, selecciona un almacén de FHIR que use la versión R4 de FHIR.

            Para transmitir datos de FHIR (versión preliminar), tu almacén de FHIR de origen debe estar en el mismo proyecto de Google Cloud que el almacén de datos de Vertex AI Search de destino.

        • Ingresa el almacén de FHIR de forma manual:
          1. Expande el campo Tienda de FHIR.
          2. Haz clic en Ingresar almacén de FHIR manualmente.
          3. En el diálogo Nombre del almacén de FHIR, ingresa el nombre completo del almacén de FHIR en el siguiente formato:

            project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID

          4. Haz clic en Guardar.
      4. En la sección Synchronization, selecciona una de las siguientes opciones. No se puede cambiar esta selección después de crear el almacén de datos.
        • Única: Para realizar una importación de datos por lotes única. Para obtener más información sobre las importaciones incrementales, consulta Cómo actualizar datos de atención médica.
        • Transmisión: Para realizar una importación de datos de transmisión casi en tiempo real. Para transmitir datos, debes crear un conector de datos, que es un tipo de almacén de datos. Esta es una función de versión preliminar. Para configurar un almacén de datos de transmisión con la API de REST, comunícate con tu ingeniero de atención al cliente.
      5. En la sección ¿Cuál es el esquema para estos datos?, selecciona una de estas opciones:
        • Esquema predefinido de Google: Para retener las configuraciones de esquemas definidas por Google, como la indexabilidad, la capacidad de búsqueda y la recuperabilidad, para los recursos y elementos de FHIR compatibles. Una vez que selecciones esta opción, no podrás actualizar el esquema después de crear el almacén de datos. Si quieres poder cambiar el esquema después de crear el almacén de datos, selecciona la opción Esquema personalizado (versión preliminar).
          1. Haga clic en Continuar.
          2. En el campo Nombre de tu almacén de datos, ingresa un nombre para tu almacén de datos.
          3. Haz clic en Crear.

            4. El almacén de datos que creaste aparecerá en la página Almacenes de datos.

        • Esquema personalizado (versión preliminar): Para definir tus propias configuraciones de esquemas, como la indexabilidad, la capacidad de búsqueda y la recuperabilidad, para los recursos y elementos de FHIR compatibles. Esta es una función de versión preliminar. Para configurar un esquema configurable, comunícate con tu ingeniero de atención al cliente.
          1. Haga clic en Continuar.
          2. Revisa el esquema, expande cada campo y edita su configuración.
          3. Haz clic en Agregar campos nuevos para agregar campos nuevos a los recursos de FHIR compatibles. No puedes quitar los campos proporcionados en el esquema definido por Google.
          4. Haga clic en Continuar.
          5. En el campo Nombre de tu conector de datos, ingresa un nombre para el conector.
          6. Haz clic en Crear.

            7. El conector de datos que creaste aparece en la página Almacenes de datos. El almacén de FHIR de origen se agrega como una entidad dentro del conector de datos.

      6. Haga clic en Continuar.
      7. Selecciona el almacén de datos o el conector de datos creado.

  10. Opcional: Para ver una lista de los almacenes de datos no disponibles, haz clic en Más información.

    Se muestra una tabla con una lista de los almacenes de datos y el motivo por el que no están disponibles. Estos son algunos de los motivos por los que un almacén de datos podría no estar disponible:

    • Tu tipo de almacén de datos permite la conexión a una sola app y el almacén de datos ya está conectado.
    • Tu almacén de datos y tu app son de diferentes tipos. Por ejemplo, no puedes conectar un almacén de datos de búsqueda de sitios web a una app de búsqueda de atención médica.

  11. Haz clic en Crear.

    Si la app y su almacén de datos se crean correctamente, la página de detalles del almacén de datos muestra los detalles de los datos de FHIR importados.

REST

  1. Crea un almacén de datos de atención médica y, luego, importa datos de atención médica.

  2. Crea una app de búsqueda de atención médica y conéctala a un almacén de datos. Una app de búsqueda de atención médica solo se puede conectar a un almacén de datos, mientras que un almacén de datos determinado se puede conectar a varias apps.

    curl -X POST\
 -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
"https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines?engineId=APP_ID" \
 -d '{
    "displayName": "APP_DISPLAY_NAME",
    "dataStoreIds":"DATA_STORE_ID",
    "industryVertical": "HEALTHCARE_FHIR",
    "solutionType": "SOLUTION_TYPE_SEARCH",
    "searchEngineConfig": {
      "searchTier": "SEARCH_TIER_STANDARD",
      "searchAddOns": ["SEARCH_ADD_ON"]
    }
}'

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto de Google Cloud.
    • APP_ID: El ID de la app de Vertex AI Search que deseas crear.
    • APP_DISPLAY_NAME: Es el nombre visible de la app de Vertex AI Search que deseas crear.
    • DATA_STORE_ID: Es el ID de un almacén de datos de Vertex AI Search existente que quieres agregar a la app de Vertex AI Search.
    • SEARCH_ADD_ON: Es un campo opcional para especificar si deseas las funciones avanzadas de LLM, como la búsqueda con respuestas de IA generativa, para esta app. Para activar las funciones avanzadas de LLM, ingresa el valor SEARCH_ADD_ON_LLM. Si no quieres usar las funciones avanzadas de LLM, especifica SEARCH_ADD_ON_UNSPECIFIED o quita el campo searchAddOns. Para obtener más información, consulta Funciones avanzadas de LLM.

Verifica la creación de la app

En esta tarea, se muestra cómo verificar si se creó correctamente una app de búsqueda de atención médica y si los datos de FHIR se importaron correctamente al almacén de datos.

  • En la consola de Google Cloud, selecciona la app y verifica sus detalles.
  • A través de la API de REST, usa el método engines.get para obtener los detalles del almacén de datos de atención médica.

Para verificar la creación y la importación de datos del almacén de datos, completa los siguientes pasos.

Console

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

    Agent Builder

  2. En la página Apps, verifica si la app que creaste se encuentra en la lista de apps.

  3. Verifica que el almacén de datos que conectaste a la app aparezca en la columna Almacenes de datos conectados.

  4. Selecciona el almacén de datos y verifica los detalles del almacén de datos.

REST

  1. Verifica la creación de la app.

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
 "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto de Google Cloud.
    • APP_ID: El ID de la app de Vertex AI Search.

  2. Verifica la creación del almacén de datos y la importación de datos de FHIR.

¿Qué sigue?