Ajouter des sources de connaissances à un agent dans Agent Builder

Agent Builder fournit une interface simple pour vous permettre d’intégrer des sources de connaissances afin de rendre votre agent déclaratif plus intelligent et plus sensible au contexte. Ces sources de connaissances ancrent votre agent dans les données d’entreprise, le contenu public et les informations spécifiques à l’utilisateur pour lui permettre de fournir des réponses plus précises, pertinentes et personnalisées.

Agent Builder prend en charge les sites web publics, le contenu SharePoint et OneDrive, les conversations et réunions Teams, la messagerie Outlook, les fichiers incorporés et les connecteurs Microsoft 365 Copilot. Les limites varient selon le type de source.

Cet article décrit les sources de connaissances prises en charge et les étapes à suivre pour les configurer. Pour plus d’informations générales sur la création d’agents, consultez Créer des agents dans Agent Builder.

Pour obtenir une liste plus large des sources de connaissances prises en charge, consultez Ajouter des sources de connaissances à votre agent déclaratif. Les sources de connaissances et les capacités diffèrent selon la licence ; pour plus d’informations, consultez Licences et fonctionnalités de l’agentMicrosoft 365 Copilot et modèles de licence.

Ajouter des sources de connaissances

Si vous utilisez le langage naturel pour créer votre agent, Agent Builder ajoute des sources de connaissances pour vous en fonction de votre description. Vous pouvez également ajouter des sources de connaissances à partir de la zone de conversation sous l’onglet Décrire :

1. Dans Microsoft 365 Copilot, choisissez Nouvel agent dans le volet gauche, puis fournissez une description en langage naturel de votre agent sous l’onglet Décrire.

2. Sélectionnez l’icône plus (+) dans la zone de conversation. Utilisez l’une des méthodes suivantes pour ajouter des sources de connaissances :

   • Ajouter du contenu professionnel : sélectionnez, recherchez ou chargez des fichiers.
   • Charger des images et des fichiers : chargez-les directement à partir de votre appareil.
   • Joindre des fichiers cloud : joignez les fichiers cloud auxquels vous avez accès.

Si vous configurez manuellement votre agent pour ajouter des sources de connaissances à votre agent :

1. Dans Microsoft 365 Copilot, choisissez Nouvel agent dans le volet gauche, puis choisissez Ignorer à configurer.

2. Dans la section Connaissances , utilisez l’une des méthodes suivantes pour ajouter des sources de connaissances :

   • Recherche - Tapez des mots-clés pour rechercher des éléments. Utilisez cette option pour ajouter des sources, telles que des e-mails et des messages Teams.
   • Entrer l’URL - Ajoutez un site web public, un lien SharePoint qui inclut le chemin d’accès du site (par exemple, .../sites/<site-name>/...) et n’inclut pas les paramètres de requête, ou un lien OneDrive partagé.
   • Parcourir : utilisez le sélecteur de fichiers cloud Joindre pour rechercher et sélectionner des fichiers, dossiers ou listes SharePoint ou OneDrive.
   • Télécharger : chargez des fichiers directement à partir de votre appareil.

Vérifier vos sources de connaissances

Après avoir ajouté des sources de connaissances, vérifiez qu’elles apparaissent dans la section Connaissances de l’onglet Configurer . Ensuite, dans l’onglet Essayer , posez une question dont la réponse est disponible dans l’une des sources et confirmez que la réponse utilise les informations attendues.

Le contenu SharePoint et OneDrive nouvellement chargé peut afficher un status de préparation. Vous pouvez tester l’agent pendant la préparation d’une source, mais l’agent n’utilise pas cette source dans ses réponses tant que la source n’est pas prête.

Sites web publics

Ajoutez des sites web publics spécifiques en tant que sources de connaissances des agents pour que votre agent prenne en charge le contexte. Lorsque vous référencez des sites web comme sources de connaissances, les limites suivantes s’appliquent :

• Les URL de site web public ne doivent être qu’à deux niveaux. Par exemple, https://example.org/a/b/c il s’agit d’une URL non valide car elle comporte plus de deux niveaux.
• Les URL ne peuvent pas contenir de paramètres de requête. Par exemple, https://example.org?test=1 n’est pas valide.
• Vous pouvez ajouter jusqu’à quatre URL.

Pour configurer votre agent afin qu’il utilise n’importe quelle donnée web comme base de connaissances :

• Utilisez le langage naturel pour demander à Agent Builder de hiérarchiser vos sources de connaissances.
• Dans l’onglet Configurer , sous Connaissances, choisissez le bouton bascule en regard de Rechercher tous les sites web.

