Présentation du SDK Microsoft Agent 365

Le SDK Microsoft Agent 365 connecte un agent que vous possédez déjà et l’exécute à Microsoft Agent 365. Utilisez-le lorsque votre agent a besoin d’un accès au niveau du code aux capacités d’Agent 365 telles que l’identité de l’agent, l’observabilité, les outils Work IQ régulé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. Ajoutez le SDK lorsque l’agent a besoin de capacités que le chemin de la plateforme ne fournit pas et que vous devez configurer en code, comme l’observabilité ou les outils Work IQ. Les intégrations de plateformes évoluent, donc vérifiez les recommandations actuelles de la plateforme avant de décider que le SDK est nécessaire. Voir Choisir l’option d’intégration.

Ce que le SDK ajoute

Le SDK offre quatre capacités :

Capability 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 locataires participant au programme de prévisualisation Frontier.
Observabilité Émettre de la télémétrie via OpenTelemetry, produisant des interactions auditées et traçables, des événements d’inférence et une utilisation d’outils.
Outillage Invoke a régi les serveurs du protocole de contexte du modèle Work IQ (MCP) pour atteindre les charges de travail Microsoft 365 telles que Mail, Calendar, Word, SharePoint et Teams sous contrôle 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.

Choisissez les capacités qui correspondent aux exigences de votre agent plutôt que d’adopter toute la surface 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 d’agent, tandis que l’observabilité peut utiliser soit le blueprint d’identité de l’agent, soit une inscription standard à l’application Microsoft Entra.

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.

Comparer le SDK Microsoft Agent 365 et le Microsoft 365 Agents SDK

Le SDK Microsoft Agent 365 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
Ça ne crée pas d’agents.
Étend un agent déjà existant pour ajouter l’identité, l’observabilité, les outils et les notifications.		 Un cadre pour construire des agents conversationnels.
S’occupe de la diffusion des messages sur des canaux tels que Teams et Microsoft 365 Copilot, et gère l’état des conversations.

Ces deux SDK fonctionnent ensemble, vous pouvez donc construire un agent avec le Microsoft 365 Agents SDK puis utiliser le SDK Agent 365 pour lui donner une identité, une observabilité, des outils et des notifications.

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.
Cadre 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 orchestre les étapes, ni n’exécute 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, n’héberge, ne déploie pas, n’orchestre pas ou n’exécute pas l’agent.

Note

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

Le flux d’intégration

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

Stage Description
1. Inscription Créez le blueprint d’identité de l’agent et l’identité de l’agent dans Microsoft Entra.
2. Prolonger Ajoutez les fonctionnalités dont votre agent a besoin, telles que l’observabilité, les outils Work IQ ou les notifications.
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. Fonctionnement Utilisez les contrôles de l’Agent 365 pour gouverner 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 compétences 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 de votre agent dans un commentaire Word :

  1. Les notifications transmettent la 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 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.

Les paquets SDK Agent 365 pour Python sont 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 Composants de télémétrie, de suivi et de supervision pour les assistants IA basés 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.
microsoft-agents-a365-observability-extensions-agent-framework Extensions de l’observabilité pour Microsoft Agent Framework. Fournit une intégration de suivi OpenTelemetry spécifiquement pour les applications utilisant Agent Framework.
microsoft-agents-a365-observability-extensions-openai Extensions d’observabilité pour le kit de développement logiciel (SDK) des assistants OpenAI. 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.
microsoft-agents-a365-observability-extensions-langchain Extensions d’observabilité pour l’infrastructure 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.
microsoft-agents-a365-observability-extensions-semantic-kernel Extensions d’observabilité pour Noyau sémantique framework. 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.
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

  • Last updated on