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

Vous pouvez contrôler les connaissances disponibles pour votre agent pour générer des réponses à l’aide de 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, consultez Ajouter des sources de connaissances à votre agent déclaratif.

Ajouter la recherche web à l’agent

L’ajout de la recherche web à votre agent lui permet de rechercher 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, consultez Objet de recherche web.

1. Sélectionnez Provision dans le volet Cycle de vie du Kit de ressources Agents.

L’agent déclaratif aura accès au contenu web pour générer ses réponses après avoir rechargé la page.

Ajouter un site SharePoint à l’agent

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

1. Ouvrez le appPackage/declarativeAgent.json fichier et ajoutez la valeur suivante au capabilities tableau, en remplaçant https://contoso.sharepoint.com/sites/ProductSupport par 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 et sélectionnez l’icône de copie.
   • Si vous ne spécifiez pas le items_by_url tableau (ou l’autre items_by_sharepoint_ids tableau), tout le contenu OneDrive et SharePoint de votre organization Microsoft 365 disponible pour l’utilisateur connecté sera disponible pour l’agent.

2. Sélectionnez Provision dans le volet Cycle de vie du Kit de ressources Agents.

L’agent déclaratif aura accès au contenu OneDrive et SharePoint pour générer ses réponses après avoir rechargé la page.

Ajouter des messages Teams à l’agent

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

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

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

   Remarque

   • L’URL dans l’objet url doit être des liens bien formés vers une conversation Teams, une équipe ou une conversation de réunion.
   • Si vous ne spécifiez pas le urls tableau, tous les canaux Teams, équipes, réunions, conversations 1:1 et conversations de groupe dans votre organization Microsoft 365 disponible pour l’utilisateur connecté sont disponibles pour l’agent.

2. Sélectionnez Provision dans le volet Cycle de vie du Kit de ressources Agents.

L’agent déclaratif aura accès aux données Teams pour générer ses réponses après avoir rechargé la page.

Ajouter des connaissances sur les personnes à l’agent

La source de connaissances people vous permet de définir l’étendue de votre agent pour répondre à des questions sur les personnes d’un organization.

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

   {
     "name": "People"
   }
   

Pour plus d’informations, consultez Personnes’objet.

1. Sélectionnez Provision dans le volet Cycle de vie du Kit de ressources Agents.

L’agent déclaratif a accès aux connaissances des personnes après avoir rechargé la page.

Ajouter des messages électroniques à l’agent

La source de connaissances e-mail vous permet de limiter votre agent à l’utilisation du courrier électronique provenant 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, consultez Email’objet.

   Remarque

   • Cet exemple montre comment accéder à l’utilisateur de la boîte aux lettres de l’agent. Pour accéder à une boîte aux lettres partagée à la place, ajoutez la propriété facultative shared_mailbox définie à l’adresse e-mail de la boîte aux lettres partagée.
   • Le folders tableau limite l’accès aux boîtes aux lettres à des dossiers spécifiques. Pour accéder à la boîte aux lettres entière, omettez le folders tableau.

2. Sélectionnez Provision dans le volet Cycle de vie du Kit de ressources Agents.

L’agent déclaratif a accès à la connaissance de l’e-mail après avoir rechargé la page.

Ajouter un connecteur Microsoft 365 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 remplaçant policieslocal par 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ération des ID de fonctionnalités 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 connections tableau, tout le contenu des connecteurs Copilot dans votre organization Microsoft 365 disponible pour l’utilisateur connecté est disponible pour l’agent.

2. Sélectionnez Provision dans le volet Cycle de vie du Kit de ressources Agents.

L’agent déclaratif aura accès au contenu des connecteurs Copilot pour générer ses réponses après avoir rechargé la page.

Étape suivante