Crear una aplicación de búsqueda de asistencia sanitaria

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

  • Crea un almacén de datos sanitarios, importa datos FHIR R4 en el almacén, conéctalo a una aplicación de búsqueda sanitaria y consulta los datos clínicos. Para obtener más información, consulta Crear un almacén de datos de Healthcare.
  • Crea una aplicación de búsqueda de datos sanitarios, crea un almacén de datos sanitarios e importa datos FHIR R4 en el almacén de datos durante el proceso de creación de la aplicación 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

Puede importar datos de FHIR R4 a un almacén de datos de las siguientes formas:

  • Importación por lotes: una importación única. Los datos se importan a un almacén de datos por lotes. Para obtener más información sobre las importaciones incrementales, consulta Actualizar datos sanitarios.

  • Importación de streaming: importación de datos de streaming casi en tiempo real. Los cambios incrementales que se produzcan en el almacén FHIR de origen se sincronizarán 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. Para crear un conector de datos, debe configurar una colección. Un conector de datos contiene una entidad, que también es una instancia de almacén de datos.

    También puedes pausar y reanudar la emisión, así como realizar una sincronización manual cuando sea necesario. Para obtener más información, consulta Gestionar un almacén de datos de búsqueda de atención sanitaria.

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

    • Número de escrituras pendientes de FHIR o de streaming de BigQuery por minuto. Para obtener más información, consulta Cuotas y límites.
    • Número de operaciones de lectura de FHIR por minuto y región. Para obtener más información, consulta las cuotas de FHIR de la API Cloud Healthcare.

Puedes seleccionar la frecuencia de importación de datos al crear el almacén de datos y no podrás cambiar esta configuración más adelante.

Antes de empezar

Antes de crear la aplicación de búsqueda de asistencia sanitaria, debes tener en cuenta lo siguiente:

  • Relación entre las aplicaciones y los almacenes de datos para la búsqueda de información sanitaria. Para obtener más información, consulta Acerca de las aplicaciones y los almacenes de datos.

  • La preparación de los datos de FHIR para la ingestión.

  • Vertex AI Search para el ámbito sanitario solo proporciona servicios de búsqueda en la multirregión de EE. UU. (us). Por lo tanto, tu aplicación de búsqueda y tus almacenes de datos del ámbito sanitario deben residir en la multirregión us.

  • Si vas a importar datos sanitarios de un almacén FHIR de la API Cloud Healthcare de un Google Cloud proyecto a un almacén de datos de Vertex AI Search de otro Google Cloud proyecto y vas a usar Controles de Servicio de VPC, los dos proyectos deben estar en el mismo perímetro.

Crear una aplicación

