Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Vous pouvez avoir des agents dans votre organization que vous avez créés à l’aide de C#, JavaScript ou Python, et qui sont hébergés sur Azure ou une autre infrastructure d’hébergement. Ces agents sont des expériences spécialisées qui peuvent être axées sur un domaine spécifique utilisent des services d’IA et sont déjà intégrés à des applications web ou personnalisées. Vous pouvez utiliser microsoft 365 Agents Toolkit pour exposer votre agent dans Microsoft 365 Copilot Chat. Cela permet aux utilisateurs d’utiliser l’interface utilisateur Microsoft 365 Copilot unifiée pour travailler avec les agents créés dans l’entreprise, ce qui rend vos agents plus détectables et accessibles aux utilisateurs.
Utiliser le Microsoft 365 Agents SDK
Pour intégrer votre agent à Microsoft 365 Copilot, utilisez microsoft 365 Agents Toolkit pour intégrer l’agent à l’Microsoft 365 Agents SDK. Le Kit de développement logiciel (SDK) Agents prend en charge C#, JavaScript et Python. Si votre agent est écrit dans l’un de ces langages, vous n’avez pas à le modifier de manière significative. Vous pouvez simplement ajouter le code du Kit de développement logiciel (SDK) Agents à votre agent et utiliser les adaptateurs de canal intégrés pour déployer votre agent sur Microsoft 365 Copilot.
Les adaptateurs de canal intégrés dans le Microsoft 365 Agents SDK prennent en charge un certain nombre de canaux, y compris les Microsoft 365 Copilot. En encapsulant votre agent existant avec le Kit de développement logiciel (SDK) Agents, vous pouvez l’intégrer à l’Bot Service Azure qui se trouve entre une surface utilisateur ou un canal (par exemple, Microsoft 365 Copilot) et votre code. Le Bot Service Azure traduit ce que ce canal envoie et le transforme en activités courantes pour correspondre à ce que votre code comprend : dans ce cas, le wrapper du Kit de développement logiciel (SDK) Agents qui accepte les messages entrants d’Azure Bot Service.
Modifier les composants de votre agent
Pour intégrer votre agent dans Copilot, vous devez modifier certains composants de votre agent, comme décrit dans cette section.
Nous vous recommandons de commencer avec microsoft 365 Agents Toolkit et d’utiliser l’exemple Echo/Empty Agent (actuellement disponible en C# dans Visual Studio et JavaScript dans Visual Studio Code). Pour vous familiariser avec la structure du Kit de développement logiciel (SDK) Agents, suivez les étapes de test et de déploiement de votre agent à l’aide du Kit de ressources Agents et du Kit de développement logiciel (SDK) ; ces outils simplifient les tâches décrites.
Créer l’inscription de votre application et l’enregistrement Azure Bot Service pour gérer la communication des canaux : le Microsoft 365 Agents SDK utilise Azure Bot Service pour gérer la communication entre les canaux et votre code, en gérant les composants associés à ces canaux. Vous devez créer une ressource Azure Bot Service avec une inscription d’application que vous référencez manuellement dans votre agent.
Configurer vos écouteurs d’événements d’agent : un agent créé avec le Microsoft 365 Agents SDK est structuré pour écouter les événements à partir du canal , dans ce cas, Microsoft 365 Copilot. Pour commencer, utilisez OnActivity. Pour des événements spécifiques, consultez TurnContext et ActivityHandler.
Mettez à jour la structure de votre agent pour qu’il puisse gérer l’activité envoyée par Microsoft 365 Copilot à l’Bot Service Azure. Pour ce faire, ajoutez l’agent existant à la structure d’un agent créé avec Microsoft 365 Agents SDK. Vous n’avez pas besoin d’appeler spécifiquement beaucoup d’activités ; un agent peut écouter n’importe quel message du client à l’aide de la méthode OnActivity. L’agent existant peut ensuite être ajouté ou référencé dans la méthode déclenchée à partir de l’événement qui est écouté, et donc s’exécuter chaque fois qu’une activité est envoyée. Une activité peut être un message ou un autre type d’action dans le canal. Pour plus d’informations sur les événements, consultez la documentation de référence.
Créez manuellement ou générez un fichier manifeste à l’aide du Kit de ressources Agents. Microsoft 365 Copilot nécessite un package .zip qui contient un fichier manifeste. Le fichier manifeste comprend un ensemble d’instructions pour indiquer à Microsoft 365 Copilot où rechercher votre agent, ainsi que d’autres informations. Microsoft 365 Copilot nécessite qu’un agent soit hébergé et qu’un point de terminaison soit lié via une inscription d’application (ID) et référencé dans un fichier manifeste. Si votre agent s’exécute dans Teams, vous pouvez modifier le fichier manifeste existant pour prendre en charge le schéma le plus récent pour Microsoft 365 Copilot.
Les agents connectés à Microsoft 365 Copilot peuvent éventuellement demander à l’utilisateur l’autorisation d’agir en leur nom. Si vous choisissez d’utiliser cette fonctionnalité, configurez-la pendant le processus de configuration de l’agent dans Azure Bot Service. Outils de prise en main
L’effort nécessaire pour intégrer votre agent dans Copilot varie en fonction de la complexité de l’agent et de la nécessité ou non d’ajouter une gestion des jetons pour permettre à votre agent d’utiliser l’identité de l’utilisateur pour étendre ses connaissances.
Pour commencer, utilisez microsoft 365 Agents Toolkit et l’exemple Echo Agent pour créer votre agent et suivez la documentation de Visual Studio ou Visual Studio Code pour le tester et le déployer. Cela vous aidera à vous familiariser avec la boîte à outils Agents, le Kit de développement logiciel (SDK) Agents et Microsoft 365 Copilot fonctionnent ensemble.