Configurer un data store Microsoft OneDrive

Cette page explique comment créer un data store et associer Microsoft OneDrive à Gemini Enterprise.

Avant de commencer

Remarque : Pour appliquer le contrôle des accès aux sources de données et sécuriser les données dans Gemini Enterprise, assurez-vous d'avoir configuré votre fournisseur d'identité.

Avant de configurer votre connexion Microsoft OneDrive, vérifiez les points suivants.

1. Attribuez le rôle d'éditeur Discovery Engine (roles/discoveryengine.editor). Ce rôle est nécessaire pour que l'utilisateur puisse créer le datastore. Pour attribuer ce rôle, procédez comme suit :

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

      Accéder à IAM

   2. Recherchez le compte utilisateur, puis cliquez sur modifier Modifier.
   3. Accordez le rôle Discovery Engine Editor à l'utilisateur. Pour en savoir plus, consultez Rôles et autorisations IAM.

2. Enregistrez Gemini Enterprise en tant qu'application OAuth 2.0 dans Microsoft Entra ID et obtenez les identifiants suivants :

   • ID client

   • Code secret du client

   • ID du locataire

3. Configurez les autorisations d'application de l'API Microsoft avec l'autorisation d'un administrateur Microsoft OneDrive.

Créer un datastore Microsoft OneDrive

Pour créer un datastore Microsoft OneDrive, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

   Gemini Enterprise

2. Sélectionnez ou créez un projet Google Cloud .

3. Dans le menu de navigation, cliquez sur Datastores.

4. Cliquez sur Créer un datastore.

5. Dans la section Source, recherchez Microsoft OneDrive, puis cliquez sur Sélectionner.