Puedes crear una aplicación de búsqueda de asistencia sanitaria en la Google Cloud consola o mediante la API. Para crear una aplicación de búsqueda de información sanitaria, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

    Aplicaciones de IA

  2. En la página Aplicaciones, haga clic en Nueva aplicación.

  3. En la página Crear aplicación, en Búsqueda de asistencia sanitaria, haz clic en Crear.

  4. En el panel Configuración de la aplicación de búsqueda, selecciona Sanidad.

  5. Para activar las funciones avanzadas de LLM en esta aplicación, haz clic en el interruptor Funciones avanzadas de LLM.

    Activa las funciones avanzadas de LLM para obtener resúmenes de búsqueda, que son resúmenes breves de los principales resultados de búsqueda.

    Cuando activas las funciones de LLM, pueden tardar hasta cinco minutos en estar disponibles.

  6. En el campo Nombre de tu aplicación, escribe el nombre de tu aplicación.

  7. En el campo Nombre externo de tu empresa u organización, introduce el nombre común de tu empresa u organización. No es necesario que incluyas sufijos como "Inc." o "S. L.". Este campo es útil para que el LLM identifique la empresa que representa la aplicación.

  8. En la sección Transparencia de acceso, selecciona Inhabilitar métricas de búsqueda de esta aplicación para desactivar el registro de métricas de la aplicación actual. Esta opción no se puede cambiar una vez que se ha creado la aplicación.

  9. Haz clic en Continuar.

  10. Para conectarse a un almacén de datos, en la página Almacenes de datos, haga una de las siguientes acciones:

    • Seleccione un almacén de datos sanitarios para la importación por lotes o un conector de datos para la importación por streaming. Para crear un almacén de datos o un conector de datos antes de crear una aplicación, consulta Crear un almacén de datos sanitarios.
    • Cree 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 streaming):
      1. Haz clic en Crear almacén de datos.
      2. En el panel Seleccionar una fuente de datos, elija API Healthcare (FHIR) como fuente de datos.
      3. Para importar datos de tu almacén FHIR, haz una de las siguientes acciones:
        • Seleccione el almacén FHIR de la lista de almacenes FHIR disponibles:
          1. Despliega el campo Almacén FHIR.
          2. En esta lista, seleccione un conjunto de datos que se encuentre en una ubicación permitida y, a continuación, un almacén FHIR que use la versión R4 de FHIR.
        • Introduce el almacén FHIR manualmente:
          1. Despliega el campo Almacén FHIR.
          2. Haz clic en Enter FHIR store manually (Introducir almacén de FHIR manualmente).
          3. En el cuadro de diálogo Nombre del almacén FHIR, introduce el nombre completo del almacén FHIR con 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 Sincronización, seleccione una de las siguientes opciones. Esta selección no se puede cambiar una vez creado el almacén de datos.
        • Una vez: para realizar una importación de datos en lote única. Para obtener más información sobre las importaciones incrementales, consulta Actualizar datos sanitarios.
        • Streaming: para importar datos de streaming casi en tiempo real. Para transmitir datos, debes crear un conector de datos, que es un tipo de almacén de datos. Para configurar un almacén de datos de streaming con la API REST, póngase en contacto con su ingeniero de clientes.
      5. En la sección ¿Cuál es el esquema de estos datos?, seleccione una de estas opciones:
        • Esquema predefinido de Google: para conservar las configuraciones del esquema definido por Google, como la indexabilidad, la capacidad de búsqueda y la capacidad de recuperación, de los recursos y elementos de FHIR admitidos. Una vez que hayas seleccionado esta opción, no podrás actualizar el esquema después de crear el almacén de datos. Si quiere poder cambiar el esquema después de crear el almacén de datos, seleccione la opción Esquema personalizado.
          1. Haz clic en Continuar.
          2. En el campo Nombre de tu almacén de datos, escribe el nombre que quieras darle.
          3. Haz clic en Crear.

            4. El almacén de datos que ha creado se muestra en la página Almacenes de datos.

        • Esquema personalizado: para definir tus propias configuraciones de esquema, como la indexabilidad, la capacidad de búsqueda y la capacidad de recuperación, de los recursos y elementos de FHIR admitidos. Para configurar un esquema configurable, ponte en contacto con tu ingeniero de clientes.
          1. Haz clic en Continuar.
          2. Revisa el esquema, despliega cada campo y edita la configuración del campo.
          3. Haga clic en Añadir campos para añadir campos a los recursos FHIR admitidos. No puedes quitar los campos proporcionados en el esquema definido por Google.
          4. Haz clic en Continuar.
          5. En el campo Nombre del conector de datos, introduce un nombre para el conector de datos.
          6. Haz clic en Crear.

            7. El conector de datos que ha creado se muestra en la página Almacenes de datos. El almacén FHIR de origen se añade como una entidad en el conector de datos.

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

  11. Opcional: Para ver una lista de los almacenes de datos no disponibles, haga 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 puede que un almacén de datos no esté disponible:

    • Tu tipo de almacén de datos solo permite la conexión a una aplicación y el almacén de datos ya está conectado.
    • Tu almacén de datos y tu aplicación son de tipos diferentes. Por ejemplo, no puedes conectar un almacén de datos de búsqueda de un sitio web a una aplicación de búsqueda de información sanitaria.

  12. Haz clic en Crear.

    Si la aplicación y su almacén de datos se crean correctamente, en la página de detalles del almacén de datos se mostrarán los detalles de los datos FHIR importados.

REST

  1. Crea un almacén de datos sanitarios e importa datos sanitarios en él.

  2. Crea una aplicación de búsqueda de datos sanitarios y conéctala a un almacén de datos. Una aplicación de búsqueda de datos sanitarios solo puede conectarse a un almacén de datos, mientras que un almacén de datos determinado puede conectarse a varias aplicaciones.

    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/v1/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"]
    }
}'

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu proyecto de Google Cloud .
    • APP_ID: el ID de la aplicación de Vertex AI Search que quieres crear.
    • APP_DISPLAY_NAME: el nombre visible de la aplicación de Vertex AI Search que quieres crear.
    • DATA_STORE_ID: el ID de un almacén de datos de Vertex AI Search que quieras añadir a la aplicación de Vertex AI Search.
    • SEARCH_ADD_ON: campo opcional para especificar si quieres usar las funciones avanzadas de LLM, como buscar con respuestas de IA generativa, en esta aplicación. Para activar las funciones avanzadas de LLM, introduce el valor SEARCH_ADD_ON_LLM. Si no quieres usar las funciones de LLM avanzado, especifica SEARCH_ADD_ON_UNSPECIFIED o elimina el campo searchAddOns. Para obtener más información, consulta Funciones avanzadas de LLM.

Verificar la creación de la aplicación

En esta tarea se muestra cómo verificar si se ha creado correctamente una aplicación de búsqueda de datos sanitarios y si se han importado correctamente datos FHIR en el almacén de datos.

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

Para verificar que se ha creado el almacén de datos y que se han importado los datos, siga estos pasos.

Consola

  1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

    Aplicaciones de IA

  2. En la página Aplicaciones, comprueba si la aplicación que has creado está en la lista de aplicaciones.

  3. Verifica que el almacén de datos al que te has conectado esté en la tabla Almacenes de datos conectados.

  4. Seleccione el almacén de datos y verifique sus detalles.

REST

  1. Verifica que se ha creado la aplicación.

    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/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    Haz los cambios siguientes:

    • PROJECT_ID: el ID de tu proyecto de Google Cloud .
    • APP_ID: el ID de la aplicación Vertex AI Search.

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

Siguientes pasos