Ajouter des sources de connaissances à un agent déclaratif créé avec Microsoft 365 Agents Toolkit

Vous pouvez contrôler les connaissances dont dispose votre agent pour générer des réponses avec des sources de connaissances provenant du web et de vos données organisationnelles Microsoft 365. Pour obtenir la liste complète des sources de connaissances disponibles, voir Ajouter des sources de connaissances à votre agent déclaratif.

Ajouter une recherche web à l’agent

L’ajout d’une recherche web à votre agent lui permet d’effectuer des recherches sur le web pour générer des réponses. Vous pouvez éventuellement étendre les connaissances à des sites web spécifiques.

1. Ouvrez le appPackage/declarativeAgent.json fichier et ajoutez le capabilities tableau avec le contenu suivant.

   "capabilities": [
     {
       "name": "WebSearch"
     }
   ]
   

   Pour plus d’informations, voir Objet de recherche web.

2. Sélectionnez Attribution dans le volet Cycle de vie de Microsoft 365 Agents Toolkit.

L’agent déclaratif a accès au contenu web pour générer ses réponses après le rechargement de la page.

Ajouter un site SharePoint à l’agent

Vous pouvez ajouter des fichiers dans OneDrive ou le contenu de sites SharePoint en tant que source de connaissances.

1. Ouvrez le appPackage/declarativeAgent.json fichier et ajoutez la valeur suivante au tableau, en capabilities la remplaçant par https://contoso.sharepoint.com/sites/ProductSupport une URL de site SharePoint dans votre organization Microsoft 365.

   {
     "name": "OneDriveAndSharePoint",
     "items_by_url": [
       {
         "url": "https://contoso.sharepoint.com/sites/ProductSupport"
       }
     ]
   }
   

   Pour plus d’informations, voir OneDrive et objet SharePoint.

   Remarque

   • Les URL doivent être le chemin d’accès complet aux éléments SharePoint (site, bibliothèque de documents, dossier ou fichier). Vous pouvez utiliser l’option « Copier le lien direct » dans SharePoint pour obtenir le chemin d’accès complet ou les fichiers et dossiers. Cliquez avec le bouton droit sur le fichier ou le dossier, puis sélectionnez Détails. Accédez à Chemin d’accès et sélectionnez l’icône de copie.
   • Si vous ne spécifiez pas le items_by_url tableau (ou le tableau de remplacementitems_by_sharepoint_ids), tout le contenu OneDrive et SharePoint de votre organisation Microsoft 365 disponible pour l’utilisateur connecté est disponible pour l’agent.

2. Sélectionnez Attribution dans le volet Cycle de vie d’Agents Toolkit.

L’agent déclaratif a accès au contenu OneDrive et SharePoint pour générer ses réponses après le rechargement de la page.

Ajouter des messages Teams à l’agent

1. Ouvrez le appPackage/declarativeAgent.json fichier et ajoutez la valeur suivante dans le capabilities tableau, en la remplaçant https://teams.microsoft.com/l/team/... par un canal Teams ou une URL d’équipe de votre organisation.

   {
     "name": "TeamsMessages",
     "urls": [
       {
         "url": "https://teams.microsoft.com/l/team/..."
       }
     ]
   }
   

   Pour plus d’informations, voir Objet messages Microsoft Teams.

   Remarque

   • L’URL de la url propriété doit être un lien bien formé vers une conversation, une équipe ou une conversation de réunion Teams.
   • Si vous ne spécifiez pas le urls tableau, tous les canaux Teams, équipes, réunions, conversations en tête à tête et conversations de groupe de votre organisation Microsoft 365 disponibles pour l’utilisateur connecté sont disponibles pour l’agent.

2. Sélectionnez Attribution dans le volet Cycle de vie d’Agents Toolkit.

L’agent déclaratif a accès aux données Teams pour générer ses réponses après le rechargement de la page.

Ajouter des connaissances de personnes à l’agent

La source de connaissances Personnes vous permet d’amener votre agent à répondre à des questions sur les individus d’une organisation.

1. Ouvrez le appPackage/declarativeAgent.json fichier et ajoutez l’entrée People au capabilities tableau.

   {
     "name": "People"
   }
   

   Pour plus d’informations, voir Objet People.

2. Sélectionnez Attribution dans le volet Cycle de vie d’Agents Toolkit.

L’agent déclaratif a accès à la connaissance des personnes après que vous avez rechargé la page.

Ajouter des e-mails à l’agent

La source de connaissances par e-mail vous permet d’autoriser votre agent à utiliser les e-mails de la boîte aux lettres de l’utilisateur ou d’une boîte aux lettres partagée pour répondre aux requêtes.

1. Ouvrez le appPackage/declarativeAgent.json fichier et ajoutez l’entrée Email au capabilities tableau.

   {
     "name": "Email",
     "folders": [
       {
         "folder_id": "inbox"
       }
     ]
   }
   

   Pour plus d’informations, voir Objet Email.

   Remarque

   • Cet exemple accède à l’utilisateur de la boîte aux lettres de l’agent. Pour accéder à une boîte aux lettres partagée, ajoutez le jeu de propriétés facultatif shared_mailbox à l’adresse e-mail de la boîte aux lettres partagée.
   • Le folders tableau limite l’accès de la boîte aux lettres à des dossiers spécifiques. Pour accéder à l’intégralité de la boîte aux lettres, omettez le folders tableau.

2. Sélectionnez Attribution dans le volet Cycle de vie d’Agents Toolkit.

L’agent déclaratif a accès à la base de connaissances par e-mail après que vous avez rechargé la page.

Ajouter un connecteur Copilot à l’agent

L’ajout d’un connecteur Copilot rend les éléments ingérés par ce connecteur disponibles pour l’agent en tant que source de connaissances.

1. Ouvrez le appPackage/declarativeAgent.json fichier et ajoutez la valeur suivante au capabilities tableau, en la remplaçant par policieslocal un ID de connecteur Copilot valide dans votre organization Microsoft 365. Pour plus d’informations sur la recherche des ID de connecteur Copilot, consultez Récupérer les ID de capacité pour le manifeste de l’agent déclaratif.

   {
     "name": "GraphConnectors",
     "connections": [
       {
         "connection_id": "policieslocal"
       }
     ]
   }
   

   Pour plus d’informations, consultez Objet connecteurs Copilot.

   Remarque

   • Si vous ne spécifiez pas le tableau, connections tout le contenu des connecteurs Copilot de votre organisation Microsoft 365 disponible pour l’utilisateur connecté est disponible pour l’agent.

2. Sélectionnez Attribution dans le volet Cycle de vie d’Agents Toolkit.

L’agent déclaratif a accès au contenu des connecteurs Copilot pour générer ses réponses après le rechargement de la page.

Étape suivante