Créer une application de recherche de données de santé

Pour rechercher des données cliniques dans la recherche d'agent, 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, connectez-le à une application de recherche de données de santé et interrogez les données cliniques. Pour en savoir plus, consultez la page Créer un datastore de santé.
  • Créez une application de recherche de données de santé, créez un data store de 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 différentes manières :

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

  • Importation en flux continu : importation de données en flux continu en temps quasi réel. Toutes les modifications incrémentielles apportées au datastore FHIR source sont synchronisées dans le data store de recherche d'agent. La diffusion en flux continu nécessite un data connecteur, qui est un type de data store. 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 en flux continu, et effectuer une synchronisation manuelle chaque fois que nécessaire. Pour en savoir plus, consultez la section Gérer un datastore de recherche de données de santé.

    Le débit de diffusion des données pour un projet donné Google Cloud est dépendant des quotas suivants. Si vous dépassez le quota, vous risquez de rencontrer des retards de diffusion.

    • Nombre d'écritures en flux continu 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 lors de la création du data store. Vous ne pourrez plus modifier cette configuration par la suite.

Avant de commencer

Avant de créer l'application de recherche de données de santé, tenez compte des 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.

  • La préparation de vos données FHIR pour l'ingestion.

  • La recherche d'agent pour le secteur de la santé ne fournit des services de recherche que dans la région multirégionale des États-Unis (us). Par conséquent, votre application de recherche de données de santé et vos datastores doivent résider dans la région multirégionale us.

  • Si vous importez des données de santé depuis un datastore FHIR de l'API Cloud Healthcare dans un seul Google Cloud projet vers un data store de recherche d'agent dans un autre Google Cloud projet 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 données de santé dans la Google Cloud console ou à l'aide de l' API. Pour créer une application de recherche de données de santé, procédez comme suit :

