Pour rechercher des données cliniques dans Vertex AI Search, vous pouvez suivre l'un des workflows suivants:
- Créez un datastore de données de santé, importez des données FHIR R4 dans le datastore, associez-le à une application de recherche de données de santé et interrogez les données cliniques. Pour en savoir plus, consultez Créer un entrepôt de données de santé.
- Créez une application de recherche pour les soins de santé, un datastore de données de santé, importez des données FHIR R4 dans le datastore lors du processus de création de l'application, puis interrogez les données cliniques.
Cette page décrit la seconde méthode.
À propos de la fréquence d'importation des données
Vous pouvez importer des données FHIR R4 dans un datastore de plusieurs façons:
Importation par lot: importation ponctuelle. Les données sont importées dans un magasin de données par lot. Pour d'autres importations incrémentielles, consultez la section Actualiser les données de santé.
Importation en flux: importation de données en flux en quasi-temps réel. Toutes les modifications incrémentielles apportées au magasin FHIR source sont synchronisées dans le data store Vertex AI Search. Le streaming nécessite un connecteur de données, qui est un type de datastore. Pour créer un connecteur de données, vous devez configurer une collection. Un connecteur de données contient une entité, qui est également une instance de data store.
Vous pouvez également mettre en pause et reprendre la diffusion, et effectuer une synchronisation manuelle si nécessaire. Pour en savoir plus, consultez la section Gérer un entrepôt de données de recherche dans le secteur de la santé.
Le débit de streaming de données pour un projet Google Cloud donné dépend des quotas suivants. Si vous dépassez le quota, vous risquez de rencontrer des retards de streaming.
- Nombre d'écritures en streaming FHIR ou BigQuery en attente par minute. Pour en savoir plus, consultez la page Quotas et limites.
- Nombre d'opérations de lecture FHIR par minute et par région. Pour en savoir plus, consultez la page Quotas FHIR de l'API Cloud Healthcare.
Vous pouvez sélectionner la fréquence d'importation des données au moment de la création du datastore. Vous ne pourrez pas modifier cette configuration par la suite.
Avant de commencer
Avant de créer l'application de recherche de services de santé, vous devez comprendre les points suivants:
Relation entre les applications et les datastores pour la recherche de données de santé Pour en savoir plus, consultez la section À propos des applications et des datastores.
Vertex AI Search pour le secteur de la santé ne fournit des services de recherche que dans la multirégion des États-Unis (
us
). Par conséquent, votre application de recherche dans le secteur de la santé et vos data stores doivent se trouver dans la multirégionus
.Si vous importez des données de santé à partir d'un magasin FHIR de l'API Cloud Healthcare dans un Google Cloud projet vers un magasin de données de recherche Vertex AI dans un Google Cloud projet différent et que vous utilisez VPC Service Controls, les deux projets doivent se trouver dans le même périmètre.
Créer une application
Vous pouvez créer une application de recherche de services de santé dans la console Google Cloud ou à l'aide de l'API. Pour créer une application de recherche de services de santé, procédez comme suit:
Console
Dans la console Google Cloud, accédez à la page Agent Builder.
Sur la page Applications, cliquez sur add_box Nouvelle application.
Sur la page Créer une application, sous Recherche dans le secteur de la santé, cliquez sur Créer.
Dans le volet Configuration de l'application de recherche, sélectionnez Santé.
Pour activer les fonctionnalités LLM avancées pour cette application, cliquez sur le bouton d'activation/de désactivation Fonctionnalités LLM avancées.
Activez les fonctionnalités LLM avancées pour obtenir des résumés de recherche, qui sont de courts résumés des résultats de recherche les plus pertinents.
Lorsque vous activez les fonctionnalités LLM, la disponibilité des fonctionnalités compatibles peut prendre jusqu'à cinq minutes.
Dans le champ Nom de votre application, saisissez le nom de votre application.
Dans le champ Nom externe de votre entreprise ou organisation, saisissez le nom commun de votre entreprise ou organisation. Vous n'avez pas besoin d'inclure de suffixes tels que "Inc." ou "LLC". Ce champ permet au LLM d'identifier l'entreprise représentée par l'application.
Dans la section Access Transparency (Transparence des accès), sélectionnez Disable search metrics for this app (Désactiver les métriques de recherche pour cette application) pour désactiver les métriques de journalisation pour l'application actuelle. Ce paramètre ne peut pas être modifié une fois l'application créée.
Cliquez sur Continuer.
Pour vous connecter à un data store, sur la page Datastores (Datastores), effectuez l'une des opérations suivantes:
- Sélectionnez un datastore de données de santé existant pour l'importation par lot ou un connecteur de données existant pour l'importation en streaming. Pour créer un datastore ou un connecteur de données avant de créer une application, consultez Créer un datastore de données de santé.
- Créez un data store (pour une importation par lot unique) ou un connecteur de données, qui est une instance d'un data store (pour une importation en streaming) :
- Cliquez sur add_box Créer un datastore.
- Dans le volet Sélectionner une source de données, sélectionnez API Healthcare (FHIR) comme source de données.
- Pour importer des données depuis votre store FHIR, procédez comme suit :
- Sélectionnez le magasin FHIR dans la liste des magasins FHIR disponibles :
- Développez le champ Magasin FHIR.
- Dans cette liste, sélectionnez un ensemble de données situé dans un emplacement autorisé, puis un magasin FHIR qui utilise la version R4 de FHIR.
- Saisissez le magasin FHIR manuellement :
- Développez le champ Magasin FHIR.
- Cliquez sur Saisir manuellement le magasin FHIR.
- Dans la boîte de dialogue Nom du magasin FHIR, saisissez le nom complet du magasin FHIR au format suivant:
project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID
- Cliquez sur Enregistrer.
- Sélectionnez le magasin FHIR dans la liste des magasins FHIR disponibles :
- Dans la section Synchronisation, sélectionnez l'une des options suivantes.
Une fois le data store créé, cette sélection ne peut plus être modifiée.
- Unique: pour effectuer une importation de données par lot unique. Pour d'autres importations incrémentielles, consultez Actualiser les données de santé.
- Streaming: pour effectuer une importation de données en streaming en quasi-temps réel. Pour diffuser des données, vous devez créer un connecteur de données, qui est un type de stockage de données. Pour configurer un entrepôt de données en streaming à l'aide de l'API REST, contactez votre ingénieur client.
- Dans la section Quel est le schéma pour ces données ?, sélectionnez l'une des options suivantes :
- Schéma prédéfini Google: permet de conserver les configurations de schéma définies par Google, telles que l'indexabilité, la recherche et la récupération, pour les ressources et éléments FHIR compatibles. Une fois que vous avez sélectionné cette option, vous ne pouvez plus modifier le schéma après avoir créé le data store. Si vous souhaitez pouvoir modifier le schéma après la création du datastore, sélectionnez l'option Schéma personnalisé.
- Cliquez sur Continuer.
- Dans le champ Nom de votre data store, saisissez un nom pour votre data store.
- Cliquez sur Créer.
Le data store que vous avez créé est listé sur la page Datastores (Datastores).
- Schéma personnalisé: permet de définir vos propres configurations de schéma, telles que l'indexabilité, la recherche et la récupération, pour les ressources et éléments FHIR compatibles. Pour configurer un schéma configurable, contactez votre ingénieur client.
- Cliquez sur Continuer.
- Examinez le schéma, développez chaque champ et modifiez les paramètres de champ.
- Cliquez sur Ajouter des champs pour ajouter des champs aux ressources FHIR compatibles. Vous ne pouvez pas supprimer les champs fournis dans le schéma défini par Google.
- Cliquez sur Continuer.
- Dans le champ Nom de votre connecteur de données, saisissez un nom pour votre connecteur de données.
- Cliquez sur Créer.
Le connecteur de données que vous avez créé est listé sur la page Datastores (Datastores). Le magasin FHIR source est ajouté en tant qu'entité dans le connecteur de données.
- Schéma prédéfini Google: permet de conserver les configurations de schéma définies par Google, telles que l'indexabilité, la recherche et la récupération, pour les ressources et éléments FHIR compatibles. Une fois que vous avez sélectionné cette option, vous ne pouvez plus modifier le schéma après avoir créé le data store. Si vous souhaitez pouvoir modifier le schéma après la création du datastore, sélectionnez l'option Schéma personnalisé.
- Cliquez sur Continuer.
- Sélectionnez le data store ou le connecteur de données créé.
Facultatif: Pour afficher la liste des entrepôts de données indisponibles, cliquez sur En savoir plus.
Un tableau s'affiche avec la liste des data stores et la raison pour laquelle ils ne sont pas disponibles. Voici quelques raisons pour lesquelles un entrepôt de données peut être indisponible:
- Votre type de datastore ne permet de se connecter qu'à une seule application, et le datastore est déjà connecté.
- Votre data store et votre application sont de types différents. Par exemple, vous ne pouvez pas associer un datastore de données de recherche sur un site Web à une application de recherche de données de santé.
Cliquez sur Créer.
Si l'application et son data store sont créés, la page d'informations du data store affiche les détails des données FHIR importées.
REST
- Créez un datastore de données de santé et importez-y des données de santé.
Créez une application de recherche de données de santé et associez-la à un datastore. Une application de recherche de données de santé ne peut être associée qu'à un seul datastore, mais un datastore donné peut être associé à plusieurs applications.
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"] } }'
Remplacez les éléments suivants :
PROJECT_ID
: ID de votre Google Cloud projet.APP_ID
: ID de l'application Vertex AI Search que vous souhaitez créer.APP_DISPLAY_NAME
: nom à afficher de l'application Vertex AI Search que vous souhaitez créer.DATA_STORE_ID
: ID d'un data store Vertex AI Search existant que vous souhaitez ajouter à l'application Vertex AI Search.SEARCH_ADD_ON
: champ facultatif permettant d'indiquer si vous souhaitez utiliser les fonctionnalités LLM avancées, telles que la recherche avec des réponses d'IA générative, pour cette application. Pour activer les fonctionnalités LLM avancées, saisissez la valeurSEARCH_ADD_ON_LLM
. Si vous ne souhaitez pas utiliser les fonctionnalités LLM avancées, spécifiezSEARCH_ADD_ON_UNSPECIFIED
ou supprimez le champsearchAddOns
. Pour en savoir plus, consultez la section Fonctionnalités LLM avancées.
Vérifier la création de l'application
Cette tâche vous explique comment vérifier si une application de recherche pour les services de santé a bien été créée et si les données FHIR ont bien été importées dans le datastore.
- Dans la console Google Cloud: sélectionnez l'application et vérifiez ses informations.
- Via l'API REST, utilisez la méthode
engines.get
pour obtenir les détails du magasin de données de santé.
Pour vérifier la création du datastore et l'importation des données, procédez comme suit :
Console
Dans la console Google Cloud, accédez à la page Agent Builder.
Sur la page Applications, vérifiez si l'application que vous avez créée figure dans la liste.
Vérifiez que le data store que vous avez connecté à l'application est listé dans le tableau Data stores connectés.
Sélectionnez le data store et vérifiez ses informations.
REST
Vérifiez la création de l'application.
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"
Remplacez les éléments suivants :
PROJECT_ID
: ID de votre Google Cloud projet.APP_ID
: ID de l'application Vertex AI Search.
Vérifiez la création du datastore et l'importation des données FHIR.
Étape suivante
- Rechercher des données de santé dans votre application de recherche Healthcare
- Actualisez les données de santé.