Utiliser le contenu de SharePoint pour des réponses génératives

Les nœuds de réponses génératives utilisant SharePoint comme source de connaissances au niveau du sujet fonctionnent en associant votre agent à une URL de SharePoint, telle que contoso.sharepoint. com/sites/policies. Lorsqu’un utilisateur pose une question et que l’agent n’a pas de rubrique à utiliser pour une réponse, l’agent recherche l’URL et tous les sous-chemins. Par exemple, une URL telle que contoso.sharepoint.com/sites inclut également des sous-chemins tels que contoso.sharepoint.com/sites/policies. Les réponses génératives résument ce contenu en une réponse ciblée.

Lorsque vous publiez votre agent, les appels utilisant des réponses génératives sont effectués au nom de l’utilisateur qui discute avec l’agent, en utilisant les paramètres d’authentification configurés dans l’agent. Par défaut, les agents créés dans Copilot Studio et dans Microsoft Teams sont configurés avec l’option d’authentification Authenticate avec Microsoft, qui fonctionne dans des environnements tels que Microsoft Teams, Power Apps et Microsoft 365 Copilot.

Utiliser SharePoint dans un nœud de réponses génératives

1. Dans un sujet, ajoutez un nœud de réponses génératives.

2. Dans le nœud de réponses génératives du sujet concerné, ouvrez le volet de configuration de la source de données à partir de l’un des deux endroits suivants :

   1. Dans le nœud Créer des réponses génératives, sélectionnez Modifier sous Sources de données.

      

   2. Sinon, dans le nœud Créer des réponses génératives , sélectionnez les trois points (...), puis sélectionnez Propriétés et sélectionnez Source de données.

3. Sous Sources de connaissances, sélectionnez Ajouter des connaissances. Vérifiez que la recherche est activée uniquement sur les sources sélectionnées .

4. Dans la section Featured, sélectionnez SharePoint.

   

5. Fournissez l’URL SharePoint. Séparez plusieurs URL par des sauts de ligne manuels (utilisez Maj + Entrée).

   Remarque

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

6. Ajoutez un nom et une description. La description doit être aussi détaillée que possible, en particulier si l’IA générative est activée, car la description facilite l’orchestration générative.

7. Sélectionnez Enregistrer en haut pour enregistrer les modifications de votre rubrique.

8. Testez votre agent avec des phrases qui devraient renvoyer du contenu.

   Remarque

   Si le compte d'utilisateur que vous avez utilisé pour vous connecter à copilotstudio.microsoft.com n'a pas accès au site SharePoint, vous n'obtenez pas de contenu ou une erreur système peut s'afficher.

Utiliser des variables en tant qu’URL

Utilisez des variables dans le site web public ou SharePoint URL de source de connaissances pour contrôler dynamiquement l’étendue du contenu utilisé par votre agent.

Au lieu de créer plusieurs sources de connaissances pour différents scénarios, définissez une source de connaissances unique et insérez une variable dans l’URL. Au moment de l’exécution, Copilot Studio résout la variable et utilise l’URL résultante pour la mise au point.

Prise en charge des variables

Lorsque vous ajoutez ou modifiez l'URL d'un site web public ou d'une source de connaissances SharePoint, vous pouvez insérer une variable dans le champ URL.

Utilisez une variable pour :

• Ajouter un chemin d’accès à une URL de base

  https://www.contoso.com/{variable}

• Remplacer l’URL entière

  {variable}

Au moment de l’exécution, la variable se résout à une valeur de chaîne. La source de connaissances est limitée à l’URL résolue.

Créer et définir une variable

Pour utiliser une variable dans un site web public ou SharePoint source de connaissances :

1. Créez une variable de chaîne avec une étendue globale .

2. Définissez la valeur de la variable à l’aide de l’une des options suivantes :

   • Données du sujet
   • Propriétés de profil utilisateur, telles que la langue
   • variables d’environnement
   • Flux ou connecteurs d’agent

3. Insérez la variable dans le champ URL en sélectionnant {x} (Insérer une variable).

