Aperçu

Le data store Microsoft SharePoint pour Gemini Enterprise vous permet de rechercher et d'effectuer des actions sur vos données Microsoft SharePoint Online, y compris des documents, des listes et des sites.

Versions Microsoft SharePoint compatibles

Le data store Microsoft SharePoint est compatible avec la dernière version cloud de Microsoft SharePoint Online.

Action compatible

Lorsque le data store Microsoft SharePoint 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 dans un chemin spécifié.
Ajouter une liste Crée une liste de données structurées (par exemple, des tâches ou des contacts) sur le site Microsoft SharePoint.
Importer un document Importe un document sur un site ou dans une bibliothèque Microsoft SharePoint.
Télécharger un document Télécharge un document depuis un site ou une bibliothèque Microsoft SharePoint.
Add page Crée une page sur le site Microsoft SharePoint.
Extraire un document Extrait un document d'une bibliothèque Microsoft SharePoint.
Archiver un document Archive un document dans une bibliothèque Microsoft SharePoint.
Renommer une pièce jointe ou un document Renomme une pièce jointe ou un document dans une bibliothèque Microsoft SharePoint.
Déplacer une pièce jointe ou un document Déplace un document d'une bibliothèque Microsoft SharePoint vers une bibliothèque, un dossier ou un autre site SharePoint de destination.
Supprimer l'extraction d'un document Supprime l'extraction d'un document et le rétablit sans enregistrer les modifications.
Partager une ressource Partage un document, un dossier ou une ressource avec des destinataires spécifiés, ou génère un lien de partage.
Mettre à jour les propriétés d'un fichier Met à jour les propriétés des métadonnées d'un document dans une bibliothèque Microsoft SharePoint.
Actualiser la page Met à jour une page existante sur le site Microsoft SharePoint.
Mettre à jour la liste Met à jour les paramètres d'une liste de données structurées existante sur le site Microsoft SharePoint.
Créer un élément de liste Crée un élément dans une liste spécifiée sur le site Microsoft SharePoint.
Mettre à jour un élément de liste Met à jour les champs d'un élément existant dans une liste spécifiée.
Répertorier les listes Récupère toutes les listes et bibliothèques de documents d'un site Microsoft SharePoint spécifié.
Obtenir un élément de liste Renvoie un seul élément de liste, y compris toutes ses valeurs de colonne.
Obtenir les champs d'une liste Renvoie le schéma d'une liste spécifiée, y compris tous ses champs et leurs propriétés.

Autorisations requises

Pour permettre à Gemini Enterprise d'effectuer des recherches et d'ingérer des données à l'aide du data store Microsoft SharePoint, vous avez besoin 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 ci-dessous 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 unifiée N/A Aucune autorisation de l'API Graph n'est requise.
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 des groupes pour 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 SharePoint Online.
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 Sites.ReadWrite.All (Recherche unifiée et ingestion de données) Permet au data store de modifier ou de supprimer des documents et des éléments de liste dans toutes les collections de sites au nom de l'utilisateur connecté.
Sites.Read.All (Recherche unifiée et ingestion de données) Permet au data store de lire les listes, les éléments de liste et les schémas de liste dans toutes les collections de sites au nom de l'utilisateur connecté. Requis pour les actions "Répertorier les listes", "Obtenir un élément de liste" et "Obtenir les champs d'une liste".
Files.ReadWrite Permet au data store de lire, créer, mettre à jour et supprimer les fichiers de l'utilisateur connecté.
Files.ReadWrite.All Permet au data store de lire, créer, mettre à jour, supprimer, importer et télécharger tous les fichiers auxquels l'utilisateur connecté peut accéder.
Sites.Manage.All Permet au data store de créer ou de supprimer des bibliothèques de documents et des listes dans toutes les collections de sites au nom de l'utilisateur.

Autorisations de l'API Microsoft SharePoint

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

