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

  • Créez un data store de santé, importez des données FHIR R4 dans le data store, 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 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 par lot dans un data store. Pour d'autres importations incrémentielles, consultez 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 magasin FHIR source sont synchronisées dans le data store de la 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 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.

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é, comprenez les points suivants :

  • Relation entre les applications et les datastores pour la recherche de données de santé. Pour en savoir plus, consultez À propos des applications et des datastores.

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

  • La recherche d'agent pour Cloud Healthcare 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 magasin FHIR de l'API Cloud Healthcare dans un one Google Cloud projet vers un data store de recherche d'agent dans un different 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 Applications d'IA.

    AI Applications

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

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

  4. Dans le volet Configuration de l'application de recherche, sélectionnez 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 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 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 est utile pour que le LLM identifie l'entreprise que l'application représente.

  8. Dans la section Access Transparency, 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 Continuer.

  10. Pour vous connecter à un data store, sur la page Datastores, procédez de l'une des manières 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 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 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 magasin FHIR, procédez de l'une des manières suivantes :
        • 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 qui réside dans un emplacement autorisé et puis sélectionnez un magasin FHIR qui utilise la version FHIR R4.
        • Saisissez manuellement le magasin FHIR :
          1. Développez le champ Magasin FHIR.
          2. Cliquez sur Saisir manuellement le magasin FHIR.
          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 Synchronization (Synchronisation), sélectionnez l'une des options suivantes. Une fois créé, ce paramètre ne peut plus être modifié.
        • One time (Une seule fois) : pour effectuer une importation par lot ponctuelle de données. Pour d'autres importations incrémentielles, consultez 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 de diffusion 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 possibilité 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 Continuer.
          2. Dans le champ Nom de votre data store, attribuez un nom à votre datastore.
          3. Cliquez sur Créer.

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

        • Custom schema (Schéma personnalisé) : pour définir vos propres configurations de schéma, telles que l'indexabilité, la possibilité 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 Continuer.
          2. Examinez le schéma, développez chaque champ et modifiez les paramètres des champs.
          3. Cliquez sur Add new fields (Ajouter de nouveaux champs) pour ajouter de nouveaux 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 le nom de 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 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éé.

  11. Facultatif : Pour afficher la liste des datastores non disponibles, cliquez sur 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 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 associez-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 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 Applications d'IA.

    AI Applications

  2. Sur la page 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 associé à l'application est répertorié dans le tableau 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