Aperçu

Le data store Microsoft OneDrive pour Gemini Enterprise vous permet de rechercher vos fichiers et dossiers, et d'effectuer des actions dessus.

Versions de Microsoft OneDrive compatibles

Le data store Microsoft OneDrive est compatible avec toutes les versions hébergées de Microsoft OneDrive via l'API Microsoft Graph v1.0.

Action compatible

Lorsque le data store Microsoft OneDrive est activé, les utilisateurs finaux peuvent utiliser des commandes en langage naturel dans Gemini Enterprise pour effectuer les actions suivantes.

Action Description
Créer un dossier Crée un dossier au niveau d'un chemin d'accès spécifié dans Microsoft OneDrive.
Copier le fichier Copie un fichier d'une source vers une destination dans Microsoft OneDrive.
Importer un fichier Importe un fichier vers un emplacement spécifié dans Microsoft OneDrive.
Télécharger le fichier Télécharge un fichier depuis Microsoft OneDrive vers un emplacement spécifié.
Copier le dossier Copie un dossier d'une source vers une destination dans Microsoft OneDrive.
Déplacer le fichier Déplace un fichier d'une source vers une destination dans Microsoft OneDrive.
Déplacer le dossier Déplace un dossier d'une source vers une destination dans Microsoft OneDrive.
Renommer le fichier Renomme un fichier dans Microsoft OneDrive.
Renommer le dossier Renomme un dossier dans Microsoft OneDrive.
Partager un fichier ou un dossier Partage un fichier ou un dossier avec les destinataires spécifiés ou génère un lien de partage.
Mettre à jour les propriétés du fichier Met à jour les propriétés des métadonnées d'un fichier dans Microsoft OneDrive.

Autorisations requises

Pour permettre à Gemini Enterprise d'effectuer des recherches et d'ingérer des données à l'aide du data store Microsoft OneDrive, vous devez disposer des autorisations suivantes :

Autorisations de l'API Microsoft Graph

Le tableau ci-dessous présente les autorisations requises pour chaque mode de connexion.

Remarque : Le tableau suivant présente les autorisations requises pour chaque mode de connexion. Si vous activez les actions pour le mode de connexion Recherche unifiée ou Ingestion de données, sélectionnez également les autorisations listées dans la ligne Actions.

