SharePoint sources de connaissances ne retournent pas de résultats dans Copilot Studio

Résumé

Cet article vous aide à résoudre les problèmes où SharePoint sources de connaissances ne retournent pas de résultats dans Microsoft Copilot Studio. Lorsque vous configurez une source de données SharePoint, plusieurs facteurs peuvent empêcher l’agent de fournir une réponse. Ces facteurs incluent les résultats de recherche manquants, les autorisations utilisateur, le contenu protégé, les problèmes d’inscription des applications, les limitations de taille de fichier, les conditions de filtre ou le filtrage de modération du contenu. Dans ce cas, l’agent peut renvoyer un message tel que « Je ne sais pas comment l’aider. Pouvez-vous essayer de reformuler ?

Copilot Studio fournit deux façons de configurer SharePoint en tant que source de connaissances, et cet article aborde les deux méthodes :

• Source de connaissances au niveau de l’agent. Ajoutez à partir de la boîte de dialogue Ajouter des connaissances dans les pages Vue d’ensemble, Connaissances ou Propriétés de l’agent. Ce chemin prend en charge les sites SharePoint (URL) et les listes SharePoint, la suppression d’étiquettes de confidentialité et les conditions de filtre. Pour plus d’informations, consultez Ajouter SharePoint en tant que source de connaissances.
• Source de connaissances au niveau des rubriques. Ajoutez à l’intérieur d’un nœud Créer des réponses génératives dans une rubrique. Ce chemin associe le nœud à une URL SharePoint. Pour plus d’informations, consultez Utiliser SharePoint contenu pour les réponses génératives.

Les résultats de la recherche sont manquants dans SharePoint

Lorsque Copilot Studio recherche SharePoint, il utilise uniquement les trois premiers résultats de recherche pour résumer et générer une réponse. Si aucun résultat de recherche n’est retourné, l’agent ne fournit pas de réponse. Copilot Studio s’appuie sur Recherche Microsoft l’indexation et applique des contraintes spécifiques sur les mises en page, les composants et les formats de fichier utilisés pour générer des réponses.

Corriger les résultats de recherche manquants SharePoint

1. Assurez-vous que votre source de connaissances SharePoint (source au niveau de l’agent ou nœud Créer des réponses génératives) pointe vers un emplacement SharePoint avec du contenu approprié.

2. Seuls les documents dans les formats pris en charge sont utilisés pour générer des réponses.

3. Vérifiez que les pages SharePoint que vous attendez que l’agent utilise répondent aux contraintes suivantes :

   • Pages modernes : Seules les pages de SharePoint modernes sont prises en charge. Les pages modernes qui contiennent des composants SharePoint Framework (SPFx) ne sont pas prises en charge.
   • Pages classiques : Le contenu des pages classiques .aspx sur SharePoint n'est pas utilisé pour générer des réponses.
   • Pour obtenir la liste complète des limites techniques, consultez SharePoint limites d’application web.

4. Il est possible que les documents aient été récemment chargés sur SharePoint et n'ont pas encore été indexés. Il est également possible que certains paramètres empêchent certains sites d’apparaître dans les résultats de recherche. Pour plus d’informations, consultez Résultats de la recherche manquants dans SharePoint Online.

   Comment le vérifier

   • Dans la barre de recherche du portail SharePoint, entrez un mot clé unique à partir du document cible et vérifiez que le fichier apparaît dans les résultats de la recherche. Si le fichier n’apparaît pas, l’indexation est incomplète.

   Procédure de résolution

   • Attendez que le cycle d’indexation automatisé se termine.
   • Pour les mises à jour urgentes, SharePoint administrateurs de site peuvent déclencher manuellement une réindexation. Dans SharePoint paramètres, accédez à l’affichage des informations> dusite pour rechercher tous les paramètres> desite et le site de réindexation de> hors connexion. Pour plus d’informations, consultez Demander manuellement l’analyse et la réindexation d’un site, d’une bibliothèque ou d’une liste.

Autorisations utilisateur manquantes pour SharePoint

