Créer une application de recherche dans le secteur de la santé

Pour rechercher des données cliniques dans Vertex AI Search, vous pouvez suivre l'un des workflows suivants:

  • Créez un data store de santé, importez des données FHIR R4 dans le data store, associez-le à une application de recherche de services 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 dans le secteur de la santé, créez un data store dans le secteur de la santé et importez des données FHIR R4 dans le data store lors du processus de création de l'application, puis interrogez les données cliniques.

Cette page décrit la deuxième méthode.

À propos de la fréquence d'importation des données

Vous pouvez importer des données FHIR R4 dans un data store de plusieurs façons:

  • Importation par lots: importation ponctuelle. Les données sont importées dans un data store. Pour d'autres importations incrémentielles, consultez Actualiser les données de santé.

  • Importation par flux (version Preview): importation de données par 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 data store contenant une entité. Une entité est également une instance de data store.

    Le débit de streaming de données d'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 data store. Vous ne pourrez plus modifier cette configuration par la suite.

L'importation en streaming est disponible pour toutes les ressources compatibles avec Vertex AI Search. Pour en savoir plus, consultez la documentation de référence sur le schéma de données FHIR R4 pour les soins de santé.

Avant de commencer

Avant de créer l'application de recherche de services de santé, vous devez remplir les conditions suivantes:

  • Découvrez la relation entre les applications et les datastores pour la recherche de prestataires de santé. Pour en savoir plus, consultez À propos des applications et des datastores.

  • Préparez vos données FHIR pour l'ingestion.

  • 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égion us.

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. Les deux approches diffèrent comme suit:

  • Dans la console Google Cloud: sélectionnez le magasin FHIR source dans l'API Cloud Healthcare et importez les données FHIR dans le cadre du processus de création de l'application de recherche de services de santé. Pour diffuser des données FHIR (version Preview), votre magasin FHIR source doit se trouver dans le même projet Google Cloud que l'application Vertex AI Search de destination.
  • Via l'API REST: vous pouvez importer des données FHIR à partir d'un magasin FHIR de l'API Cloud Healthcare. Le magasin FHIR peut se trouver dans le même projet Google Cloud ou dans un autre.
    1. Utilisez la méthode dataStores.create pour créer un data store de santé.
    2. Utilisez la méthode documents.import pour spécifier le magasin FHIR dans l'API Cloud Healthcare et importer des données FHIR.
    3. Utilisez la méthode engines.create pour créer l'application de recherche de services de santé et spécifier un data store de services de santé existant.

Pour créer une application de recherche de services de santé, procédez comme suit:

Console

  1. Dans la console Google Cloud, accédez à la page Agent Builder.

    Agent Builder

  2. Sur la page Applications, cliquez sur  Nouvelle application.

  3. Sur la page Créer une application, sous Recherche de services de santé, cliquez sur Créer.

  4. Dans le volet Configuration de l'application de recherche, sélectionnez Santé.

  5. 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.

  6. Dans le champ Nom de votre application, saisissez le nom de votre application.

  7. 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 que l'application représente.

  8. Cliquez sur Continuer.

  9. Pour vous connecter à un data store, sur la page Datastores (Data stores), effectuez l'une des opérations suivantes:

    • Sélectionnez un data store de santé existant pour l'importation par lot ou un connecteur de données existant pour l'importation en streaming. Pour créer un data store 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) :
      1. Cliquez sur  Créer un datastore.
      2. Dans le volet Sélectionner une source de données, sélectionnez API Healthcare (FHIR) comme source de données.
      3. 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 :
          1. Développez le champ Magasin FHIR.
          2. 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.

            Pour diffuser des données FHIR (version Preview), votre magasin FHIR source doit se trouver dans le même projet Google Cloud que le data store Vertex AI Search de destination.

        • Saisissez le magasin FHIR manuellement :
          1. Développez le champ Magasin FHIR.
          2. Cliquez sur Saisir le magasin FHIR manuellement.
          3. 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

          4. Cliquez sur Enregistrer.
      4. 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.
        • Uniquement: 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 data store. Il s'agit d'une fonctionnalité en preview. Pour configurer un data store en streaming à l'aide de l'API REST, contactez votre ingénieur client.
      5. Dans la section Quel est le schéma de 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 mettre à jour le schéma après avoir créé le data store. Si vous souhaitez pouvoir modifier le schéma après la création du data store, sélectionnez l'option Schéma personnalisé (preview).
          1. Cliquez sur Continuer.
          2. Dans le champ Nom de votre data store, saisissez un nom pour votre data store.
          3. Cliquez sur Créer.
          4. Le data store que vous avez créé est listé sur la page Datastores (Datastores).

        • Schéma personnalisé (version Preview): 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. Il s'agit d'une fonctionnalité en preview. Pour configurer un schéma configurable, contactez votre ingénieur client.
          1. Cliquez sur Continuer.
          2. Examinez le schéma, développez chaque champ et modifiez les paramètres des champs.
          3. 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.
          4. Cliquez sur Continuer.
          5. Dans le champ Nom de votre connecteur de données, saisissez un nom pour votre connecteur de données.
          6. Cliquez sur Créer.
          7. 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.

      6. Cliquez sur Continuer.
      7. Sélectionnez le data store ou le connecteur de données créé.
  10. 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 data store peut être indisponible:

    • Votre type de data store 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 data store de recherche sur un site Web à une application de recherche de services de santé.
  11. 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

  1. Créez un data store de santé et importez-y des données de santé.
  2. Créez une application de recherche Healthcare et associez-la à un data store. Une application de recherche Healthcare ne peut se connecter qu'à un seul data store, tandis qu'un data store donné peut être connecté à 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/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"]
        }
    }'
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud
    • 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 valeur SEARCH_ADD_ON_LLM. Si vous ne souhaitez pas utiliser les fonctionnalités LLM avancées, spécifiez SEARCH_ADD_ON_UNSPECIFIED ou supprimez le champ searchAddOns. 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 de services de santé a bien été créée et si les données FHIR ont bien été importées dans le data store.

  • 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 data store de santé.

Pour vérifier la création du data store et l'importation des données, procédez comme suit :

Console

  1. Dans la console Google Cloud, accédez à la page Agent Builder.

    Agent Builder

  2. Sur la page Applications, vérifiez si l'application que vous avez créée figure dans la liste.

  3. Vérifiez que le data store que vous avez connecté à l'application est listé dans la colonne Data stores connectés.

  4. Sélectionnez le data store et vérifiez ses informations.

REST

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

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud
    • APP_ID: ID de l'application Vertex AI Search.
  2. Vérifiez la création du data store et l'importation des données FHIR.

Étape suivante