Contenu SharePoint et OneDrive

Faites référence à des fichiers, des dossiers, des listes et des sites spécifiques en tant que sources de connaissances de l’agent. Lorsque vous référencez des sources à partir de SharePoint ou OneDrive, tenez compte des limites suivantes :

Lorsque vous référencez une liste SharePoint, les limites suivantes s’appliquent :

• Une liste peut contenir un maximum de 20 000 éléments (lignes) et 50 Mo de texte brut. Si votre liste dépasse l’une des limites, l’agent la tronque et note la troncature dans sa réponse.
• La colonne Pièces jointes (pièces jointes de la liste) n’est pas indexée ou utilisée pour la mise à la terre ; Les agents ne répondent pas à partir du contenu des pièces jointes.
• La sélection d’un site SharePoint n’inclut pas ses listes. Pour utiliser une liste comme une connaissance, sélectionnez la liste spécifique.

Entrer une URL pour les fichiers, dossiers, listes ou sites

Entrez l’URL d’un site, dossier ou fichier SharePoint, par contoso.sharepoint.com/sites/policiesexemple. L’agent recherche l’URL et les sous-chemins. Par exemple, une URL telle que comprend également des sous-chemins tels que contoso.sharepoint.com/sitescontoso.sharepoint.com/sites/policies. L'agent utilise les informations pertinentes pour fournir une réponse ciblée.

Vous pouvez également ajouter une liste SharePoint par URL. Dans la liste, sélectionnez Partager ou Copier le lien pour obtenir le lien, puis collez l’URL de la liste (sans paramètres de requête). Utilisez un lien direct vers la liste spécifique, pas une vue filtrée ou groupée. Une URL de site SharePoint n’inclut pas les listes de ce site. Il faut donc entrer l’URL de la liste.

Pour OneDrive, entrez un lien de partage vers un fichier ou dossier (par exemple, une URL copiée à partir du navigateur ou des options de partage), et non un chemin d’accès local ou relatif (par exemple). C:\Users\YourName\Documents\File.xlsx

Après avoir fourni l’URL, appuyez sur Entrée pour l’ajouter en tant que source de connaissances.

Parcourir pour sélectionner des fichiers, dossiers, listes ou sites

Sélectionnez l’icône de nuage Joindre des fichiers cloud dans la section Connaissances pour ouvrir le sélecteur de fichiers. Le sélecteur affiche vos sites SharePoint et OneDrive récemment consultés. Pour afficher d’autres sites SharePoint, sélectionnez Autres emplacements en bas du volet gauche. Si vous avez récemment créé un site, il apparaît après plusieurs minutes.

Pour rechercher une liste SharePoint, sélectionnez Listes récentes dans le volet gauche du sélecteur, puis sélectionnez la liste que vous souhaitez ajouter.

Préparation des fichiers

Lorsque vous chargez de nouveaux fichiers dans SharePoint ou OneDrive, l’agent peut mettre plusieurs minutes à les inclure dans sa réponse. Vous pouvez toujours tester votre agent dans l’onglet Essayer si les sources ne sont pas prêtes. Cependant, les réponses n'incluent pas les informations du fichier nouvellement téléchargé jusqu'à ce qu'il soit prêt.

Vous pouvez vérifier la case activée de l’état de préparation du fichier dans la section Connaissances de l’onglet Configuration ; le mot « Préparation » est affiché en regard du fichier. Lorsque vous renommez ou supprimez le fichier sous-jacent téléchargé sur SharePoint ou OneDrive, l’agent récupère les modifications. Vous pouvez également sélectionner le bouton Actualiser en haut de la section Connaissances pour recharger manuellement l’état.

Pages OneNote

Vous pouvez choisir des pages OneNote spécifiques dans le sélecteur de fichiers à charger en tant que connaissances. Vous ne pouvez sélectionner que des pages OneNote individuelles ; l’option permettant de sélectionner un bloc-notes OneNote entier n’est pas disponible. Lorsque vous sélectionnez Mes fichiers, dossiers et sites SharePoint, les pages OneNote sont incluses.

Utilisez le sélecteur de fichiers pour ajouter des pages OneNote. Agent Builder ne prend pas en charge la saisie d’URL de page OneNote.

Données Microsoft Teams

Vous pouvez ancrer votre agent dans les données Microsoft Teams, y compris les messages de conversation et les informations de réunion Teams. Pour utiliser tous les messages de conversation, les transcriptions de réunion et les calendriers auxquels vous avez accès en tant que connaissances, sélectionnez Mes conversations et réunions Teams.

