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 Crea 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 en lotes. Para obtener más información sobre las importaciones incrementales, consulta Actualiza los datos de atención médica.
Importación de transmisiones: Es una importación de datos de transmisión casi en tiempo real. Los cambios incrementales en el almacén de FHIR de origen se sincronizan 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, debes 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 transmisión, y realizar la sincronización manual cuando sea necesario. Para obtener más información, consulta Administra un almacén de datos de búsqueda de atención médica.
La tasa de transmisión de datos para un proyecto 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 escrituras pendientes de FHIR o de transmisión de 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 y 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, pero no podrás cambiar esta configuración más adelante.
Antes de comenzar
Antes de crear la app de búsqueda de atención médica, debes comprender lo siguiente:
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.
Vertex AI Search para el sector de la salud proporciona servicios de búsqueda solo en la multirregión de EE.UU. (
us
). Por lo tanto, tu app de búsqueda y tus almacenes de datos del sector de la salud deben residir en la multirregiónus
.Si importas datos de atención médica desde un almacén de FHIR de la API de Cloud Healthcare en un proyecto Google Cloud a un almacén de datos de Vertex AI Search en un proyecto Google Cloud diferente y usas los Controles del servicio de VPC, los dos proyectos deben estar en el mismo perímetro.
Crea una app
Puedes crear una app de búsqueda de atención médica en la Google Cloud consola o con la API. Para crear una app de búsqueda de atención médica, sigue estos pasos:
Console
En la consola de Google Cloud , ve a la página AI Applications.
En la página Apps, haz clic en add_box Nueva app.
En la página Crear app, en Búsqueda de atención médica, haz clic en Crear.
En el panel Configuración de la app de búsqueda, selecciona Atención médica.
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 los principales resultados de la búsqueda.
Cuando activas las funciones basadas en LLM, las funciones compatibles pueden tardar hasta cinco minutos en estar disponibles.
En el campo Nombre de tu app, ingresa un nombre para ella.
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 S.A. o S.R.L. Este campo es útil para que el LLM identifique la empresa que representa la app.
En la sección Transparencia de acceso, selecciona Inhabilitar las métricas de búsqueda para esta aplicación para desactivar el registro de métricas de la app actual. Esto no se puede cambiar después de crear la app.
Haz clic en Continuar.
Para conectarte a un almacén de datos, en la página Almacenes de datos, realiza 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):
- Haz clic en add_box Crear almacén de datos.
- En el panel Selecciona una fuente de datos, elige API de Healthcare (FHIR) como tu fuente de datos.
- Para importar datos de tu almacén de FHIR, realiza una de las siguientes acciones:
- Selecciona el almacén de FHIR de la lista de almacenes de FHIR disponibles:
- Expande el campo Almacén de FHIR.
- 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.
- Ingresa el almacén de FHIR de forma manual:
- Expande el campo Almacén de FHIR.
- Haz clic en Ingresar el almacén de FHIR manualmente.
- En el diálogo FHIR store name, ingresa el nombre completo del almacén de FHIR con el siguiente formato:
project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID
- Haz clic en Guardar.
- Selecciona el almacén de FHIR de la lista de almacenes de FHIR disponibles:
- En la sección Sincronización, selecciona una de las siguientes opciones.
No se puede cambiar esta selección después de crear el almacén de datos.
- Una vez: Para realizar una importación única de datos por lotes. Para obtener más información sobre las importaciones incrementales, consulta Actualiza los 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. 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.
- En la sección ¿Cuál es el esquema para estos datos?, selecciona una de las siguientes opciones:
- Esquema predefinido de Google: Para conservar la configuración del esquema definido por Google, como la indexabilidad, la capacidad de búsqueda y la capacidad de recuperación, para los recursos y elementos de FHIR admitidos Después de seleccionar esta opción, no podrás
actualizar el esquema después de crear el almacén de datos. Si deseas poder cambiar el esquema después de crear el almacén de datos, selecciona la opción Esquema personalizado.
- Haz clic en Continuar.
- En el campo Nombre de tu almacén de datos, ingresa un nombre para tu almacén de datos.
- Haz clic en Crear.
El almacén de datos que creaste aparece 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, para los recursos y elementos de FHIR admitidos. Para configurar un esquema configurable, comunícate con tu ingeniero de atención al cliente.
- Haz clic en Continuar.
- Revisa el esquema, expande cada campo y edita la configuración de los campos.
- Haz clic en Agregar campos nuevos para agregar campos nuevos en los recursos de FHIR admitidos. No puedes quitar los campos proporcionados en el esquema definido por Google.
- Haz clic en Continuar.
- En el campo Nombre del conector de datos, ingresa un nombre para tu conector de datos.
- Haz clic en Crear.
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.
- Esquema predefinido de Google: Para conservar la configuración del esquema definido por Google, como la indexabilidad, la capacidad de búsqueda y la capacidad de recuperación, para los recursos y elementos de FHIR admitidos Después de seleccionar esta opción, no podrás
actualizar el esquema después de crear el almacén de datos. Si deseas poder cambiar el esquema después de crear el almacén de datos, selecciona la opción Esquema personalizado.
- Haz clic en Continuar.
- Selecciona el almacén de datos o el conector de datos creado.
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 solo permite la conexión a una 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 servicios de salud.
Haz clic en Crear.
Si la app 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 de FHIR importados.
REST
- Crea un almacén de datos de atención médica y, luego, importa datos de atención médica en él.
Crea una app de búsqueda de servicios de salud y conéctala a un almacén de datos. Una app de búsqueda de servicios de salud solo puede conectarse a un almacén de datos, mientras que un almacén de datos puede conectarse 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/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"] } }'
Reemplaza lo siguiente:
PROJECT_ID
: Es el ID de tu proyecto de Google Cloud .APP_ID
: Es 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 deseas 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 valorSEARCH_ADD_ON_LLM
. Si no quieres usar las funciones avanzadas de LLM, especificaSEARCH_ADD_ON_UNSPECIFIED
o quita el camposearchAddOns
. 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 del almacén de datos y la importación de datos, completa los siguientes pasos.
Console
En la consola de Google Cloud , ve a la página AI Applications.
En la página Apps, verifica si la app que creaste se encuentra en la lista de apps.
Verifica que el almacén de datos al que te conectaste a la app aparezca en la tabla Almacenes de datos conectados.
Selecciona el almacén de datos y verifica sus detalles.
REST
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/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"
Reemplaza lo siguiente:
PROJECT_ID
: Es el ID de tu proyecto de Google Cloud .APP_ID
: Es el ID de la app de Vertex AI Search.
Verifica la creación del almacén de datos y la importación de datos de FHIR.
¿Qué sigue?
- Busca datos de atención médica en tu app de búsqueda de atención médica.
- Actualiza los datos de atención médica.