Ajouter un site Web public en tant que source de connaissances

Lorsque vous ajoutez des sites web publics en tant que sources de connaissances au niveau de l’agent, vous utilisez des informations publiquement disponibles pour améliorer la portée de votre agent.

Ajouter un site web public

Pour ajouter un site web public en tant que source de connaissances, procédez comme suit :

  1. Ouvrez l’agent.

  2. Sélectionnez Ajouter des connaissances dans les pages Vue d’ensemble ou Connaissances, ou les Propriétés d’un nœud de réponses génératives.

  3. Sélectionnez Sites web publics.

  4. Entrez l’URL du site web public. Pour utiliser une variable au lieu d’une URL statique, sélectionnez l’icône du sélecteur de variables en regard du champ URL et choisissez une variable Personnalisée, Système ou Environnement .

  5. Ajoutez un nom (par défaut, l’URL du site web est utilisée).

  6. Ajoutez une description. Fournissez une description détaillée, en particulier si l’IA générative est activée, car la description aide à l’orchestration générative.

  7. Sélectionnez Ajouter à l’agent pour terminer l’ajout de la source de connaissances.

  8. Testez votre assistant pour voir s’il répond correctement aux questions liées au contenu de votre site web. Vous souhaiterez peut-être tester des questions sur des cas limites pour décider si vous avez besoin d’abaisser la modération pour obtenir plus de réponses.

Considérations à propos des URL

L’URL que vous utilisez dans votre agent représente l’étendue du contenu pour générer des réponses. Certaines URL ont des exigences et des restrictions.

Remarque

Type et structure de l'URL

  • L’URL peut avoir jusqu’à deux niveaux de profondeur, avec des sous-chemins indiqués par une barre oblique /. Cependant, une barre oblique finale est autorisée.

    Valide Non valide
    www.contoso.com
    www.fabrikam.com/engines/rotary
    www.fabrikam.com/engines/rotary/    		 www.fabrikam.com/engines/rotary/dual-shaft

  • Si l'URL redirige vers un autre site de niveau supérieur, le contenu n’est pas inclus dans les résultats :

    Par exemple, si www.fabrikam.com redirige vers www.contoso.fabrikam.com, votre assistant ne génère pas de réponses à partir du contenu de l’une de ces URL.

  • Les URL qui pointent vers un site web nécessitant une authentification ou celles qui ne sont pas indexées par Bing ne sont pas prises en charge.

    Par exemple, les wikis et les sites SharePoint nécessitent une authentification. Vous ne pouvez donc pas les utiliser :

    • fabrikam.visualstudio.com/project/_wiki
    • fabrikam.sharepoint.com

Structure du domaine URL

Votre agent utilise tout contenu visible publiquement dans l’URL que vous spécifiez, y compris les sous-domaines sous un domaine de niveau supérieur, pour générer du contenu.

Exemples :

  • Si vous utilisez www.fabrikam.com/engines/rotary, l’agent utilise également le contenu sur www.fabrikam.com/engines/rotary/dual-shaft pour générer des réponses.

    L’agent n’utilise pas de contenu sur www.fabrikam.com/tools, car les outils ne sont pas un sous-domaine du rotary.

  • Si vous utilisez www.fabrikam.com (le www existe), l’agent n’utilise pas de contenu sur news.fabrikam.com (le www n’existe pas), car les actualités sont un sous-domaine sous le domaine de niveau supérieur fabrikam.com.

  • Si vous utilisez fabrikam.com, l’agent utilise du contenu sur www.fabrikam.com et news.fabrikam.com, car il se trouve sous le domaine de niveau supérieur fabrikam.com.

URL des réseaux sociaux et des forums

Votre assistant peut générer des réponses absurdes, non pertinentes ou inappropriées si vous utilisez un forum ou un site de réseau social comme URL. Par conséquent, le contenu communautaire sur les réseaux sociaux augmente souvent le risque de rejet d’un plus grand nombre de réponses.

Pour plus d’informations, consultez la FAQ sur les réponses génératives. L’IA est entraînée pour éviter de générer des réponses malveillantes et offensantes.

URL de moteurs de recherche

Évitez d’inclure des URL de moteurs de recherche, comme bing.com, car elles ne fournissent pas de réponses utiles.

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.

Remarque

L’utilisation d’une variable change l’URL utilisée pour la mise au sol. Elle ne modifie pas les exigences de structure d’URL ni les limitations de profondeur pour les sites web publics.

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 :

  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é.

Important

La variable doit être résolue en URL publique valide qui répond aux exigences des sources de connaissances du site web public. Les URL non valides ou non prises en charge peuvent ne pas retourner les résultats.

  • Last updated on