4. Testez l’agent pour confirmer que la variable se résout à l’URL attendue.

Exemple : Étendue par produit

Vous pouvez étendre les connaissances à différentes zones de produit en fonction de la requête de l’utilisateur.

1. Utilisez une entrée de rubrique pour capturer le nom du produit en tant que variable nommée Product.

2. Ajoutez un nœud de valeur de variable Set après le nœud Déclencheur et créez une variable nommée ProductTable.

3. Utilisez une formule Power Fx pour définir et mapper les noms de produits aux chemins d’URL.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Ajoutez un autre nœud de valeur de variable Set et utilisez-le pour créer une variable globale de type de chaîne nommée GlobalProductURL.

5. Dans le paramètre À valeur , sélectionnez Formule et utilisez une fonction Power Fx pour effectuer une recherche dans la table en fonction de la valeur de la variable d’entrée Product , Topic.Productcomme suit :

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Utilisez la variable dans l’URL de la source de connaissances :

   https://www.microsoft.com/en-us/{GlobalProductURL}

L’agent interroge uniquement la section délimitée du site web au moment de l’exécution.

Scénarios courants

Utilisez des variables dans les sources de connaissances du site web public pour :

• Routage basé sur le produit : requêtes d’étendue vers une documentation de produit spécifique.

• Filtrage de la région ou de la langue : mapper User.Language aux URL localisées (par exemple, en-us, it-it).

• URL spécifiques à l’environnement : basculer entre les sites de développement, de test et de production.

Considérations

• Les sources de connaissances du site web public utilisent la recherche Bing et s’appuient sur du contenu indexé.
• Les limites de profondeur d’URL s’appliquent toujours lorsque vous utilisez des variables.
• Les variables modifient uniquement l’URL cible. Ils n’affectent pas la façon dont le contenu est indexé ou récupéré.

Scénarios d’authentification avancés

Par défaut, Copilot Studio préconfigure les agents pour authentifier les utilisateurs à l'aide de l'authentification Microsoft pour accéder à des sources SharePoint lorsqu'ils se connectent à un agent via Microsoft Teams, Power Apps ou Microsoft 365 Copilot. Toutefois, si vous devez configurer manuellement l’authentification, les étapes suivantes sont requises pour que les réponses génératives fonctionnent avec SharePoint sources de données.

• Les réponses génératives provenant de sources SharePoint ne sont pas disponibles pour les utilisateurs guest dans les applications compatibles avec l'authentification unique.

• Pour authentifier votre agent, consultez Authentification.

• Pour obtenir des instructions sur la création de l’inscription d’application Microsoft Entra ID nécessaire, consultez Configurer l’authentification utilisateur avec Microsoft Entra ID. Lors de la création de cette inscription, vous ou votre administrateur devez spécifier les étendues Sites.Read.All et Files.Read.All dans l’inscription de l’application Microsoft Entra ID.

• La sélection de No authentication spécifie que votre agent ne récupère pas d'informations de SharePoint.

• Lorsque vous configurez l’authentification, les étendues contrôlent l’accès utilisateur. Spécifiez Sites.Read.All et Files.Read.All dans le champ des scopes près des valeurs existantes profile et openid dans Copilot Studio. Ces étendues ne donnent pas aux utilisateurs des autorisations accrues lors de l'utilisation de l'agent, mais autorisent leur contenu autorisé à partir du site SharePoint tel qu'il est configuré pour les réponses génératives.

• SharePoint prend en charge le paramètre Authenticate manuellement avec les fournisseurs de services d’authentification suivants :

  • Microsoft Entra ID (système d'identification de Microsoft)
  • Microsoft Entra ID V2 avec des informations d’identification fédérées
  • Microsoft Entra ID V2 avec des certificats
  • Microsoft Entra ID V2 avec des secrets de client

• SharePoint ne prend pas en charge l'authentification manuelle à l'aide d'OAuth générique.

• Cette configuration s’applique uniquement aux réponses génératives et ne s’applique pas aux connecteurs Power Platform.