Configurer un datastore Google Drive

Cette page explique comment créer un data store et associer Google Drive à Gemini Enterprise. Cette association permet à Gemini Enterprise de récupérer directement des informations depuis Google Drive. Étant donné que les données ne sont pas copiées dans l'index Gemini Enterprise, vous n'avez pas à gérer le stockage des données.

Avant de commencer

  • Vous devez être connecté avec le même compte que celui que vous utilisez pour l'instance Google Drive que vous prévoyez d'associer dans la console Google Cloud . Gemini Enterprise utilise votre numéro client Google Workspace pour se connecter à Google Drive. Les comptes Google personnels (comptes personnels se terminant par @gmail.com) ne disposent pas de numéro client et ne sont pas compatibles.

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

  • Vérifiez que tous les documents sont accessibles, soit en les plaçant dans un Drive partagé appartenant au domaine, soit en attribuant la propriété à un utilisateur du domaine.

  • Activer les fonctionnalités intelligentes : dans votre compte Google Workspace, activez Fonctionnalités intelligentes dans Google Workspace et Fonctionnalités intelligentes dans d'autres Google produits. Pour en savoir plus, consultez Activer ou désactiver les fonctionnalités intelligentes de Google Workspace.

  • Ajouter l'application OAuth à la liste d'autorisation (administrateurs uniquement) : le datastore Google Drive utilise une application OAuth gérée par Googlepour accéder à vos données. Si votre organisation limite l'accès aux applications OAuth, votre administrateur Google Workspace doit ajouter cette application à la liste d'autorisation de votre organisation. Pour en savoir plus, consultez Ajouter l'application OAuth gérée par Googleà la liste d'autorisation.

Créer le data store Google Drive

Pour créer le datastore Google Drive, procédez comme suit :

  1. Dans la console Google 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 Google Drive, puis cliquez sur Sélectionner.

  6. Dans la section Actions, choisissez les actions dans la liste afin de les activer pour le connecteur Google Drive.

    Pour gérer la liste des actions, consultez Gérer les actions.

  7. Cliquez sur Continuer.

  8. 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 du 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:
      • 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.

  9. Facultatif : dans le champ Tag, saisissez un identifiant stable pour le datastore. Cet identifiant est utilisé dans différentes versions du connecteur et devient immuable une fois le data store créé. Choisissez donc une valeur que vous n'aurez pas besoin de modifier ultérieurement.

  10. Facultatif : dans la section Règle Sensitive Data Protection, associez une règle Sensitive Data Protection existante pour inspecter et anonymiser les données que Gemini Enterprise récupère via ce data store. Si votre organisation n'a pas besoin de règle Sensitive Data Protection, vous pouvez ignorer cette étape.

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

Pour vérifier l'état du datastore, procédez comme suit :

  1. Accédez au connecteur dans la liste des datastores et surveillez son état jusqu'à ce qu'il passe à Actif.
  2. Lorsque l'état du datastore passe de Création à Actif, le connecteur Google Drive est prêt à être utilisé.

Après avoir créé le datastore, créez une application et associez-la au datastore Google Drive avant d'exécuter la requête.

Exécution de la requête

Après avoir autorisé Google Drive, lorsque vous saisissez une requête de recherche :

  1. Gemini Enterprise envoie votre requête de recherche à l'API Google Drive.

  2. Gemini Enterprise fusionne les résultats avec ceux des autres sources et les affiche.

Messages d'erreur et dépannage

Le tableau suivant décrit les messages d'erreur, y compris les codes d'erreur HTTP et la procédure de dépannage suggérée, que vous pouvez rencontrer lorsque vous utilisez cette source de données Google .

Code d'erreur Message d'erreur Description Dépannage
403 Autorisation refusée La recherche à l'aide des identifiants de compte de service n'est pas compatible avec les datastores Google Workspace. Le moteur dans lequel la recherche est effectuée comporte des datastores Google Workspace, et les identifiants transmis sont ceux d'un compte de service. La recherche à l'aide des identifiants de compte de service dans les datastores Google Workspace n'est pas prise en charge. Appelez le service de recherche à l'aide des identifiants utilisateur ou supprimez les datastores Google Workspace du moteur.
403 Autorisation refusée Les comptes personnels ne sont pas compatibles avec les datastores Google Workspace. Le service de recherche est appelé à l'aide d'un identifiant de compte personnel (@gmail.com), qui n'est pas compatible avec les datastores Google Workspace. Supprimez les datastores Google Workspace du moteur ou utilisez un compte Google géré.
403 Autorisation refusée Non-concordance du numéro client pour le datastore La recherche n'est autorisée que pour les utilisateurs appartenant à la même organisation que les datastores Google Workspace. Supprimez les datastores Google Workspace du moteur ou contactez l'assistance si l'utilisateur et les datastores Google Workspace sont censés se trouver dans des organisations différentes.
403 Autorisation refusée L'administrateur de l'organisation a désactivé l'accès à Workspace pour Agentspace. Un administrateur Google Workspace a désactivé l'accès aux données Google Workspace pour Gemini Enterprise. Contactez votre administrateur Google Workspace pour activer l'accès.
400 Argument non valide La requête contient un argument non valide. Cette erreur se produit si le nom du connecteur de données dans la requête ne répond pas aux exigences de nommage. Vérifiez le nom du connecteur de données. Il doit comporter entre 1 et 63 caractères, commencer par une lettre minuscule, se terminer par une lettre minuscule ou un chiffre, et ne contenir que des lettres minuscules, des chiffres, des traits d'union ou des traits de soulignement. Par exemple, utilisez un nom tel que cymbal-collection-123456789 au lieu de 123456789-cymbal-collection.

Pour les problèmes de recherche courants que vous rencontrez lorsque vous interrogez vos données Google Drive, consultez Problèmes de recherche courants.

Étape suivante