Ajouter des sources de connaissances à votre agent déclaratif

Vous pouvez améliorer l’expérience utilisateur de votre agent déclaratif en ajoutant des fonctionnalités telles que l’interpréteur de code et le générateur d’images et des sources de connaissances pour améliorer et personnaliser les connaissances de votre agent. L’objet capabilities dans la référence du manifeste et la section Knowledge dans Microsoft 365 Copilot fournissent plusieurs options pour déverrouiller des fonctionnalités pour vos utilisateurs. Cet article décrit les sources de connaissances que vous pouvez ajouter à vos agents.

Le tableau suivant répertorie les fonctionnalités et les sources de connaissances que vous pouvez configurer à l’aide de Microsoft 365 Copilot ou microsoft 365 Agents Toolkit et indique si les utilisateurs ont besoin d’une licence Microsoft 365 Copilot ou d’une utilisation limitée pour accéder aux agents avec cette fonctionnalité ou cette source de connaissances.

* L’option permettant de définir l’étendue des connaissances est disponible.

Connecteurs Copilot

Microsoft 365 Copilot connecteurs vous permettent d’ajouter des données organisationnelles à votre agent en tant qu’informations de base. Vous pouvez utiliser des connecteurs Copilot pour ingérer vos données métier dans Microsoft Graph et Copilot peut raisonner vos données comme informations de mise à la terre dans les réponses aux invites des utilisateurs. Pour plus d’informations, consultez vue d’ensemble des connecteurs Microsoft 365 Copilot.

Pour plus d’informations sur l’ajout de connecteurs Copilot en tant que connaissances à votre manifeste d’agent dans Agents Toolkit, consultez Objet connecteurs Copilot.

Pour plus d’informations sur l’ajout de connecteurs Copilot à votre agent dans Microsoft 365 Copilot, consultez Connecteurs Copilot.

SharePoint et OneDrive

Lorsque vous configurez votre agent pour utiliser le contenu OneDrive et SharePoint comme connaissance, Copilot recherche des informations sur les fichiers, dossiers ou sites SharePoint et OneDrive auxquels un utilisateur a accès.

Pour plus d’informations sur l’ajout de connaissances OneDrive et SharePoint à votre manifeste d’agent dans le Kit de ressources Agents, voir OneDrive et objet SharePoint.

Pour plus d’informations sur l’ajout de connaissances SharePoint à votre agent dans Microsoft 365 Copilot, voir Ajouter des sources de connaissances.

Recherche web et web délimitée

La recherche web permet aux agents d’utiliser l’index de recherche dans Bing pour répondre aux invites des utilisateurs. Si vous activez la recherche web dans votre agent, vous pouvez demander à votre agent de retourner toutes les données web dans ses réponses. Vous pouvez également étendre la recherche web à un maximum de quatre sites web publics.

Ajouter une recherche web et étendue

Si vous utilisez Agents Toolkit et Visual Studio Code pour créer votre agent, pour activer la recherche web, vous ajoutez la WebSearch valeur à la propriété capabilities dans votre fichier manifeste. Si vous souhaitez étendre votre recherche web à des sites spécifiques, ajoutez la propriété sites et spécifiez jusqu’à quatre URL, comme indiqué dans l’exemple suivant.

{
  "capabilities": [
    {
      "name": "WebSearch",
      "sites": [
        {
          "url": "cnn.com"
        }
      ]
    }
  ]
}

Si vous utilisez Microsoft 365 Copilot pour créer votre agent, sous l’onglet Configurer, sous Connaissances, répertoriez les URL de site web que vous souhaitez référencer.

Contenu de fichier incorporé

Si vous utilisez Microsoft 365 Copilot pour créer votre agent, vous pouvez charger des fichiers directement à partir de votre appareil ou du cloud pour incorporer le contenu que votre agent doit utiliser comme base de connaissances. Le contenu du fichier incorporé est stocké dans SharePoint Embedded. Ces fichiers sont comptabilisés par rapport à la capacité OneDrive et SharePoint de votre locataire.

Pour plus d’informations sur les fichiers incorporés, consultez Contenu des fichiers incorporés.

Dataverse

La connaissance de Dataverse permet aux agents de répondre en langage naturel aux requêtes des utilisateurs sur leurs données CRM ou les données de tables dans Microsoft Dataverse. Vous pouvez ajouter une instance Dataverse en tant que source de connaissances et ajouter des synonymes et un glossaire pour aider le système à mieux interpréter les données personnalisées dans vos tables. Pour plus d’informations, consultez Ajouter une source de connaissances Dataverse.

Ajouter des connaissances Dataverse

Si vous utilisez Agents Toolkit et Visual Studio Code pour créer votre agent, pour activer la connaissance de Dataverse, ajoutez la Dataverse valeur à la propriété capabilities dans votre fichier manifeste d’agent, comme illustré dans l’exemple suivant.