6. Dans la section Données :

   1. Dans la section Mode du connecteur, sélectionnez Ingestion de données ou Recherche unifiée comme mode de connexion.

   2. Cliquez sur Continuer.

   3. Dans la section Paramètres d'authentification, configurez l'authentification en fonction du mode de connexion choisi.

      1. Fournissez les informations d'authentification suivantes :
         • ID client : identifiant unique de l'application enregistrée dans le locataire Microsoft Entra ID de votre organisation.
         • Code secret du client : clé secrète générée lors de l'enregistrement de l'application OAuth 2.0 dans Microsoft Entra ID.

         • ID du locataire : identifiant unique de votre organisation dans le centre d'administration Microsoft Entra. Pour en savoir plus, consultez Obtenir les identifiants client.

         • Type d'environnement Microsoft OneDrive : sélectionnez l'environnement qui héberge votre locataire Microsoft 365 :

           • Sélectionnez Standard (par défaut) si vous vous connectez à Microsoft 365 Commercial standard ou à Government Community Cloud (GCC).
           • Sélectionnez US Government si vous vous connectez à un cloud souverain Microsoft 365 US Government (GCC High ou DoD).
         Remarque : Ces paramètres ne s'appliquent qu'aux clients Microsoft 365 US Government (cloud souverain). Si vous vous connectez à un cloud US Government, utilisez la combinaison correspondante. Sinon, conservez les valeurs par défaut (Standard et Global) :

         • GCC : type d'environnement Standard, environnement cloud GCC.
         • GCC High : type d'environnement US Government, environnement cloud GCC High.
         • DoD : type d'environnement US Government, environnement cloud DoD.

      • Si vous avez sélectionné Ingestion de données avec la méthode d'authentification Identifiants fédérés, copiez l'identifiant de l'objet et utilisez-le pour ajouter des identifiants fédérés pour l'ingestion de données.

        • Identifiant de l'objet : identifiant unique du compte de service que vous prévoyez d'utiliser.

      • Si vous avez sélectionné Recherche unifiée, cliquez sur Se connecter et connectez-vous à Microsoft.

   4. Cliquez sur Continuer.

   5. Si vous avez sélectionné Recherche unifiée, procédez comme suit :

      1. Dans la section Destinations, saisissez l'URL de base de votre site Microsoft OneDrive.

      2. Dans la section Options avancées :

         1. Sélectionnez votre environnement cloud Microsoft 365:
            • Si vous vous connectez à une instance Microsoft 365 US Government, sélectionnez l'option correspondante : GCC, GCC High ou DoD.
            • Sinon, conservez la valeur par défaut Global.
         2. Dans le champ Locataire Azure, saisissez l'ID de locataire que vous avez obtenu lorsque vous avez créé l'application Entra.

         3. Vous pouvez affiner la portée de vos recherches et actions en spécifiant les chemins d'accès Microsoft OneDrive à inclure ou à exclure. Vous ne pouvez modifier ou récupérer des données que dans les chemins d'accès inclus. Les requêtes de données hors champ d'application échouent ou ne renvoient aucun résultat.

            Vous pouvez ajouter des filtres au data store à l'aide de la Google Cloud console ou de l'API :

            Console

            Remarque : Lorsque vous saisissez plusieurs sites, séparez chaque URL par une virgule. Vous pouvez également copier et coller une liste d'URL directement à partir d'un fichier CSV.

            1. Dans la section "Filtre de chemin d'accès" :
               • Choisissez le type de filtre : Inclure dans la recherche ou Exclure de la recherche.
               • Dans le champ Filtre de chemin d'accès, saisissez les chemins d'accès OneDrive complets.

                 Remarque : Ce champ est compatible avec les sous-chemins d'accès, les dossiers et les bibliothèques de documents au format https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/. Tout contenu dans le chemin d'accès spécifié sera filtré.

            REST

            Pour ajouter des filtres lors de la création d'un datastore, appelez la méthode setUpDataConnector.

            curl -X POST \
                    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
                    -H "Content-Type: application/json" \
                    -H "X-Goog-User-Project: PROJECT_ID" \
                    "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
                    -d '{
                    "collectionId": "COLLECTION_ID",
                    "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
                    "dataConnector": {
                        "dataSource": "sharepoint_federated_search",
                        "params": {
                        "client_id": "CLIENT_ID",
                        "client_secret": "CLIENT_SECRET",
                        "instance_uri": "INSTANCE_URI",
                        "tenant_id": "TENANT_ID",
                        "FILTER_TYPE": {
                            "FILTER_KEY": [
                            "FILTER_VALUE1",
                            "FILTER_VALUE2"
                            ]
                        }
                        },
                        "entities": [
                        {
                            "entityName": "file"
                        }
                        ],
                        "refreshInterval": "7200s",
                        "connectorType": "THIRD_PARTY_FEDERATED",
                        "connectorModes": [
                        "FEDERATED"
                        ]
                    }
                    }'
                    

            Remplacez les éléments suivants :

            • PROJECT_ID : l'ID du projet.
            • ENDPOINT_LOCATION : l'emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :
              • us pour l'emplacement multirégional US
              • eu pour l'emplacement multirégional EU
              • global pour l'emplacement mondial
              Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
            • LOCATION : emplacement multirégional de votre datastore : global, us ou eu
            • COLLECTION_ID : identifiant unique du data store.
            • COLLECTION_DISPLAY_NAME : nom à afficher pour le datastore.
            • CLIENT_ID : ID client pour l'authentification Microsoft OneDrive.
            • CLIENT_SECRET : code secret du client pour l'authentification Microsoft OneDrive.
            • INSTANCE_URI : URI de l'instance pour Microsoft OneDrive.
            • TENANT_ID : ID de locataire pour Microsoft OneDrive.
            • FILTER_TYPE : type de filtre ajouté à vos datastore Microsoft OneDrive. Pour en savoir plus, consultez Types de filtres.
            • FILTER_KEY : clé du filtre, correspondant à un champ de vos données. Pour en savoir plus, consultez Clés de filtre.
            • FILTER_VALUES : valeur ou valeurs à filtrer pour la FILTER_KEY spécifiée.

         Pour en savoir plus sur les types de filtres et l'ajout de filtres, consultez Ajouter des filtres à un datastore Microsoft OneDrive.

   6. Si vous avez sélectionné Ingestion de données, dans la section Options avancées, procédez comme suit :

      1. Facultatif : Pour autoriser un ensemble d'adresses IP statiques dans votre système, cochez la case Activer les adresses IP statiques. Pour en savoir plus, consultez Configurer la sortie IP statique.
      2. Facultatif : Dans le champ RPS max., saisissez le nombre maximal de requêtes par seconde pour appliquer une limite de débit aux requêtes envoyées par le connecteur à l'instance Microsoft OneDrive.
      3. Facultatif : Pour tenter de déchiffrer tous les fichiers chiffrés avec la protection des informations Microsoft Purview, cochez la case Déchiffrer les fichiers chiffrés avec la protection des informations Microsoft Purview.

   7. Cliquez sur Continuer.

   8. Dans la section Entités à rechercher (si vous avez sélectionné Recherche unifiée) ou Entités à synchroniser (si vous avez sélectionné Ingestion de données) :

      1. Sélectionnez toutes les entités requises.
      2. Si vous avez sélectionné Recherche unifiée, passez à l'étape suivante.
      3. Si vous avez sélectionné Ingestion de données, procédez comme suit :
         1. Vous pouvez éventuellement synchroniser des projets spécifiques en procédant comme suit :
            1. Cliquez sur Filtrer.
            2. Cochez la case Exclure de l'index pour filtrer les entités de l'index ou Inclure dans l'index pour vous assurer qu'elles y sont incluses.
            3. Saisissez les clés. Appuyez sur Entrée après chaque clé.
            4. Cliquez sur Enregistrer.
         2. Pour configurer la planification de synchronisation, procédez comme suit :
            1. Dans la liste Fréquence de synchronisation, sélectionnez la fréquence de synchronisation.
               • Pour planifier des synchronisations complètes distinctes pour les données d'entité et d'identité, développez le menu sous Synchronisation complète, puis sélectionnez Options personnalisées.
            2. Dans la liste Fréquence de synchronisation incrémentielle, sélectionnez la fréquence de synchronisation incrémentielle. Pour en savoir plus, consultez Planification de synchronisation.

