Présentation du SDK Microsoft Agent 365

Le SDK Microsoft Agent 365 connecte un agent que vous possédez déjà et exécutez déjà à Microsoft Agent 365. Utilisez-le pour accéder au niveau du code à des fonctionnalités telles que l’identité de l’agent, les outils Work IQ gouvernés ou les notifications.

Où s’insère le SDK

Le modèle d’intégration montre la frontière entre les intégrations intégrées, la synchronisation du registre et les scénarios Agent 365 SDK intégrés par les développeurs.

Diagramme du modèle d’intégration de l’Agent 365 montrant où s’insère le SDK de l’Agent 365.

Les agents sur les plateformes avec une intégration intégrée à l’Agent 365, ainsi que les agents importés via la synchronisation du registre, peuvent déjà apparaître dans l’inventaire de l’Agent 365. Les intégrations SDK peuvent fournir des fonctionnalités que la voie plateforme ne fournit pas, telles que les outils ou notifications Work IQ. Les intégrations de plateformes évoluent, alors vérifiez les directives actuelles avant de modifier une intégration. Voir Choisir l’option d’intégration.

Comment les capacités de l’Agent 365 s’articulent ensemble

L’intégration développeur Agent 365 offre quatre fonctionnalités. Le SDK Agent 365 fournit l’identité, les outils et les notifications. Microsoft OpenTelemetry offre une observabilité :

Capacité Description
Identity Utilisez une identité d’agent soutenue par Microsoft Entra pour une authentification sécurisée et un accès contrôlé aux outils et aux données. Les agents ayant besoin de leur propre compte utilisateur et de leur boîte aux lettres sont disponibles uniquement pour les organisations participant au programme de préversion Frontier.
Observabilité Utilisez la Microsoft OpenTelemetry Distro distincte pour émettre une télémétrie qui produit des interactions auditées et traçables, des événements d’inférence et une utilisation d’outils.
Outillage Invoquez des serveurs du protocole de contexte de modèle (MCP) Work IQ gouvernés par Invoke pour accéder à des services Microsoft 365 tels que Mail, Calendar, Word, SharePoint et Teams, sous le contrôle de l’administrateur.
Notifications Recevez et répondez aux messages de Teams, Outlook, commentaires Word et e-mail, comme un participant humain dans les applications Microsoft 365. Cette fonctionnalité nécessite un compte utilisateur d’agent et est disponible uniquement pour les locataires participant au programme de prévisualisation Frontier.

Important

N’utilisez pas le SDK d’observabilité Agent 365 obsolète pour les nouvelles intégrations d’observabilité. Utilisez le Microsoft OpenTelemetry Distro. Continuez à utiliser les packages SDK Agent 365 pour l’identité, les outils et les notifications.

Choisissez les capacités qui correspondent aux exigences de votre agent plutôt que d’adopter l’ensemble du SDK. L’identité, les outils et les notifications utilisent un blueprint d’identité d’agent comme base Entra. Les notifications nécessitent également un compte utilisateur agent. Microsoft OpenTelemetry peut utiliser soit l’agent identity blueprint, soit une inscription d’application Microsoft Entra standard.

Le SDK est livré dans des packages spécifiques à chaque langage pour Python, JavaScript et .NET. Installez le(s) paquet(s) pour les fonctionnalités que vous sélectionnez, puis configurez l’identité, les permissions et l’intégration à l’exécution correspondants. Pour les packages disponibles, voir packages SDK Agent 365. Installez Microsoft OpenTelemetry séparément pour de nouvelles intégrations d’observabilité.

Comparer Microsoft Agent 365 SDK et Microsoft 365 Agents SDK

Microsoft Agent 365 SDK et le Microsoft 365 Agents SDK sont des produits différents.