Mode de connexion Scope (Portée) Purpose
Recherche unifiée Sites.Search.All (délégué) Permet au data store d'exécuter des requêtes de recherche et de lire les informations de base sur le site au nom de l'utilisateur connecté. Les résultats de recherche sont basés sur les autorisations de l'utilisateur, et non sur celles de l'application.
AllSites.Read (Option 1, délégué) Permet au data store de lire les documents et les éléments de liste dans toutes les collections de sites au nom de l'utilisateur connecté.
Sites.Selected (Option 2, délégué) Permet au data store d'accéder à un sous-ensemble de collections de sites avec un utilisateur connecté. Les collections de sites spécifiques et les autorisations accordées peuvent être configurées dans SharePoint Online.
Ingestion de données (identifiants fédérés) Sites.FullControl.All (Option 1, application) Permet au data store de contrôler entièrement toutes les collections de sites.
Sites.Selected (Option 2, application) Permet au data store d'accéder à un sous-ensemble de collections de sites avec un utilisateur connecté. Les collections de sites spécifiques et les autorisations accordées peuvent être configurées dans SharePoint Online.
Ingestion de données (jeton d'actualisation OAuth 2.0) AllSites.FullControl (Option 1, délégué) Permet au data store de contrôler entièrement toutes les collections de sites au nom de l'utilisateur connecté.
Sites.Selected (Option 2, délégué) Permet au data store d'accéder à un sous-ensemble de collections de sites avec un utilisateur connecté. Les collections de sites spécifiques et les autorisations accordées peuvent être configurées dans SharePoint Online.
Actions AllSites.Write (délégué) Permet au data store de créer, lire, mettre à jour, supprimer, importer et télécharger des documents et des éléments de liste dans toutes les collections de sites au nom de l'utilisateur connecté.

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

Limites

Cette section décrit les problèmes connus et les limites qui peuvent affecter votre utilisation du data store Microsoft SharePoint.

  • Lorsque vous créez une application ou que vous ajoutez un data store à une application existante, nous vous recommandons d'associer un seul data store à des actions appartenant à un seul type de connecteur.
  • L'application d'un périmètre VPC Service Controls aux datastores Microsoft SharePoint existants n'est pas prise en charge. 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 SharePoint n'est compatible qu'avec les emplacements global, us, et eu.

  • Prérequis pour la qualité de la recherche : Pour obtenir des résultats de recherche optimaux et tirer pleinement parti des fonctionnalités du Knowledge Graph, nous vous recommandons de configurer et de synchroniser le datastore de recherche de contacts en plus du data store Microsoft SharePoint.

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

  • 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 unifiée n'est pas compatible avec la recherche dans les pièces jointes.
  • Accès délégué : l'accès aux sites ou bibliothèques partagés peut nécessiter des autorisations spécifiques qui ne sont pas couvertes par l'autorisation utilisateur standard.
  • Analyseur de mise en page en mode de recherche unifié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 une reconnaissance optique des caractères) est limitée en mode de recherche unifiée. Les appels d'API en temps réel de ce mode peuvent ne pas fournir les données complètes ni le temps requis pour l'analyse approfondie que l'analyseur de mise en page effectue lors de l'ingestion de données.
  • Fonctionnalités PDF non compatibles : par conséquent, les structures PDF complexes peuvent ne pas être entièrement analysées ou consultables. Cela inclut :
    • Les mises en page de texte à plusieurs colonnes
    • Les données dans les tableaux et graphiques intégrés
    • Le texte des documents numérisés nécessitant une reconnaissance optique des caractères
    • Les documents avec des ordres de lecture non linéaires ou une mise en forme complexe.

Recommandation

Pour les données Microsoft SharePoint contenant des PDF avec des fonctionnalités complexes (telles que des tableaux, des mises en page multicolonnes ou du contenu dépendant de la reconnaissance optique des caractères), nous vous recommandons d'utiliser le mode d'ingestion standard pour une recherche efficace. Ce mode permet à l'analyseur de mise en page de traiter et d'indexer en profondeur l'ensemble du contenu du document.

Résoudre les problèmes liés aux résultats de recherche du connecteur SharePoint

Si vous rencontrez des problèmes liés à des documents manquants, à des résultats incorrects ou à une pertinence de recherche médiocre, vérifiez les domaines de diagnostic suivants :

  • Vérifiez le data store de contacts : assurez-vous que le datastore de recherche de contacts est configuré et synchronisé si vous rencontrez des problèmes de pertinence ou de correspondance des entités.
  • Erreurs d'authentification : les erreurs d'authentification persistantes, telles que "Erreur lors de la récupération du jeton d'accès à l'API Graph", empêchent le bon fonctionnement des recherches. Pour résoudre ce problème, consultez les journaux Microsoft Entra ID pour en savoir plus, puis réauthentifiez la connexion.
  • Incompatibilité des identités : si vous utilisez Google Identity, vérifiez que l'adresse e-mail Google de l'utilisateur correspond exactement à son adresse e-mail Microsoft SharePoint. Les incompatibilités empêchent le renvoi des résultats.
  • Recherches ciblées dans des dossiers (URL .aspx) : la recherche avec des URL de navigateur complètes se terminant par /Forms/AllItems.aspx s'exécute sur l'ensemble du site, et pas seulement sur le dossier spécifique. Utilisez toujours des chemins d'accès absolus pour les recherches ciblées.
  • Limites des résultats : sachez que les recherches unifiées peuvent être limitées quant au nombre de documents renvoyés par requête (généralement autour de 20 résultats).
  • Problèmes de citation : des citations incorrectes intermittentes peuvent se produire. Si le problème persiste, signalez-le à l'assistance et incluez vos jetons de diagnostic.
  • Compatibilité entre le connecteur et le modèle : assurez-vous d'utiliser les dernières versions du modèle Gemini. Certains modèles plus anciens (par exemple, la version 3.x) présentent des problèmes connus concernant les outils de résolution pour les actions SharePoint, telles que download_document dans Agent Builder.

Étape suivante