7. Cliquez sur Continuer.

8. Dans la section Actions :

   1. Si vous avez sélectionné Recherche unifiée:
      1. Dans Sélectionnez les actions Microsoft OneDrive à activer, sélectionnez les actions de la catégorie afin de les activer pour le connecteur.

   2. Si vous avez sélectionné Ingestion de données :

      1. Dans la section Paramètres d'authentification, configurez l'authentification en fonction du mode de connexion choisi. Fournissez les informations d'authentification suivantes :

         • ID client : identifiant unique de l'application enregistrée dans le locataire Microsoft Entra ID de votre organisation.
         • Code secret du client : clé secrète générée lors du processus d'enregistrement de l'application OAuth 2.0 dans Microsoft Entra ID.
         • ID du locataire : identifiant unique de votre organisation dans le centre d'administration Microsoft Entra.

         Pour en savoir plus, consultez Obtenir les identifiants client.

      2. Cliquez sur Se connecter et connectez-vous à Microsoft OneDrive pour valider votre compte.

      3. Cliquez sur Continuer.

      4. Dans la section Paramètres avancés, saisissez le locataire Azure, à savoir l'ID de locataire que vous avez obtenu lorsque vous avez créé l'application Entra.

      5. Dans la section Destinations, saisissez l'URL de base de votre site Microsoft OneDrive.

      6. Dans Sélectionnez les actions Microsoft OneDrive à activer, sélectionnez les actions de la catégorie afin de les activer pour le connecteur.

9. Cliquez sur Continuer.

   Remarque : Si vous ignorez l'ajout d'actions à cette étape, vous pourrez les ajouter plus tard. Pour en savoir plus, consultez Ajouter des actions.

   Pour afficher et gérer la liste des actions, consultez Afficher et gérer les actions.

10. Dans la section Configuration :

    1. Dans la liste Multirégional, sélectionnez l'emplacement de votre connecteur de données.
    2. Dans le champ Nom de votre connecteur de données, saisissez le nom de votre connecteur.
    3. Si vous avez sélectionné us ou eu comme emplacement, configurez les paramètres de chiffrement:
       • Facultatif : Si vous n'avez pas configuré de clés à région unique, cliquez sur Accéder à la page des paramètres pour le faire. Pour en savoir plus, consultez Enregistrer une clé à région unique pour les connecteurs tiers.
       • Sélectionnez Clé de chiffrement gérée parGoogle ou Clé Cloud KMS.
       • Si vous avez sélectionné Clé Cloud KMS :
         • Dans la liste Type de gestion des clés, sélectionnez le type approprié.
         • Dans la liste Clé Cloud KMS, sélectionnez la clé.
       Pour en savoir plus, consultez Clés de chiffrement gérées par le client.