Microsoft Agent 365 SDK (Ce SDK) Kit de développement logiciel (SDK) Microsoft 365 Agents
Ne génère pas les agents de build.
Étend un agent déjà existant pour ajouter l’identité, les outils et les notifications. Utilisez Microsoft OpenTelemetry pour ajouter de l’observabilité.		 Un cadre pour construire des agents conversationnels.
S’occupe de la transmission des messages sur des canaux tels que Teams et Microsoft Copilot, et gère l’état des conversations.

Ces SDK fonctionnent ensemble. Vous pouvez créer un agent avec le Microsoft 365 Agents SDK, utiliser le SDK Agent 365 pour l’identité, les outils et les notifications, et utiliser Microsoft OpenTelemetry pour l’observabilité.

Ce que c’est et ce que ce n’est pas

Vous continuez à posséder les trois couches qui font fonctionner l’agent :

Couche Description
Modèle Le modèle de langage ou le moteur de raisonnement que votre agent appelle. Le SDK n’appelle ni ne sélectionne les modèles.
Framework ou runtime LangChain, Microsoft Agent Framework, Noyau sémantique, le SDK OpenAI Agents, le SDK Claude Agent, ou du code personnalisé. Le SDK ne construit pas d’agents, ne planifie ni n’orchestre les étapes, ni n’exécute pas d’outils.
Host Partout où l’agent opère aujourd’hui, comme Azure, AWS, Google Cloud ou sur site. Le SDK n’héberge ni ne déploie votre agent.

Le SDK Microsoft Agent 365 fonctionne parallèlement à ces couches. Il ne construit pas, n’héberge pas, ne déploie pas, n’orchestre pas et n’exécute pas l’agent.

Note

Le SDK Microsoft Agent 365 enregistre les serveurs MCP gérés afin que votre agent puisse accéder aux charges de travail Microsoft 365, mais votre runtime exécute toujours les appels d’outils.

Le parcours d’accueil

L’intégration se déroule en quatre étapes :

Étape Description
1. Inscription Créez le blueprint d’identité de l’agent et l’identité de l’agent dans Microsoft Entra.
2. Étendre Ajoutez les capacités dont votre agent a besoin. Utilisez le SDK Agent 365 pour les outils ou notifications Work IQ, et utilisez Microsoft OpenTelemetry pour l’observabilité.
3. Valider Exécutez l’agent comme avant et confirmez son identité, sa télémétrie, son accès aux outils et sa gestion des messages.
4. Utilisez Utilisez les contrôles de l’Agent 365 pour gérer et auditer l’agent connecté.

Vous pouvez effectuer ces étapes manuellement ou utiliser Agent 365 Skills d’un assistant de codage pris en charge. Les skills guident la configuration, effectuent les modifications nécessaires et valident le résultat.

Comment une requête s’enchaîne

Une seule interaction peut utiliser les quatre capacités. Quand quelqu’un @mentions mentionne votre agent dans un commentaire Word :

  1. Les notifications transmettent l’@mention à votre agent.
  2. L’identité et l’authentification déterminent si l’agent agit en tant que lui-même, au nom d’un utilisateur connecté ou via un compte utilisateur d’agent. Le mode sélectionné, les permissions, le consentement et le sujet du jeton définissent quelles données et actions sont disponibles.
  3. Les outils donnent à l’agent un accès contrôlé aux données Microsoft 365 dont il a besoin.
  4. L’observabilité enregistre l’invocation, les appels à l’outil et l’inférence du modèle.

Votre agent répond alors dans le fil de commentaires.

Paquets SDK Agent 365

Trouvez les paquets SDK Agent 365 dans les gestionnaires de paquets des langages pris en charge.

Important

Les packages d’observabilité dans les tableaux suivants sont obsolètes. Ne les utilisez pas pour de nouvelles intégrations. Utilisez la Microsoft OpenTelemetry Distro, ou consultez la documentation obsolète du SDK Agent 365 Observability avant de migrer une intégration existante.

Vous pouvez trouver les packages SDK Agent 365 pour Python sur l’index des paquets Python (PYPI).

