Le data store Google Drive pour Gemini Enterprise vous permet de rechercher des données Google Drive (y compris des fichiers et des dossiers) et d'effectuer des actions sur celles-ci.
Action compatible
Lorsque le data store Google Drive est activé, les utilisateurs finaux peuvent utiliser des commandes en langage naturel dans Gemini Enterprise pour effectuer les actions suivantes.
Les actions suivantes lisent les données Google Drive et sont activées par défaut :
| Action | Description |
|---|---|
| Télécharger le contenu du fichier | Télécharge le contenu d'un fichier Google Drive. |
| Obtenir les valeurs des cellules | Lit les valeurs des cellules d'une feuille de calcul Google Sheets. |
| Obtenir les métadonnées d'un fichier | Récupère les métadonnées d'un fichier Google Drive. |
| Obtenir les autorisations de fichiers | Répertorie les autorisations d'un fichier Google Drive. |
| Obtenir la feuille de calcul | Lit le contenu et les métadonnées d'une feuille de calcul Google Sheets. |
| Lister les fichiers récents | Répertorie les fichiers récents dans Google Drive. |
| Lister les Drive partagés | Répertorie les Drive partagés dans Google Drive. |
| Lire un document | Lit le contenu d'un document Google Docs. |
| Lire le contenu du fichier | Lit le contenu d'un fichier Google Drive. |
| Lire la présentation | Lit le contenu d'une présentation Google Slides. |
| Rechercher des fichiers | Recherche les fichiers Google Drive correspondant à une requête. |
Les actions suivantes modifient les données Google Drive et sont désactivées par défaut jusqu'à ce qu'un administrateur les active :
| Action | Description |
|---|---|
| Copier le fichier | Copie un fichier dans Google Drive. |
| Créer un fichier | Crée un fichier dans Google Drive. |
| Insérer une dimension | Insère des lignes ou des colonnes dans une feuille de calcul Google Sheets. |
| Partager un fichier | Partage un fichier Google Drive avec un ou plusieurs utilisateurs. |
| Placer le fichier dans la corbeille | Déplace un fichier Google Drive vers la corbeille. |
| Mettre à jour les valeurs des cellules | Écrit des valeurs de cellule dans une feuille de calcul Google Sheets. |
| Mettre à jour le fichier | Met à jour un fichier Google Drive existant. |
| Mettre à jour les formules | Écrit des formules dans une feuille de calcul Google Sheets. |
Les actions s'exécutent avec les autorisations de l'utilisateur qui a autorisé le connecteur. Un utilisateur ne peut lire et modifier que les données qu'il peut déjà lire et modifier dans Google Drive.
Niveaux d'accès requis
L'application OAuth gérée par Googledemande les champs d'application OAuth suivants. Les utilisateurs accordent ces champs d'application lorsqu'ils autorisent le connecteur :
| Champ d'application | Objectif |
|---|---|
https://www.googleapis.com/auth/drive.readonly |
Rechercher et récupérer du contenu Google Drive. Permet au datastore de lister les fichiers et les dossiers, d'afficher les métadonnées, de lister les autorisations et de lire le contenu des fichiers. |
https://www.googleapis.com/auth/drive.metadata.readonly |
Lire les métadonnées d'un fichier Google Drive. |
https://www.googleapis.com/auth/drive.file |
Créer et mettre à jour les fichiers que l'utilisateur ouvre ou crée avec le connecteur. |
https://www.googleapis.com/auth/drive.appdata |
Stocker des données spécifiques à l'application dans Google Drive. |
https://www.googleapis.com/auth/drive |
Effectuer des actions d'écriture sur des fichiers Google Drive (par exemple, copier, partager, placer dans la corbeille et mettre à jour). |
Limites
- Le data store Google Drive n'est compatible qu'avec les emplacements
global,useteu.
Si vous utilisez des contrôles de sécurité, tenez compte de leurs limites concernant les données dans Google Drive, comme indiqué dans le tableau suivant :
Contrôle de sécurité Points à noter Résidence des données (DRZ) Gemini Enterprise ne garantit la résidence des données que dans Google Cloud. Pour en savoir plus sur la résidence des données et Google Drive, consultez les conseils et la documentation sur la conformité de Google Workspace, y compris Régions des données pour Google Workspace. Consultez également des exemples tels que Choisir la région de stockage des données et Souveraineté numérique. Clés de chiffrement gérées par le client (CMEK) Vos clés ne chiffrent que les données dans Google Cloud. Les contrôles Cloud Key Management Service ne s'appliquent pas aux données stockées dans Google Drive. Access Transparency Access Transparency enregistre les actions effectuées par le personnel Google sur le projet Google Cloud . Vous devrez également consulter les journaux Access Transparency créés par Google Workspace. Pour en savoir plus, consultez Événements de journaux Access Transparency dans la documentation d'aide pour les administrateurs Google Workspace.
Problèmes de recherche courants
Si votre recherche ne renvoie pas le fichier que vous recherchez ou si l'application Web Gemini Enterprise indique qu'aucun fichier Google Drive correspondant n'a été trouvé, consultez les problèmes et solutions suivants.
L'accès de Gemini Enterprise aux données Google Workspace est désactivé
Symptôme : L'application Web Gemini Enterprise indique qu'aucun fichier Google Drive correspondant n'a été trouvé, ou les requêtes de recherche envoyées via l'API Search renvoient une erreur (ou un avertissement) 403 Permission
Denied: Workspace access for Agentspace disabled by organization admin.. Vous pouvez également inspecter les journaux d'erreurs des data store dans Cloud Logging. Consultez Résoudre les problèmes liés aux datastores Gemini Enterprise.
Problème : Le paramètre Autoriser Gemini Enterprise à accéder aux données Google Workspace est désactivé dans la console d'administration Google pour l'organisation Google Workspace de l'utilisateur.
Solution : Demandez à un administrateur Google Workspace de l'organisation de l'utilisateur d'activer l'option Autoriser Gemini Enterprise à accéder aux données Google Workspace. Dans les configurations inter-organisations, un administrateur de chaque organisation Google Workspace dont les utilisateurs interrogent Google Drive doit activer ce paramètre.
L'utilisateur et le data store appartiennent à des organisations Google Workspace différentes
Symptôme : Les utilisateurs qui se connectent depuis une organisation Google Workspace différente du projet Google Cloud ne reçoivent pas de résultats Google Drive dans l'application Web Gemini Enterprise, ou les requêtes envoyées via l'API Search renvoient une erreur 403 Permission Denied: User
does not belong to the same organization as the Workspace data store. Workspace
data store is configured for customer ID ... while user belongs to customer ID
.... Pour rechercher les erreurs 403 dans les journaux, consultez Accéder aux journaux d'erreurs du connecteur Gemini Enterprise avec Cloud Logging.
Problème : Par défaut, Gemini Enterprise ne permet aux utilisateurs de rechercher un data store Google Drive que lorsque le numéro client Google Workspace de l'utilisateur correspond à l'organisation du data store Google Drive et du projet Google Cloud .
Solution : Terminez la configuration entre organisations :
- Contactez Cloud Customer Care pour ajouter à la liste d'autorisation de votre projet Google Cloud le numéro client de chaque organisation Google Workspace dont les utilisateurs accèdent à Gemini Enterprise.
- Demandez à un administrateur Google Workspace de chaque organisation Google Workspace d'activer l'option Autoriser Gemini Enterprise à accéder aux données Google Workspace.
- Si les utilisateurs doivent trouver des documents appartenant à une autre organisation, activez l'option Inclure les documents interdomaines dans Gérer les fonctionnalités de l'application Web.
Les mots clés qui dépassent la limite d'extraction de texte de 1 Mo ne sont pas cherchables.
Symptôme : la recherche de mots clés qui apparaissent plus loin dans un fichier volumineux ne renvoie pas le fichier.
Problème : Google Drive n'extrait que 1 Mo de données de texte et de mise en forme de votre fichier pour le rendre cherchable. Les mots clés qui dépassent la limite d'index de 1 Mo ne sont pas cherchables.
Solution : effectuez une recherche à l'aide de termes qui apparaissent dans le premier Mo du fichier, ou divisez les documents volumineux en fichiers plus petits.
Les fichiers dépassant la taille ou le nombre de pages PDF autorisés ne sont pas indexés
Symptôme : certains fichiers volumineux ou PDF longs n'apparaissent pas dans les résultats de recherche.
Problème : Les fichiers qui dépassent les limites de taille ou de nombre de pages de Google Drive ne sont pas indexés et n'apparaissent pas dans les résultats de recherche :
- Pour la plupart des types de fichiers, la taille ne doit pas dépasser 10 Mo, à l'exception des types suivants :
- Fichiers XLSX : jusqu'à 20 Mo.
- Fichiers PDF : jusqu'à 30 Mo.
- Fichiers texte : jusqu'à 100 Mo.
- La reconnaissance optique des caractères (OCR) dans les fichiers PDF est limitée à 80 pages. Google Drive n'indexe pas les PDF de plus de 50 Mo ou de plus de 80 pages.
Solution : Réduisez la taille des fichiers ou divisez les fichiers et les PDF qui dépassent ces limites d'indexation.
Étapes suivantes
- Pour créer et configurer un data store avec Google Drive, consultez Configurer un datastore Google Drive.