Mode de connexion Scope (Portée) Purpose
Recherche fédérée Files.Read.All (Délégué) Permet au data store de lire tous les fichiers auxquels l'utilisateur peut accéder.
Sites.Read.All (Délégué) Permet au data store de lire les documents et de lister les éléments de toutes les collections de sites auxquelles l'utilisateur a accès.
User.Read.All (Délégué) Permet au data store de résoudre les emplacements Drive des utilisateurs pour la découverte de contenu.
Ingestion de données GroupMember.Read.All (Identifiants fédérés et jeton d'actualisation OAuth 2.0) Permet au data store de lire les appartenances et les propriétés de base de tous les groupes sans utilisateur connecté.
User.Read (Identifiants fédérés et jeton d'actualisation OAuth 2.0) Permet au data store de lire le profil des utilisateurs connectés. Il permet également au data store de lire les informations de base sur l'entreprise des utilisateurs connectés.
User.Read.All (Jeton d'actualisation OAuth 2.0 uniquement) Permet au data store de lire les profils utilisateur.
Sites.FullControl.All (Option 1)
Sites.Selected (Option 2)		 (Identifiants fédérés et jeton d'actualisation OAuth 2.0) L'option 1 permet au data store de contrôler entièrement toutes les collections de sites. L'option 2 permet au data store d'accéder à un sous-ensemble de collections de sites. Les collections de sites spécifiques et les autorisations accordées peuvent être configurées dans Microsoft OneDrive.
User.Read.All (Option 1)
User.ReadBasic.All (Option 2)		 (Identifiants fédérés uniquement) L'option 1 permet au data store de lire les profils utilisateur. L'option 2 permet au data store de lire un ensemble de base de propriétés de profil d'autres utilisateurs de l'organisation.
Actions Files.ReadWrite.AppFolder (Délégué) Permet au data store de lire, créer, mettre à jour et supprimer des fichiers dans le dossier Microsoft OneDrive.
Files.ReadWrite Délégué : permet au data store de lire, télécharger, créer, importer, mettre à jour et supprimer les fichiers auxquels l'utilisateur a accès.
Files.ReadWrite.All (Délégué) Permet au data store de lire et de mettre à jour les fichiers sur tous les Drive auxquels l'utilisateur a accès. Obligatoire pour les actions de mutation de fichiers et de dossiers (copier, déplacer, renommer, partager, mettre à jour les propriétés) qui s'appliquent aux fichiers stockés dans des Drive autres que le Microsoft OneDrive de l'utilisateur.

Pour savoir comment ajouter les autorisations pour Microsoft OneDrive, consultez Configurer Microsoft OneDrive et définir les autorisations nécessaires.

Limites

Cette section décrit les problèmes connus et les limites susceptibles d'affecter votre utilisation du data store Microsoft OneDrive.

  • Lorsque vous créez une application ou ajoutez un data store à une application existante, nous vous recommandons de n'associer qu'un seul data store aux actions appartenant à un seul type de connecteur.
  • Il n'est pas possible d'appliquer un périmètre VPC Service Controls aux datastores Microsoft OneDrive existants. Pour appliquer VPC Service Controls, vous devez supprimer et recréer les datastores. Pour en savoir plus sur VPC Service Controls et sur l'utilisation des actions après l'activation de VPC Service Controls, consultez Sécuriser votre application avec VPC Service Controls.
  • Le data store Microsoft OneDrive n'est compatible qu'avec les emplacements global, us et eu.

Voici les limites du data store fédéré Microsoft OneDrive :

  • Limites de la recherche : les résultats de recherche peuvent varier et ne sont pas toujours exhaustifs pour tous les types de fichiers. Il est possible que le contenu des dossiers archivés ou chiffrés ne soit pas accessible pour la recherche. La recherche fédérée ne permet pas de rechercher dans les pièces jointes.
  • Accès délégué : l'accès aux fichiers ou dossiers Microsoft OneDrive partagés peut nécessiter des autorisations spécifiques non couvertes par l'autorisation utilisateur standard.
  • Analyseur de mise en page en mode de recherche fédérée : bien que l'analyseur de mise en page soit standard, son efficacité sur les PDF complexes (avec des tableaux, des mises en page multicolonnes ou nécessitant l'OCR) est limitée en mode de recherche fédérée. Les appels d'API en temps réel de ce mode peuvent ne pas fournir les données complètes ou le temps nécessaire à l'analyse approfondie effectuée par l'analyseur de mise en page lors de l'ingestion des données.

  • Fonctionnalités PDF non compatibles : par conséquent, les structures PDF complexes peuvent ne pas être entièrement analysées ou consultables. Par exemple :

    • Mises en page de texte à plusieurs colonnes
    • Données dans les tableaux et graphiques intégrés
    • Texte dans des documents scannés nécessitant une reconnaissance optique des caractères (OCR)
    • Documents dont l'ordre de lecture n'est pas linéaire ou dont la mise en forme est complexe

Voici les limites du data store d'ingestion Microsoft OneDrive :

  • La synchronisation incrémentielle ne détecte pas les actions au niveau des dossiers, comme Copier, Déplacer ou Renommer.

Recommandation

Pour les données Microsoft OneDrive contenant des PDF avec des fonctionnalités complexes (comme des tableaux, des mises en page multicolonnes ou du contenu dépendant de l'OCR), nous vous recommandons d'utiliser le mode d'ingestion de données pour une recherche efficace. Ce mode permet à l'analyseur de mise en page de traiter et d'indexer en profondeur l'intégralité du contenu du document.

Étapes suivantes