Copilot Studio respecte le découpage Sécurité Microsoft 365. Au minimum, un utilisateur doit disposer d’autorisations de lecture sur les sites et fichiers pertinents, ou aucun résultat de recherche n’est retourné.

Si l’utilisateur n’a pas d’autorisations, le système ne retourne aucun résultat, ni aucune erreur ni aucune exception. Pour un utilisateur sans autorisations, il semble qu’aucun document n’ait été trouvé.

Vérifier SharePoint autorisations utilisateur

1. Si l’utilisateur concerné accède directement au chemin d’accès exact SharePoint document pour vérifier qu’il peut ouvrir le fichier.
2. Testez la requête à l’aide du même compte d’utilisateur dans Microsoft 365 Copilot Chat. Si Microsoft 365 Copilot Chat ne parvenez pas à récupérer une réponse, elle confirme une barrière d'indexation d'autorisation ou de recherche.

Correction des autorisations utilisateur manquantes SharePoint

Modifiez les autorisations afin que les utilisateurs puissent accéder aux sites et fichiers pertinents. Pour plus d’informations, consultez Partage et autorisations dans l’expérience moderne SharePoint.

Le contenu est protégé par des étiquettes de confidentialité, DKE ou un mot de passe

Le niveau de l’agent SharePoint source de connaissances respecte les étiquettes de confidentialité pour le découpage des autorisations et affiche uniquement le contenu autorisé par l’étiquette pour l’utilisateur connecté. Cependant, l’agent ne peut pas extraire ou mettre à la terre un contenu dont la protection chiffre le fichier. Cette limitation inclut les labels de sensibilité qui appliquent le chiffrement, le chiffrement à double clé (DKE) et les fichiers protégés par mot de passe.

Ces documents peuvent s’afficher comme prêts dans la liste des sources de connaissances et peuvent être ouverts par l’utilisateur dans SharePoint, mais retournent toujours « aucune réponse » lorsque l’agent est invité à indiquer son contenu.

Vérifier le contenu protégé SharePoint

1. Ouvrez le fichier directement dans SharePoint ou son application de bureau et vérifiez s’il demande un mot de passe, indique la protection DKE ou affiche une étiquette de confidentialité de chiffrement.
2. Demandez du contenu connu pour apparaître uniquement dans les fichiers non protégés dans la même source. Si ces requêtes réussissent alors que les requêtes délimitées aux fichiers protégés ne retournent aucune réponse, la protection est la cause.

Corriger le contenu protégé SharePoint

• Supprimez l’étiquette de confidentialité de chiffrement, la protection DKE ou le mot de passe du fichier, si les stratégies de votre organisation l’autorisent.
• Publiez une copie non protégée du contenu requis dans un emplacement SharePoint auquel l’agent peut accéder.
• Pointez la source de connaissances vers un emplacement SharePoint qui ne contient pas de contenu chiffré.

Le lien source SharePoint est rompu après un renommage

Si vous renommez un site ou un dossier SharePoint qu’utilise une source de connaissances au niveau de l’agent, le lien source existant peut interrompre et provoquer un écart d’autorisation. Lorsque cela se produit, l’agent peut ne pas accéder à la base de connaissances et retourner aucune réponse.

Corriger un lien source SharePoint rompu

1. Demandez à votre Administrateur SharePoint d’accorder les autorisations appropriées sur l’emplacement renommé et de générer un nouveau lien source.
2. Ouvrez l’agent et mettez à jour la source de connaissances SharePoint avec le lien nouvellement généré.

L’inscription ou l’agent d’application est mal configuré pour SharePoint

Lorsque les administrateurs configurent SharePoint sources de connaissances, ils doivent configurer l’authentification à l’aide d’une inscription d’application Microsoft Entra ID et configurer des étendues supplémentaires. Au minimum, l’inscription de l’application doit spécifier les Sites.Read.AllFiles.Read.All étendues et les ajouter aux paramètres d’authentification de l’agent en même temps profile que openid. Si les étendues sont manquantes dans l’inscription de l’application ou dans les paramètres d’authentification de l’agent, ou si le consentement n’est pas accordé aux étendues requises, l’agent ne retourne aucun résultat ni aucune erreur ni aucune exception. Pour un utilisateur, il semble qu’aucun document n’ait été trouvé.