{
  "capabilities": [
    {
      "name": "Dataverse",
      "knowledge_sources": [
        {
          "host_name": "organization.crm.dynamics.com",
          "skill": "DVCopilotSkillName",
          "tables": [
            {
              "table_name": "account"
            },
            {
              "table_name": "opportunity"
            }
          ]
        }
      ]
    }
  ]
}

E-mail

Email connaissances vous permet d’étendre votre agent à une boîte aux lettres personnelle ou partagée, et éventuellement à un dossier de boîte aux lettres spécifique.

Ajouter des sources de connaissances par e-mail

Si vous utilisez Microsoft 365 Copilot pour créer votre agent, sous l’onglet Configurer de la section Connaissances, choisissez Mes e-mails.

Si vous utilisez Agents Toolkit et Visual Studio Code pour créer votre agent, ajoutez la valeur à la Email propriété capabilities dans votre fichier manifeste d’agent, comme illustré dans l’exemple suivant. Vous pouvez référencer plusieurs dossiers de boîtes aux lettres et un seul dossier partagé.

{
  "capabilities": [
    {
      "name": "Email",
      "shared_mailbox": "sample@service.microsoft.com",
      "folders": [
        {
          "folder_id": "inbox"
        }
      ]
    }
  ]
}

Dans le champ folder_id , vous pouvez référencer des noms de dossiers connus ou des ID de dossier. Pour obtenir la liste des noms de dossiers connus, consultez Type de ressource mailFolder. Pour obtenir la liste des ID de dossier, utilisez la requête suivante dans Graph Explorer :

https://graph.microsoft.com/v1.0/me/mailFolders

Dans le champ shared_mailbox , utilisez l’adresse SMTP de la boîte aux lettres partagée.

Dans le champ group_mailboxes , vous pouvez définir un array de chaînes (jusqu’à 25) contenant les adresses SMTP des boîtes aux lettres partagées ou des groupes Microsoft 365 auxquels vous souhaitez que votre agent soit limité.

Si vous référencez à la fois une boîte aux lettres partagée et un dossier, l’agent étend les réponses au dossier dans la boîte aux lettres partagée. Si vous référencez un dossier uniquement, l’agent étend les réponses au contenu du dossier dans la boîte aux lettres personnelle.

Si vous ne référencez pas une boîte aux lettres partagée ou un dossier, la recherche de l’agent n’est limitée à aucun dossier ou boîte aux lettres et retourne les résultats de tout le contenu de l’e-mail, en fonction de la requête de l’utilisateur.

Personnes

Vous pouvez baser votre agent dans Personnes données pour fournir des réponses plus personnalisées et contextuelles. Personnes données combinent des informations publiques sur les individus (telles que le nom, le poste, les compétences et les relations organisationnelles) avec une vue personnelle des connexions, des collaborateurs et des insights pertinents de l’utilisateur. Cette source de connaissances permet aux agents de :

• Recherchez les profils d’utilisateur et de collègue, y compris la structure de création de rapports et les coordonnées.
• Identifiez les experts du domaine et les collaborateurs clés au sein du organization.
• Personnalisez les réponses en fonction des relations de l’utilisateur, des interactions passées et des préférences.
• Fournir des recommandations et des conseils de communication adaptés à des équipes ou des individus spécifiques.

Ajouter une source de connaissances

Si vous utilisez Copilot Studio pour créer votre agent, la source de connaissances Personnes est activée par défaut pour les utilisateurs disposant d’une licence Microsoft 365 Copilot.

Si vous utilisez Agents Toolkit et Visual Studio Code pour créer votre agent, pour activer la connaissance des personnes, ajoutez la People valeur à la propriété capabilities dans le fichier manifeste de votre agent, comme illustré dans l’exemple suivant. La déclaration de la seule fonctionnalité de base People permet à l’agent de raisonner uniquement sur des données organization de base telles que celles disponibles dans le profil carte. Si vous souhaitez inclure du contenu tel que des messages d’équipe associés, des e-mails et des fichiers entre l’utilisateur de l’agent et les personnes référencées dans le organization reportez-vous à la version 1.6 pour utiliser la include_related_content propriété .

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

Si vous avez besoin de votre agent pour raisonner sur le contenu associé (entre l’utilisateur de l’agent et les personnes référencées), tels que les messages, les e-mails et les fichiers des équipes associées, vous pouvez tirer parti de include_related_content. La valeur par défaut est false.

{
  "capabilities": [
    {
      "name":"People",
      "include_related_content": true
    }
  ]
}

Messages Teams

Vous pouvez configurer des agents pour utiliser les canaux Teams, les conversations de réunion, les conversations de groupe et les conversations 1:1 comme sources de connaissances. Vous pouvez choisir de spécifier jusqu’à cinq liens vers des canaux, des groupes, des conversations 1:1 ou de réunion pour étendre la recherche Copilot, ou vous pouvez autoriser votre agent à utiliser le contenu Teams de l’utilisateur, y compris les canaux, les réunions et les conversations individuelles et de groupe, comme sources de connaissances.