Package Description
microsoft-agents-a365-notifications Extensions de notification et de messagerie pour les applications d’assistant IA. Fournit des utilitaires pour gérer les notifications d’agent, les événements de cycle de vie et le routage entre différents canaux et sous-canaux dans les applications Microsoft 365.
microsoft-agents-a365-observability-core Obsolète : composants hérités de télémétrie, traçage et surveillance pour agents IA construits sur OpenTelemetry. Fournit des étendues structurées pour l’appel de l’assistant, l’exécution d’outils et l’inférence LLM avec propagation de contexte et exportateurs enfichables. Utilisez plutôt la distribution Microsoft OpenTelemetry.
microsoft-agents-a365-observability-extensions-agent-framework Déprécié : Extensions d’observabilité héritées pour Microsoft Agent Framework. Fournit une intégration de suivi OpenTelemetry spécifiquement pour les applications utilisant Agent Framework. Utilisez plutôt la distribution Microsoft OpenTelemetry.
microsoft-agents-a365-observability-extensions-openai Obsolète : Extensions d’observabilité héritées pour le SDK OpenAI Agents. Fournit l’intégration du suivi OpenTelemetry pour les applications basées sur OpenAI Agents avec instrumentation automatique pour les flux de travail des agents et les invocations d’outils. Utilisez plutôt la Microsoft OpenTelemetry Distro.
microsoft-agents-a365-observability-extensions-langchain Déprécié: anciennes extensions d’observabilité pour le framework LangChain. Fournit l’intégration de traçage OpenTelemetry pour les applications IA basées sur LangChain avec une instrumentation automatique pour les chaînes, les agents et les outils. Utilisez plutôt la distribution Microsoft OpenTelemetry.
microsoft-agents-a365-observability-extensions-semantic-kernel Obsolète : Extensions d’observabilité héritées pour le framework Noyau sémantique. Fournit l’intégration de la traçabilité OpenTelemetry pour les applications basées sur le Noyau sémantique avec une instrumentation automatique pour les fonctions du noyau, les plugins et les planificateurs. Utilisez plutôt la Microsoft OpenTelemetry Distro.
microsoft-agents-a365-runtime Utilitaires d’exécution de base et gestion de l’environnement pour les applications d’assistant IA. Assure la découverte essentielle de l'API Power Platform, la configuration de l'environnement et la résolution des portées d'authentification.
microsoft-agents-a365-tooling Fonctionnalités de base des outils pour la gestion des serveurs d’outils MCP (Model Context Protocol) dans les applications créées avec le kit de développement logiciel (SDK) Microsoft Agent 365. Fournit la base de la découverte, de l’inscription et de la gestion des serveurs d’outils dans différentes infrastructures IA.
microsoft-agents-a365-tooling-extensions-agentframework Outils et services spécifiques à Agent Framework pour le développement d’assistants IA. Fournit le service d’inscription de l’outil MCP (Model Context Protocol) pour ajouter dynamiquement des serveurs MCP aux assistants Agent Framework.
microsoft-agents-a365-tooling-extensions-openai Outils et services spécifiques au kit de développement logiciel OpenAI Agents pour le développement d’assistants IA. Fournit le service d’inscription de l’outil MCP (Model Context Protocol) pour ajouter dynamiquement des serveurs MCP aux assistants basés sur le kit de développement logiciel (SDK) OpenAI Agents.
microsoft-agents-a365-tooling-extensions-semantickernel Noyau sémantique outils et services spécifiques pour le développement d’agents IA. Fournit le service d’inscription de l’outil MCP (Model Context Protocol) pour ajouter dynamiquement des serveurs MCP à des agents basés sur Noyau sémantique.
microsoft-agents-a365-tooling-extensions-azureaifoundry Azure AI Foundry outils et services spécifiques pour le développement d’agents IA. Fournit le service d’inscription de l’outil MCP (Model Context Protocol) pour ajouter dynamiquement des serveurs MCP à des agents Azure AI Foundry.

Contenu connexe

  • Dernière mise à jour :