11. Cliquez sur Continuer.

12. Dans la section Facturation, sélectionnez Tarification générale ou Tarification configurable. Pour en savoir plus, consultez Vérifier l'état de facturation de vos projets et Licences.

13. Cliquez sur Créer. Gemini Enterprise crée votre datastore et l'affiche sur la page Datastores.

Sur la page Datastores, cliquez sur le nom de votre datastore pour afficher l'état. Une fois que l'état du datastore passe de Création à Actif, le connecteur Microsoft OneDrive est prêt à être utilisé.

Pour un connecteur d'ingestion créé avec Microsoft OneDrive, l'état du datastore passe de Création à En cours d'exécution lors du lancement de la synchronisation. Il passe ensuite à Actif une fois l'ingestion terminée, ce qui signifie que le datastore est entièrement configuré. Selon le volume de données, l'ingestion peut prendre plusieurs heures.

Après avoir créé le datastore, créez une application, associez-la au datastore Microsoft OneDrive et autorisez Gemini Enterprise à accéder à Microsoft OneDrive avant d'exécuter des requêtes.

Activer la synchronisation en temps réel pour l'ingestion de données

Preview — Synchronisation en temps réel

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Remarque : La synchronisation en temps réel n'est disponible que pour le mode de connexion Ingestion de données.

Pour activer la synchronisation en temps réel pour votre datastore, procédez comme suit.

1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

   Gemini Enterprise

2. Dans le menu de navigation, cliquez sur Datastores.

3. Cliquez sur le nom du datastore Microsoft OneDrive pour lequel vous souhaitez activer la synchronisation en temps réel.

4. Sur la page Données du datastore, attendez que l'état du connecteur passe à Actif.

5. Dans le champ Synchronisation en temps réel, cliquez sur Afficher/Modifier.

6. Pour activer la synchronisation en temps réel, cliquez sur le bouton Activer la synchronisation en temps réel.

7. Dans le champ Code secret du client, saisissez une valeur. Cette valeur permet de vérifier les événements du webhook Microsoft OneDrive. Nous vous recommandons d'utiliser une chaîne de 20 caractères.

8. Cliquez sur Enregistrer.

   Attendez que le champ Synchronisation en temps réel passe à Exécution.

Traitement des données et exécution de la requête

Cette section décrit comment Gemini Enterprise gère votre requête et les implications en termes de confidentialité de l'utilisation du datastore fédéré.

Exécution de la requête

Après avoir autorisé Microsoft OneDrive et envoyé une requête de recherche à Gemini Enterprise :

• Gemini Enterprise envoie votre requête de recherche directement à l'API Microsoft.
• Gemini Enterprise fusionne les résultats avec ceux des autres sources de données connectées et affiche un résultat de recherche complet.

Traitement des données

Lorsque vous utilisez la recherche unifiée tierce, les règles de traitement des données suivantes s'appliquent :

• Votre chaîne de requête est envoyée au backend de recherche tiers (API Microsoft).
• Ces tiers peuvent associer les requêtes à votre identité.
• Si plusieurs sources de données de recherche unifiée sont activées, la requête peut être envoyée à chacune d'elles.
• Une fois les données transférées vers le système tiers, elles sont régies par les conditions d'utilisation et les règles de confidentialité de ce système.

Remarque : Pour améliorer la précision, un LLM peut réécrire votre requête avant de l'envoyer à Microsoft OneDrive. Cette requête réécrite peut inclure des informations provenant de l'historique des requêtes de votre session. Par conséquent, des parties de votre historique des requêtes peuvent également être incluses dans la requête envoyée à l'API Microsoft.

Étape suivante

• Pour fournir une interface utilisateur permettant d'interroger vos données Microsoft OneDrive, créez une application et associez-la au datastore Microsoft OneDrive.
• Pour afficher et gérer la liste des actions, consultez Afficher et gérer les actions.
• Pour prévisualiser l'apparence de vos résultats de recherche une fois votre application configurée, consultez Obtenir des résultats de recherche.
• Pour activer les alertes pour le data store, consultez Configurer des alertes pour les datastores tiers.