Vous pouvez également limiter vos agents à des conversations spécifiques, notamment des canaux d’équipe, des conversations de groupe et des conversations de réunion. L’étendue des connaissances à des conversations spécifiques améliore la précision et la pertinence des réponses des agents. Pour étendre la connaissance Teams à des conversations spécifiques, sous l’onglet Configurer , dans la section Connaissances , sélectionnez la barre de recherche. Dans la fenêtre qui s’ouvre, choisissez l’onglet Conversations , puis sélectionnez les conversations spécifiques à ajouter. Vous pouvez ajouter jusqu’à cinq conversations.

Vous pouvez également limiter vos agents à des réunions spécifiques. La définition de la portée des connaissances à des réunions spécifiques améliore la précision et la pertinence des réponses des agents. Pour étendre la connaissance Teams à des réunions spécifiques, sous l’onglet Configurer , dans la section Connaissances , sélectionnez la barre de recherche. Dans la fenêtre qui s’ouvre, choisissez l’onglet Réunions , puis sélectionnez les réunions spécifiques à ajouter.

Courriers électroniques Outlook

Vous pouvez ancrer votre agent dans la messagerie Outlook. Pour ajouter l’e-mail en tant que source de connaissances, dans l’onglet Configurer , dans la section Connaissances , sélectionnez la barre de recherche, puis choisissez Mes e-mails.

Contenu du fichier incorporé

Vous pouvez télécharger des fichiers directement depuis votre appareil pour que votre agent les utilise comme connaissances sous l’onglet Décrire ou Configurer . Les fichiers que vous téléchargez deviennent du contenu incorporé dans l’agent. Pour télécharger des fichiers, faites-les glisser et déposez-les de votre appareil dans l’un ou l’autre des onglets. Vous pouvez également choisir l’icône en forme de flèche sous l’onglet Configurer pour charger des fichiers à partir de votre appareil. Vous pouvez charger des fichiers individuels à partir de votre appareil, mais pas des dossiers de fichiers.

Vous pouvez ajouter jusqu’à 20 fichiers comme sources de connaissances.

Les fichiers incorporés sont stockés dans la zone géographique par défaut du locataire, et non dans l’emplacement de données préféré de l’utilisateur (PDL).

L’onglet Configurer affiche les fichiers incorporés sous Fichiers téléchargés. Le chargement des Files peut prendre quelques minutes et apparaître gris jusqu’à ce qu’ils soient entièrement téléchargés. Le délai de téléchargement peut varier en fonction de la taille du fichier et de la vitesse d’accès à Internet. Pour plus d’informations sur les limites de taille des fichiers incorporés, voir Limites de taille de fichier.

Pour supprimer un fichier que vous avez chargé, cliquez sur le X en regard du fichier, puis sélectionnez Supprimer.

Les Files présentant l’une des caractéristiques suivantes ne sont pas pris en charge :

• Chiffrement à double clé.
• Étiquettes de confidentialité dotées d’autorisations définies par l’utilisateur. Si vous chargez un fichier avec des autorisations définies par l’utilisateur, la création de l’agent échoue.
• Étiquettes de confidentialité pour lesquelles l’autorisation des droits d’extraction est désactivée. Si vous téléchargez ces fichiers, la création de l’agent échoue. Si un utilisateur de l’agent ne dispose pas des droits d’extraction d’un fichier incorporé, il ne peut pas accéder à l’agent.
• Files d’un autre client dont le chiffrement est activé.
• Protection par mot de passe.

Pour plus d’informations, consultez Scénarios d’étiquettes de confidentialité non pris en charge.

Pour plus d’informations sur l’indexation et la récupération du contenu de fichiers incorporés, consultez Optimiser la récupération de contenu.

Étiquettes de confidentialité pour le contenu incorporé de l’agent

Appliquez une étiquette de confidentialité au contenu incorporé de l’agent si vous chargez des fichiers avec une étiquette de confidentialité ou si votre locataire a une stratégie d’étiquetage de sensibilité par défaut. En appliquant une étiquette de confidentialité au contenu incorporé de l’agent, vous vous assurez que l’agent est conforme aux stratégies Microsoft Purview de votre organisation.

L’étiquette de confidentialité appliquée au contenu incorporé est la priorité la plus élevée des étiquettes suivantes :

• L’étiquette de confidentialité de priorité la plus élevée appliquée à un fichier incorporé.
• Stratégie d’étiquette de confidentialité par défaut appliquée par l’organisation.

