Compétences Agent 365 pour la mise en place d’un agent guidé

Les compétences de l’Agent 365 fournissent un chemin de configuration guidé pour connecter un agent existant à l’Agent 365 depuis un assistant de codage pris en charge. Vous indiquez le résultat souhaité, comme ajouter de l’observabilité à cet agent, et la compétence identifie le projet, collecte les valeurs requises, effectue les modifications d’intégration et vérifie le résultat.

Les compétences s’exécutent dans tous les agents de codage, y compris Claude Code, GitHub Copilot CLI et le mode agent VS Code.

Pour installer les compétences et suivre le parcours d’intégration de votre agent, consultez Quickstart : Connecter un agent existant à Agent 365.

Note

Les compétences remplacent le flux de travail de configuration précédent qui utilisait un instructions.md fichier.

Quand utiliser les compétences

Connecter un agent existant à l’identité d’entreprise, à l’observabilité, aux outils gouvernés et aux notifications nécessite plusieurs étapes de configuration ordonnées. Ces étapes incluent l’installation de la CLI Agent 365, la validation des prérequis Azure, l’enregistrement d’un blueprint, la configuration des ressources Entra, le câblage des exportateurs OpenTelemetry, la connexion des serveurs Model Context Protocol (MCP) et les tests locaux.

Les compétences effectuent ces étapes dans l’ordre requis pour le chemin sélectionné et valident le projet résultant.

Comment fonctionne une compétence

Chaque compétence suit le même flux de travail :

  1. Énoncez le résultat que vous souhaitez.
  2. Permettez à la compétence d’identifier la stack du projet et la configuration existante.
  3. Fournissez les valeurs qu’il demande, comme le mode d’authentification.
  4. Examinez le code, le manifeste et les modifications de configuration qu’il effectue.
  5. Confirmez que le projet continue de se construire et que l’intégration fonctionne.

Compétences disponibles pour Agent 365

a365-setup est le point d’entrée. Après avoir validé les prérequis, il vous oriente vers l’un des deux chemins, et vous ne suivez que ce chemin :

  • Agent standard. a365-setup délègue à make-a365-agent. Utilisez ce chemin lorsque l’agent n’a pas besoin de son propre compte utilisateur. Un agent standard s’authentifie avec OBO ou S2S, ce qui lui permet d’agir pour un utilisateur connecté ou de fonctionner sans un utilisateur.
  • Équipier IA. a365-setup délègue à make-ai-teammate, pour un agent qui a besoin de son propre compte utilisateur. Un coéquipier IA s’authentifie à l’aide de ce compte d’utilisateur (Agentic-User). Ce chemin nécessite le programme de prévisualisation Frontier.

Pour choisir un chemin et un mode d’authentification, voir Types d’agents et modes d’authentification.

Skill Purpose
a365-setup Installe la CLI de l’Agent 365, valide les prérequis Azure et détecte la pile d’agents. Pour un agent standard, demande si l’agent s’authentifie avec OBO ou S2S. Puis il délègue à make-a365-agent ou make-ai-teammate.
make-a365-agent Fournit un agent standard qui n’a pas besoin de son propre compte utilisateur. Enregistre le blueprint d’identité d’agent dans Microsoft Entra, crée un identité d’agent à partir de celui-ci, et configure les permissions d’Entra ID dont l’agent a besoin : permissions déléguées pour l’OBO ou permissions d’application pour S2S. Il propose ensuite des fonctionnalités d’observabilité et des outils complémentaires.
make-ai-teammate Transforme un agent en coéquipier IA avec son propre compte utilisateur. Enregistre le blueprint d’identité d’agent et crée un identité d’agent à partir de celui-ci, puis ajoute la couche d’hébergement, le routage des messages et les notifications. Nécessite d’avoir d’abord exécuté a365-setup.
instrument-observability Configure OpenTelemetry et l’exportateur de traces Agent 365 afin que les segments de trace des assistants soient transmis à Microsoft Defender, Microsoft Purview et au Centre d’administration Microsoft 365. Prend en charge OBO, S2S et Agentic-User. Il demande le type d’agent et le mode d’authentification si a365-setup ne les a pas déjà enregistrés.
a365-code-validator Valide et diagnostique une intégration existante avec Agent 365, incluant l’instrumentation, les artefacts Microsoft Entra, la messagerie, l’accès aux outils et la configuration associée. En lecture seule par défaut. Utilisez instrument-observability pour ajouter de l’observabilité à partir de zéro.
add-workiq-tools Relie les serveurs MCP de Work IQ, y compris Mail, Calendar et Word, afin que l’agent puisse lire et agir sur les données Microsoft 365. Nécessite un modèle de permissions déléguées, et est automatiquement sauté lorsque le mode d’authentification est S2S.
purview-dlp-integration Ajoute des vérifications de prévention de la perte de données (DLP) Microsoft Purview avant les appels LLM de l'agent en utilisant Microsoft GraphprocessContent, avec un audit de réponse optionnel. Guide la configuration des autorisations Graph et des stratégies de protection contre la perte de données (DLP).
test-local Exécute localement un agent IA coéquipier et ouvre Agents Playground pour des tests interactifs, sans besoin de déploiement cloud. S’applique au parcours du coéquipier IA.

Important

make-ai-teammate Donne à votre agent son propre compte utilisateur, incluant une boîte aux lettres et une présence Teams. Cette fonctionnalité est disponible uniquement pour les locataires participant au programme de prévisualisation Frontier.