Console

  1. Dans la Google Cloud console, accédez à la page AI Applications.

    AI Applications

  2. Sur la page Apps (Applications), cliquez sur New app (Nouvelle application).

  3. Sur la page Create App (Créer une application), sous Healthcare search (Recherche de données de santé), cliquez sur Create (Créer).

  4. Dans le volet Search app configuration (Configuration de l'application de recherche), sélectionnez Healthcare (Santé).

  5. Pour activer les réponses génératives qui utilisent des fonctionnalités LLM avancées pour cette application, cliquez sur le bouton Generative responses (Réponses génératives) pour l'activer.

    Lorsque vous activez les réponses génératives, la disponibilité des fonctionnalités compatibles peut prendre jusqu'à cinq minutes.

  6. Dans le champ Your app name (Nom de votre application), saisissez le nom de votre application.

  7. Dans le champ External name of your company or organization (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 est utile pour que le LLM identifie l'entreprise que l'application représente.

  8. 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 de l'application actuelle. Vous ne pourrez plus modifier ce paramètre une fois l'application créée.

  9. Cliquez sur Continue (Continuer).

  10. Pour vous connecter à un data store, sur la page Data Stores (Datastores), 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 flux continu. Pour créer un data store ou un connecteur de données avant de créer une application, consultez la section Créer un datastore de santé.
    • Créez un data store (pour l'importation par lot ponctuelle) ou un connecteur de données, qui est une instance de data store (pour l'importation en flux continu) :
      1. Cliquez sur Create data store (Créer un datastore).
      2. Dans le volet Select a data source (Sélectionner une source de données), sélectionnez Healthcare API (FHIR) (API Healthcare (FHIR)) comme source de données.
      3. Pour importer des données depuis votre datastore FHIR, effectuez l'une des opérations suivantes :
        • Sélectionnez le datastore FHIR dans la liste des datastores FHIR disponibles :
          1. Développez le champ FHIR store (Datastore FHIR).
          2. Dans cette liste, sélectionnez un ensemble de données qui réside dans un emplacement autorisé et puis sélectionnez un datastore FHIR qui utilise la version FHIR R4.
        • Saisissez manuellement le datastore FHIR :
          1. Développez le champ FHIR store (Datastore FHIR).
          2. Cliquez sur Enter FHIR store manually (Saisir manuellement le datastore FHIR).
          3. Dans la boîte de dialogue FHIR store name (Nom du datastore FHIR), saisissez le nom complet du datastore FHIR au format suivant :

            project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID

          4. Cliquez sur Save (Enregistrer).
      4. Dans la section Synchronization (Synchronisation), sélectionnez l'une des options suivantes. Une fois créé, ce paramètre ne peut plus être modifié.
        • One time (Ponctuel) : pour effectuer une importation par lot ponctuelle de données. Pour d'autres importations incrémentielles, consultez la section Actualiser les données de santé.
        • Streaming (Diffusion en flux continu) : pour effectuer une importation de données en flux continu en temps quasi réel. Pour diffuser des données en flux continu, vous devez créer un connecteur de données, qui est un type de data store. Pour configurer un data store en flux continu à l'aide de l'API REST, contactez votre ingénieur client.
      5. Dans la section What is the schema for this data? (Quel est le schéma de ces données ?), sélectionnez l'une des options suivantes :
        • Schéma prédéfini Google : pour conserver les configurations de schéma définies par Google, telles que l'indexabilité, la capacité de recherche et la récupérabilité, pour les ressources et éléments FHIR compatibles. Une fois cette option sélectionnée, vous ne pourrez 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 Custom schema (Schéma personnalisé).
          1. Cliquez sur Continue (Continuer).
          2. Dans le champ Your data store name (Nom de votre datastore), attribuez un nom à votre datastore.
          3. Cliquez sur Create (Créer).

            4. Le data store que vous avez créé est répertorié sur la page Data Stores (Datastores).

        • Custom schema (Schéma personnalisé) : pour définir vos propres configurations de schéma, telles que l'indexabilité, la capacité de recherche et la récupérabilité, pour les ressources et éléments FHIR compatibles. Pour configurer un schéma configurable, contactez votre ingénieur client.
          1. Cliquez sur Continue (Continuer).
          2. Examinez le schéma, développez chaque champ et modifiez les paramètres des champs.
          3. Cliquez sur Add new fields (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 Continue (Continuer).
          5. Dans le champ Your data connector name (Nom de votre connecteur de données), saisissez le nom de votre connecteur de données.
          6. Cliquez sur Create (Créer).

            7. Le connecteur de données que vous avez créé est répertorié sur la page Data Stores (Datastores). Le datastore FHIR source est ajouté en tant qu'entité dans le connecteur de données.

      6. Cliquez sur Continue (Continuer).
      7. Sélectionnez le data store ou le connecteur de données créé.

  11. Facultatif : Pour afficher la liste des datastores non disponibles, cliquez sur Learn why (En savoir plus).

    Un tableau s'affiche avec la liste des datastores et la raison pour laquelle ils ne sont pas disponibles. Voici quelques raisons pour lesquelles un data store peut ne pas être disponible :

    • Votre type de data store n'autorise la connexion 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 connecter un data store de recherche de site Web à une application de recherche de données de santé.

  12. Cliquez sur Create (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 de données de santé et connectez-la à un data store. Une application de recherche de données de santé ne peut être associée qu'à un seul data store, mais un data store 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 de recherche d'agent que vous souhaitez créer.
    • APP_DISPLAY_NAME : nom à afficher de l'application de recherche d'agent que vous souhaitez créer.
    • DATA_STORE_ID: ID d'un data store de recherche d'agent existant que vous souhaitez ajouter à l'application de recherche d'agent.
    • SEARCH_ADD_ON : champ facultatif permettant de spécifier 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 données de santé a été créée et si les données FHIR ont été importées dans le data store.

  • Dans la Google Cloud console : sélectionnez l'application et vérifiez ses détails.
  • Via l'API REST, utilisez la engines.get méthode 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 Google Cloud console, accédez à la page AI Applications.

    AI Applications

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

  3. Vérifiez que le data store que vous avez connecté à l'application est répertorié dans le tableau Connected data stores (Datastores connectés).

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

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/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 de recherche d'agent.

  2. Vérifiez la création du data store et l'importation des données FHIR.

Étape suivante