Corriger l’inscription d’application mal configurée ou l’authentification de l’agent

Ajoutez les étendues nécessaires à l’inscription de l’application et aux paramètres d’authentification de l’agent et accordez le consentement.

L’exemple suivant est une référence à un enregistrement d’application bien configuré :

L’exemple suivant montre les paramètres d’authentification requis dans Copilot Studio :

Limites de taille de fichier pour les réponses génératives SharePoint

Pour les sources SharePoint, si vous ne disposez pas d’une licence Microsoft 365 Copilot dans le même locataire que votre agent, les réponses génératives ne peuvent traiter que les fichiers d’une taille maximale de 7 Mo. Vous devez également désactiver le graphe de locataire avec le paramètre de recherche sémantique .

Si vous disposez d’une licence Microsoft 365 Copilot dans le même locataire que votre agent, la taille de fichier maximale est de 200 Mo. Vous devez également activer le graphe de locataire avec le paramètre de recherche sémantique .

Les fichiers plus volumineux peuvent être stockés dans SharePoint et sont renvoyés par une recherche Microsoft Graph, mais ne sont pas traités par les réponses génératives. Comme alternative, vous pouvez charger vos propres fichiers, qui peuvent avoir une taille maximale de 512 Mo.

Pour obtenir la liste des limites et des fonctionnalités SharePoint prises en charge, consultez les limites des applications web SharePoint.

Résoudre les problèmes de taille de fichier pour les réponses génératives SharePoint

Si les fichiers pertinents pour votre expérience d’IA conversationnelle dépassent la limitation de taille, vous souhaiterez peut-être explorer des architectures alternatives, comme utiliser l’indexation sémantique Microsoft 365 ou connecter vos données à Azure OpenAI pour obtenir des réponses génératives.

SharePoint list source ne retourne aucun résultat

Pour les sources de connaissances au niveau de l’agent qui utilisent des listes SharePoint, plusieurs facteurs spécifiques à la liste peuvent entraîner le retour de l’agent sans réponse même si la liste contient des données pertinentes.

• La recherche dataverse est requise. Copilot Studio agents nécessitent une recherche Dataverse pour utiliser un SharePoint list comme source de connaissances. Si la recherche Dataverse est désactivée dans l’environnement, la liste ne peut pas être interrogée et aucun résultat n’est retourné. Pour plus d’informations sur l’activation de la recherche Dataverse, consultez Configurer la recherche Dataverse pour votre environnement.
• La taille de liste affecte la qualité et la latence. Les listes qui contiennent plus de 35 000 lignes peuvent dégrader la qualité des résultats et augmenter la latence, ce qui peut présenter comme aucune réponse pour les requêtes non valides.
• Trop de listes sur un agent. Vous pouvez sélectionner jusqu’à 10 listes à la fois et, pour obtenir les meilleurs résultats, n’utilisez pas plus de 10 listes par agent. L’ajout de listes augmente la probabilité que le contenu pertinent ne soit pas exposé.
• La liste n’apparaît pas dans les listes récentes. Si un SharePoint list avec accès partagé n'apparaît pas dans Mes listes ou listes récentes dans le navigateur, ouvrez la liste dans SharePoint une fois pour qu'elle apparaisse dans listes récentes, ou collez l'URL de liste directement dans la sélection d'URL lorsque vous ajoutez la source.

Résoudre les problèmes de source SharePoint list

1. Demandez à votre administrateur d’activer la recherche Dataverse dans l’environnement dans lequel l’agent s’exécute.
2. Réduisez le nombre de lignes de la liste ou fractionnez les grandes listes en listes plus petites.
3. Réduisez le nombre de listes jointes à l’agent à 10 ou moins, en conservant uniquement les listes pertinentes pour les rubriques que l’agent prend en charge.
4. Rajoutez des listes en collant leur URL lorsqu’elles n’apparaissent pas automatiquement dans les listes récentes.

Les conditions de filtre excluent le contenu attendu