En général, on invoque une compétence en énonçant le résultat plutôt qu’en nommant la compétence. Par exemple, ajouter de l’observabilité à cet agent exécute instrument-observability. Si votre assistant de codage expose la capacité interne a365-code-validator , demandez-lui de valider cette intégration Agent 365 ; la capacité est également décrite en interne comme Valider & Diagnostiquer. La disponibilité et l’invocation dépendent de l’assistant et du package de compétences installé. Pour la formulation de la requête utilisée à chaque étape, voir Démarrage rapide : Connecter un agent existant à l’Agent 365.

Types d’agents et modes d’authentification

Les compétences permettent de configurer aussi bien des assistants standard que des coéquipiers IA. Le chemin détermine quels modes d’authentification sont disponibles pour l’agent. Le mode d’authentification, appelé mode exécution dans Identité de l’assistant, détermine l’identité sous laquelle l’assistant agit lorsqu’il appelle des services en aval, tels que Microsoft Graph et les serveurs MCP.

Mode d'authentification Path L’agent sert de Utilisez-le quand
OBO (au nom de) Assistant standard L’utilisateur connecté, avec des permissions déléguées L’agent fonctionne dans le contexte de l’utilisateur, par exemple en lisant le calendrier de cet utilisateur ou en envoyant un e-mail pour lui.
S2S (de service à service) Assistant standard Sa propre identité d’agent, avec des permissions d’application L’agent s’exécute sans utilisateur connecté, comme pour les tâches planifiées, la surveillance ou le traitement en arrière-plan.
Agentic-User Coéquipier d’IA Son propre compte utilisateur L’agent a besoin de sa propre boîte aux lettres, de sa présence Teams ou d’autres expériences Microsoft 365 basées sur les utilisateurs. Nécessite de participer au programme Frontier en version préliminaire.

Pour un assistant standard, a365-setup vous demande si l’assistant utilise le mode OBO ou S2S, et les compétences suivantes réutilisent votre réponse. Un coéquipier IA utilise toujours le mode Agentic-User,. Par conséquent, a365-setup ne pose pas cette question. Les compétences configurent un seul mode pour chaque assistant. Si l’agent a besoin à la fois de permissions déléguées et d’application, exécutez a365 setup all --authmode both avec la CLI Agent 365. Pour les rôles requis par chaque mode, voir Autorisations d’identité de l’agent.

Le mode d’authentification détermine les éléments configurés par les compétences :

  • make-a365-agent s’exécute a365 setup all avec --authmode obo ou --authmode s2s. L’OBO accorde des permissions déléguées à l’identité de l’agent, et S2S lui attribue des permissions d’application.
  • instrument-observability exporte la télémétrie via la route S2S avec un token uniquement applicatif dans chaque mode, donc une instance d’agent enregistré n’a pas besoin d’une autorisation d’observabilité ni d’un consentement administrateur. Pour OBO et Agentic-User, la compétence configure l’agent pour obtenir ce jeton en réutilisant les identifiants blueprint de sa connexion d’hébergement. Pour le S2S, il ajoute un service de jetons qui acquiert et rafraîchit le jeton pour les agents .NET, Node.js et Python. Vir Activé par Agent 365 utilisant le flux S2S.
  • add-workiq-tools nécessite un jeton utilisateur délégué, donc il fonctionne avec OBO et Agentic-User mais pas avec S2S. Si vous choisissez S2S, a365-setup supprime Work IQ des capacités que vous avez sélectionnées.
  • purview-dlp-integration prend en charge l’authentification déléguée agentique. Pour S2S, il prend uniquement en charge les assistants Node.js qui utilisent l’authentification par identité managée fédérée (FMI) avec une clé secrète client.
  • test-local s’applique uniquement aux coéquipiers IA.

Piles prises en charge

Les compétences détectent automatiquement la pile de projets, donc vous n’avez pas besoin de cartographier votre projet manuellement. Voici les piles technologiques détectées par les compétences. Le SDK fonctionne également avec d’autres frameworks.

Language Frameworks
.NET Microsoft Agent Framework, Noyau sémantique, Azure AI Foundry
Node.js LangChain, SDK OpenAI Agents, SDK Claude Agent, Noyau sémantique, Google ADK
Python Microsoft Agent Framework, LangChain, OpenAI Agents SDK, Claude Agent SDK, Noyau sémantique, Google ADK

Sécurité et répétabilité

Les compétences sont conçues pour appliquer des changements de configuration sans modifier le comportement existant de votre projet. Confirmez ce comportement avec la liste de vérification de validation du SDK Agent 365.

  • Additif et idempotent. Les compétences ne suppriment pas ni ne restructurent le code existant, et relancer une compétence ne duplique pas le travail terminé.
  • Tenant compte de l’état. Les compétences détectent ce qui est déjà configuré et passent donc les étapes déjà terminées au lieu de les répéter.
  • Gardé par une rambarde. Les compétences ne modifient pas les fichiers situés en dehors de votre projet et vérifient que la génération réussit toujours avant de terminer.

Utilisez des compétences lorsque :

  • Vous avez un agent existant et vous souhaitez l’ajouter sans coder l’intégration manuellement.
  • Votre flux de travail de développement inclut déjà un assistant de codage.
  • Vous voulez une intégration cohérente et reproductible entre les projets.

Utilisez la configuration manuelle lorsque :

  • Votre environnement est non standard et chaque étape nécessite un contrôle individuel.
  • Votre organisation limite les flux de travail des assistants de coding.
  • Vous effectuez un dépannage et souhaitez exécuter vous-même chaque étape.

Pour le chemin manuel, utilisez les étapes de configuration dans Démarrage rapide : connectez un agent existant à l’Agent 365, et exécutez les commandes CLI équivalentes de l’Agent 365 pour votre environnement.

Contenu connexe

  • Dernière mise à jour :