Les agents peuvent retourner des liens vers des fichiers partagés dans des messages Teams, mais ils ne peuvent pas retourner de liens vers des fichiers stockés dans un canal Teams, sauf si l’agent a OneDriveAndSharePoint également activé. Pour plus d’informations sur l’optimisation du contenu SharePoint pour Copilot, voir Optimiser la récupération de contenu SharePoint.

Ajouter des sources de connaissances de messages Teams

Si vous utilisez Microsoft 365 Copilot pour créer votre agent, sous l’onglet Configurer, dans la section Connaissances, sélectionnez la barre de recherche et choisissez Mes conversations et réunions Teams. Pour étendre votre agent à des conversations de canal, de réunion ou de groupe spécifiques, sous l’onglet Conversations, sélectionnez les conversations que vous souhaitez ajouter en tant que connaissances.

Si vous utilisez agents Toolkit et Visual Studio Code pour créer votre agent, pour activer la connaissance des messages Teams, ajoutez la TeamsMessage valeur à la propriété capabilities dans votre référence de manifeste. Si vous souhaitez étendre les connaissances Teams à un maximum de cinq ressources Teams, ajoutez les liens à la propriété urls , comme illustré dans l’exemple suivant.

{
  "capabilities": [
    {
      "name": "TeamsMessages",
      "urls": []
    }
  ]
}

Obtenir l’URL d’un canal ou d’une réunion

Pour obtenir l’URL d’un canal Teams, choisissez les trois points (...) en regard du nom du canal, puis choisissez Obtenir le lien vers le canal.

Pour obtenir l’URL d’une réunion Teams, ouvrez la réunion, choisissez la flèche en regard de Rejoindre, puis choisissez Copier le lien de participation.

Obtenir l’URL d’un groupe ou d’une conversation 1:1

Pour obtenir l’URL d’un groupe ou d’une conversation 1:1, vous avez besoin d’un lien profond qui inclut le chatId. Le lien profond a le format suivant : https://teams.microsoft.com/l/chat/<chatId>/conversations. La valeur chatId est différente pour chaque conversation.

Pour obtenir la valeur chatId d’un groupe ou d’une conversation 1:1 :

1. Dans Microsoft Teams, accédez à n’importe quel message dans la conversation.
2. Pointez sur le message et choisissez les trois points (...).
3. Sélectionnez Copier le lien.
4. Collez le lien dans le Bloc-notes ou une application similaire. Le lien ressemble à l’URL suivante : https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces//1743033793614?context=%7B%22contextType%22%3A%22chat%22%7D.
5. Copiez le segment de l’URL qui se trouve entre chat/ et le suivant /. Le segment est généralement précédé de 19:. Il s’agit du chatId. Dans l’exemple précédent, chatId est 19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces.
6. Ajoutez le chatId au lien profond. Par exemple : https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces/conversations.

Pour plus d’informations, consultez Lien profond vers la conversation Teams.

Réunions Teams

La connaissance des réunions Teams vous permet d’étendre l’étendue de votre agent pour répondre aux questions sur les réunions, y compris les réunions uniques ou les séries de réunions. Par exemple, votre agent peut répondre à des requêtes telles que « Récapitulation des réunions d’hier et liste des éléments d’action » ou « Qu’est-ce qui a été dit sur Project X dans mes réunions ? ». Cette source de connaissances peut éventuellement être étendue à jusqu’à cinq réunions spécifiques. Cette source de connaissances permet à l’agent d’accéder aux métadonnées de réunion (objet, organisateur, participants et titre), au contenu de transcription et aux conversations de réunion.

Ajouter une source de connaissances de réunions

Si vous utilisez Microsoft 365 Copilot pour créer votre agent, sous l’onglet Configurer, dans la section Connaissances, sélectionnez la barre de recherche et choisissez Mes conversations et réunions Teams. La possibilité de s’étendre aux réunions sera bientôt disponible dans Microsoft 365 Copilot.

Si vous utilisez Agents Toolkit et Visual Studio Code pour créer votre agent, pour activer la connaissance des réunions, ajoutez la Meetings valeur à la propriété capabilities dans votre fichier manifeste d’agent, comme illustré dans l’exemple suivant. Si vous souhaitez étendre l’agent à des réunions spécifiques, ajoutez l’UID de la réunion à la items_by_id propriété . Pour obtenir des instructions sur la recherche de l’ID d’une réunion, consultez Obtenir l’ID d’une réunion.

{
  "capabilities": [
    {
      "name":"Meetings",
      "items_by_id": [
        {
          "id": "010000002300A00045B6C7890D12E0030000000040056F7GH890IJ01000000000000000020000000J3L45M6A7NO8PQ9R0S12TUV340XY5Z00",
          "is_series": true
        }
      ]
    }
  ]
}

Contenu connexe

• Vue d’ensemble des agents déclaratifs
• Informations de référence sur le manifeste de l’agent déclaratif
• Ajouter la fonctionnalité d’interpréteur de code à votre agent
• Ajouter la fonctionnalité de génération d’images à votre agent