Par exemple, si vous incorporez un fichier avec une étiquette Général et un fichier avec une étiquette Confidentiel dans l’agent, l’étiquette de confidentialité Confidentiel est appliquée au contenu incorporé.

Seuls les utilisateurs disposant d’autorisations de droits d’extraction sur l’étiquette de confidentialité appliquée au contenu incorporé peuvent accéder à l’agent et l’utiliser. L’étiquette n’apparaît pas dans la description dans le Store d’agents. Les utilisateurs qui ne disposent pas des autorisations de droits d’extraction sur le contenu incorporé peuvent afficher l’agent et sa description, mais ils ne peuvent pas ajouter ou utiliser l’agent.

Une étiquette de confidentialité est également appliquée aux réponses de l’agent. Cette étiquette a la priorité la plus élevée des étiquettes suivantes :

• L’étiquette de sensibilité du contenu incorporé
• Étiquette de confidentialité de toute autre source de connaissances de l’agent, telles que les fichiers SharePoint et OneDrive.

Vous ne pouvez actuellement pas définir d’étiquette de confidentialité sur un agent.

Scénarios d’étiquettes de confidentialité non pris en charge

Le tableau suivant répertorie les scénarios d’étiquettes de confidentialité qui ne sont pas pris en charge actuellement, décrit le comportement lorsqu’un générateur charge le fichier sur l’agent et fournit l’action recommandée pour le générateur.

Partage d’un agent avec des fichiers incorporés

Lorsque vous partagez un agent avec des fichiers incorporés, vous partagez les fichiers avec les utilisateurs lorsqu’ils acquièrent l’agent. Une fois que les utilisateurs ont acquis l’agent, ils peuvent obtenir des réponses de Copilot basées sur ces sources de connaissances. Pour connaître les options de partage disponibles, consultez Partager et gérer des agents intégrés à Agent Builder.

Lorsque vous partagez l’agent, l’écran de partage affiche l’étiquette de confidentialité si des étiquettes de confidentialité sont définies sur le contenu incorporé.

Types de fichiers et limites de taille

Le tableau suivant répertorie les types de fichiers que vous pouvez ajouter en tant que connaissances à votre agent et les limites de taille de fichier incorporées pour chaque type de fichier.

* Prise en charge uniquement pour SharePoint dans Microsoft 365.

Données People

Si vous ancrez votre agent dans les données People, il peut fournir des réponses plus personnalisées et contextuelles. Les données People fournissent des informations publiques sur les individus, telles que le nom, le poste, les compétences et les relations organisationnelles. Ces informations permettent aux agents de rechercher les profils des utilisateurs et des collègues, y compris la structure hiérarchique et les coordonnées.

Les données de People sont activées par défaut pour les agents créés par des utilisateurs disposant d’une licence Microsoft 365 Copilot. Vous pouvez désactiver ou réactiver cette fonctionnalité dans l’interface utilisateur de configuration de l’agent. Pour activer ou désactiver les données People :

• Dans l’onglet Configurer du générateur d’agent, sélectionnez le bouton bascule en regard de Référencer des personnes dans l’organisation pour activer ou désactiver les données People.

La disponibilité de cette fonctionnalité dépend de votre licence. Pour plus de détails, consultez Licences Microsoft 365 Copilot.

Connecteurs Copilot

Les connecteurs Copilot permettent aux agents d’accéder aux connaissances de systèmes externes tels que des comptes clients, des tickets d’incident, des référentiels de code et des articles de connaissances et de les appliquer. Utilisez les connecteurs Copilot pour intégrer les données d’entreprise dans vos agents et leur donner des connaissances spécifiques au domaine.

Pour plus d’informations sur les connecteurs Copilot, consultez Vue d’ensemble des connecteurs Microsoft 365 Copilot.

Scope Sources de données du connecteur Copilot

Pour améliorer la précision et la pertinence des réponses des agents, les agents au sol non seulement dans des données organisationnelles larges, mais aussi dans des données spécifiques. Pour limiter les données de connecteur de votre agent à un attribut spécifique :

1. Sous l’onglet Configurer , sous Choisir d’autres sources de données, sélectionnez le connecteur de votre source de données.

2. Sur la carte de ce connecteur, ajoutez les connexions pertinentes pour votre scénario.

3. Sélectionnez la flèche pour revenir à la section Connaissances .

4. Développez le connecteur que vous avez ajouté et sélectionnez l’attribut auquel vous souhaitez étendre la connaissance (par exemple, projet, espace, dossier), puis recherchez ou tapez le nom de l’attribut.

   Remarque

   Si l’attribut n’apparaît pas dans les résultats de recherche, c’est peut-être parce que :

   • Votre administrateur n’a pas configuré le contenu délimité.
   • Vous ne disposez pas des autorisations requises pour accéder au contenu.
   • L’étendue n’est pas valide pour le connecteur sélectionné.

