Partager via


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 le générateur d’agent Copilot Studio 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 du générateur d’agents ou du Kit de ressources Microsoft 365 Agents (une évolution du Kit de ressources Teams) 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.

Capacité ou source de connaissances Générateur d’agents Agents Toolkit Licence ou utilisation limitée requise ?
Interpréteur de code Non
Générateur d’images Non
Connecteurs Copilot Oui
SharePoint Oui
OneDrive Oui
Contenu de fichier incorporé Oui
Recherche web Non
Recherche web délimitée Non
Dataverse ✅* Oui
E-mail ✅* Oui (licence uniquement)
Personnes Oui (licence uniquement)
Messages Teams ✅* Oui (licence uniquement)

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

Connecteurs Copilot

Microsoft 365 Copilot connecteurs (anciennement connecteurs Microsoft Graph) 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 Copilot Studio générateur d’agents, 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 Copilot Studio générateur d’agents, voir Ajouter des sources de connaissances.

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.

Importante

Les administrateurs de l’organisation peuvent désactiver la recherche web pour Copilot et tous les agents à l’intérieur de leur organization. Si vos administrateurs désactivent la recherche web, les agents avec la recherche web activée ne signalent pas d’erreur et n’incluent pas les recherches web dans leurs connaissances. Les cartes de débogage en mode développeur indiquent que la recherche web est activée si l’agent l’a activée, même si vos administrateurs l’ont désactivée. Pour plus d’informations, consultez Gérer les scénarios de Microsoft 365 Copilot dans le Centre d’administration Microsoft 365.

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.

Remarque

Vous devez utiliser la version 1.2 ou ultérieure du schéma de manifeste de l’agent déclaratif pour ajouter une recherche web étendue à votre agent.

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

Si vous utilisez Copilot Studio générateur d’agent 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 Copilot Studio générateur d’agents pour générer 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.

Remarque

La fonctionnalité de chargement de fichiers est disponible pour les utilisateurs dont la consommation limitée est activée ou avec une licence Microsoft 365 Copilot.

Pour plus d’informations sur les fichiers incorporés, consultez Contenu des fichiers incorporés dans le générateur d’agents.

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.

Remarque

La connaissance dataverse n’est actuellement pas disponible dans Copilot Studio générateur d’agents.

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.

Remarque

Vous devez utiliser la version 1.3 ou ultérieure du schéma de manifeste de l’agent déclaratif pour ajouter Dataverse des connaissances.

{
  "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 Copilot Studio générateur d’agents pour créer votre agent, sous l’onglet Configurer de la section Connaissances, choisissez Mes e-mails.

Remarque

Vous ne pouvez actuellement pas étendre vos e-mails à un dossier spécifique ou à une boîte aux lettres partagée lorsque vous utilisez le générateur d’agent.

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

Remarque

Vous devez utiliser la version 1.3 ou ultérieure du schéma de manifeste de l’agent déclaratif pour ajouter Email des connaissances.

{
  "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.

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

Personnes connaissances vous permet de limiter votre agent à des questions sur les personnes d’un organization. Par exemple, votre agent peut répondre à des requêtes telles que « Comment faire personne contact <» ou « Répertorier les rapports directs de <la personne> ».> Cette source de connaissances n’est pas délimitée.

Remarque

Personnes connaissances ne sont actuellement pas disponibles dans Copilot Studio générateur d’agents.

Ajouter une source de connaissances

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.

Remarque

Vous devez utiliser la version 1.3 ou ultérieure du schéma de manifeste de l’agent déclaratif pour ajouter la source de People connaissances.

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

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, 1:1 ou des conversations de réunion pour étendre la recherche Copilot, ou vous pouvez autoriser votre agent à utiliser tout 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 Copilot Studio générateur d’agents pour créer votre agent, sous l’onglet Configurer, dans la section Connaissances, sélectionnez la barre de recherche et choisissez Mes conversations Teams parmi les groupes, les canaux et les réunions. 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.

Remarque

Vous devez utiliser la version 1.3 ou ultérieure du schéma de manifeste de l’agent déclaratif pour ajouter la source de TeamsMessage connaissances.

{
  "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.