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 de ces workflows :

  • 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 services de santé et interrogez les données cliniques. Pour plus pour plus d'informations, consultez la page Créer un data store 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 datastore de plusieurs façons :

  • Importation par lots: une importation unique. Les données sont importées dans un entrepôt de données. Pour des importations incrémentielles supplémentaires, consultez Actualiser les données de santé.

  • Importation par flux (version Preview) : importation de données par flux en quasi-temps réel. N'importe quelle valeur les modifications incrémentielles dans le store FHIR source sont synchronisées dans le dans le data store Vertex AI Search. Le streaming nécessite un connecteur de données, qui est un type de datastore contenant une entité. Une entité est aussi un Cloud 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 datastore. Vous ne pourrez pas 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 le secteur de la santé.

Avant de commencer

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

  • Comprendre la relation entre les applications et les data stores pour la recherche dans le domaine de la santé Pour en savoir plus, consultez À propos des applications et des data stores.

  • 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 médicale dans la console Google Cloud ou à l'aide de API. Voici les différences entre les deux approches:

  • Dans la console Google Cloud: sélectionnez le store FHIR source dans L'API Cloud Healthcare permet d'importer des données FHIR dans l'application de recherche médicale. le processus de création. 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 store FHIR de l'API Cloud Healthcare. Le store FHIR peut se trouver dans le même projet Google Cloud ou dans un autre projet.
    1. Utilisez les dataStores.create pour créer un data store de santé.
    2. Utilisez les documents.import permettant de spécifier le store FHIR dans l'API Cloud Healthcare et d'importer des données FHIR données.
    3. Utilisez les engines.create pour créer l'application de recherche dans le domaine de la santé et spécifier un état de santé existant dans le data store.

Pour créer une application de recherche médicale, 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, sélectionnez Recherche.

  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, le test du LLM peut prendre jusqu'à cinq minutes fonctionnalités prises en charge à venir.

  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 Data stores, effectuez l'une des opérations suivantes:

    • Sélectionnez un data store de santé existant pour effectuer une importation par lot ou un le connecteur de données existant pour l'importation en flux continu. Pour créer un data store ou un connecteur de données avant de créer une application, consultez Créez un data store 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 l'importation par flux):
      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, effectuez l'une des opérations suivantes:
        • Sélectionnez le store FHIR dans la liste des stores 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 store FHIR manuellement:
          1. Développez le champ Magasin FHIR.
          2. Cliquez sur Saisir le store 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 en savoir plus, pour les 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 magasin de données. Il s'agit d'une fonctionnalité en version preview. Pour configurer un entrepôt de données 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 Google prédéfini: 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. Une fois que vous avez sélectionné cette option, vous ne pouvez plus mettre à jour le schéma après avoir créé le datastore. Si vous souhaitez pouvoir modifier le schéma après la création du datastore, 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 répertorié sur la page Data stores.

        • 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 version 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 le champ paramètres.
          3. Cliquez sur Ajouter des champs pour ajouter des champs au des 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 répertorié sur la page Data stores. Le store FHIR source est ajouté en tant qu'entité dans les données le connecteur.

      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-unes des raisons pour lesquelles un data store non disponible:

    • 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 data store de recherche sur site Web à un service de recherche médicale l'application.

  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 datastore de données de santé et importez-y des données de santé.

  2. Créer une application de recherche médicale et l'associer à un data store Une application de recherche médicale se connectent à un data store, alors qu'un data store spécifique 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 à spécifier si vous souhaitez bénéficier des fonctionnalités LLM avancées, telles que la recherche avec l'IA générative, réponses de l'IA, pour cette application. Pour activer les fonctionnalités LLM avancées, saisissez le la valeur SEARCH_ADD_ON_LLM. Si vous ne voulez pas de fonctionnalités LLM avancées, spécifiez SEARCH_ADD_ON_UNSPECIFIED ou supprimez le searchAddOns. Pour en savoir plus, consultez la section Paramètres avancés Fonctionnalités LLM

Vérifier la création de l'application

Cette tâche vous explique comment vérifier si une application de recherche médicale a é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 détails.
  • 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 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 y figure. liste.

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

  4. Sélectionnez le data store vérifiez les détails du data store.

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érifier la création du data store et l'importation de données FHIR

Étape suivante