5. Sélectionnez l’attribut dans la liste pour l’ajouter.

6. Les connaissances de votre agent sont désormais limitées aux données associées à l’attribut étendu.

Par exemple, lorsque vous utilisez le connecteur Éléments de travail Azure DevOps, vous pouvez étendre l’agent à un chemin d’accès de zone particulier pour vous assurer que l’agent se concentre uniquement sur les éléments de travail les plus pertinents.

Pour étendre l’étendue de la zone des éléments de travail d’Azure DevOps, chemin d’accès :

1. Sous Choisir d’autres sources de données, sélectionnez Éléments de travail Azure DevOps.
2. Sélectionnez Ajouter en regard des connexions pertinentes pour vos tâches.
3. Sélectionnez la flèche pour revenir à la section Connaissances .
4. Sélectionnez Sélectionner un chemin de zone et recherchez ou tapez le nom du chemin de la zone.
5. Sélectionnez le chemin de la zone pour l’ajouter.

Le tableau suivant répertorie les connecteurs Copilot qui prennent en charge l’étendue et les attributs que vous pouvez utiliser pour étendre les données.

Pour plus d’informations sur les connecteurs Copilot disponibles, consultez la galerie des connecteurs prédéfinis.

Données Dynamics 365 et Power Apps

Applications métier dans Work IQ aide les agents à comprendre et à utiliser les données et processus métier de Dynamics 365 et Power Platform. Connectez vos applications métier pour donner aux agents le contexte dont ils ont besoin pour répondre aux questions, suivre les processus métier et agir dans le cadre de vos autorisations et contrôles existants.

L’ajout de Dataverse comme source de connaissances fournit un accès en lecture au contenu et ne permet pas la création, la mise à jour ou la suppression d’enregistrements.

À l’aide du Générateur d’agent, vous pouvez déterminer quelles applications sont incluses en tant que sources de données et avoir accès aux applications, aux tables et aux données. Toutefois, les paramètres de sécurité Dataverse réglementent toutes les données. Aucune réponse n’est fournie aux utilisateurs qui n’ont pas encore accès aux applications ou données spécifiées.

Si vous ne choisissez pas d’applications spécifiques, les requêtes s’exécutent sur toutes les applications auxquelles vous avez accès. Pour plus d’informations, consultez Sources de connaissances.

Donnez la priorité à vos sources de connaissances plutôt qu’aux connaissances générales

Vous pouvez configurer votre agent pour qu’il hiérarchise les sources de connaissances que vous fournissez, telles que le contenu SharePoint ou les fichiers incorporés, lorsqu’il répond à des requêtes qui nécessitent des recherches basées sur les connaissances. Les recherches basées sur les connaissances sont des demandes des utilisateurs pour rechercher des informations spécifiques ; Par exemple :

• Qui est le PDG actuel de l’entreprise ?
• Quand aura lieu la prochaine conférence d’affaires ?
• Quelle est la dernière mise à jour liée à une fonctionnalité ?

Certaines demandes d’utilisateurs ne nécessitent pas de recherches basées sur les connaissances ; l’agent peut répondre en se basant sur des connaissances générales de l’IA. Par exemple :

• Traduisez cette phrase en espagnol : « Bonjour, comment allez-vous ? »
• Qu’est-ce que 1+1 ?

Lorsque vous activez cette fonctionnalité, l’agent répond à des questions simples qui ne nécessitent pas de recherche en utilisant ses connaissances générales et il utilise vos sources de connaissances uniquement pour répondre aux questions basées sur la recherche. Si l’agent ne trouve pas d’informations pertinentes dans les sources de connaissances que vous fournissez, il répond par un message de secours qui indique qu’il ne trouve pas l’information. Utilisez le paramètre Utiliser uniquement les sources spécifiées pour que l’agent hiérarchise les sources que vous désignez. Ce paramètre donne la priorité à vos sources plutôt que de bloquer les connaissances générales de l’IA.

Pour configurer votre agent afin qu’il hiérarchise vos sources de connaissances, dans l’onglet Configurer , sélectionnez le bouton bascule à côté de Utiliser uniquement les sources spécifiées.

Contenu connexe

• Vue d’ensemble d’Agent Builder
• Créer des agents dans Agent Builder
• Modèles Agent Builder
• Partager et gérer des agents intégrés à Agent Builder