Les deux chemins de configuration vous permettent de limiter les SharePoint contenu que l’agent peut utiliser. Si ces filtres sont trop restrictifs ou mal configurés, l’agent ne retourne aucune réponse même lorsque le contenu correspondant existe.

• Source au niveau de l’agent, filtres de paramètres avancés. Dans une source de connaissances au niveau de l’agent SharePoint, les filtres basés sur le titre, l’auteur, modifié ou modifié peuvent exclure le contenu que l’utilisateur demande. Les filtres liés à une variable personnalisée, à une variable système ou à une variable d’environnement peuvent être résolus en une valeur inattendue lors de l’exécution.
• Nœud réponses génératives au niveau des rubriques, recherchez uniquement les sources sélectionnées. Lorsque la recherche ne sélectionne que les sources sélectionnées sont activées pour un nœud Créer des réponses génératives , seules les sources sélectionnées sur ce nœud sont utilisées. Si la source SharePoint attendue n'est pas dans la sélection, l'agent ne retourne aucune réponse au lieu de revenir à d'autres sources de connaissances.

Vérifier les conditions de filtre

1. Dans la page Connaissances, sélectionnez votre source de SharePoint, puis sélectionnez Modifier>les paramètres avancés pour passer en revue les conditions de filtre actives et les valeurs vers lesquelles ils sont résolus.
2. Dans la rubrique qui héberge le nœud Créer des réponses génératives, ouvrez lasource de données> du nœud et confirmez à la fois le paramètre rechercher uniquement les sources sélectionnées et les sources spécifiques sélectionnées.

Corriger les conditions de filtre

• Relâchez ou supprimez les conditions de filtre qui excluent le contenu attendu.
• Si un filtre utilise une variable, ajoutez une étape de débogage dans la conversation pour confirmer que la variable est résolue sur la valeur attendue au moment de l’exécution.
• Sur le nœud de niveau rubrique, ajoutez la source de SharePoint attendue aux sources sélectionnées ou désactivez la recherche uniquement les sources sélectionnées afin que les sources de connaissances au niveau de l’agent soient également interrogées.

Contenu bloqué par modération de contenu dans Copilot Studio

Lorsqu’ils génèrent des réponses, les agents Copilot Studio modèrent le contenu qui se situe dans les catégories de préjudices. Lorsque le contenu est modéré, les réponses génératives ne fournissent pas de réponse ou indiquent que le contenu a été modéré. Toutefois, les événements de modération sont consignés lorsque l’agent est configuré pour envoyer des données de télémétrie à Azure Applications Insights.

Après avoir connecté votre agent à Azure App Insights, vous pouvez utiliser la requête KQL (Kusto Query Language) suivante pour savoir si le contenu a été filtré :

customEvents
| extend cd = todynamic(customDimensions)
| extend conversationId = tostring(cd.conversationId)
| extend topic = tostring(cd.TopicName)
| extend message = tostring(cd.Message)
| extend result = tostring(cd.Result)
| extend SerializedData = tostring(cd.SerializedData)
| extend Summary = tostring(cd.Summary)
| extend feedback = tostring(todynamic(replace_string(SerializedData,"$","")).value)
| where name == "GenerativeAnswers" and result contains "Filtered"
| where cloud_RoleInstance == "myCopilot"
| project cloud_RoleInstance, name, timestamp, conversationId, topic, message, result, feedback, Summary
| order by timestamp desc

Dans l’exemple suivant, la requête KQL met en évidence une tentative d’utilisation de réponses génératives filtrées par la modération de contenu :

Corriger la modération du contenu bloquant les réponses génératives

• Essayez d’ajuster la modération du contenu, mais gardez à l’esprit qu’un niveau de modération du contenu inférieur peut entraîner des réponses moins précises ou moins pertinentes.

• Si vous pensez que votre contenu ne doit pas être modéré, contactez Microsoft support client.

Contenu connexe

• Ajouter SharePoint comme source de connaissances
• Utiliser SharePoint contenu pour les réponses génératives
• Configurer des réponses génératives sur SharePoint
• limites de l’application web SharePoint
• Partage et autorisations dans l’expérience SharePoint moderne
• Résoudre les erreurs du filtre de contenu d’IA responsable