Remarque
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.
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 :
- Énoncez le résultat que vous souhaitez.
- Laissez la compétence identifier la pile de projet et la configuration existante.
- Fournissez les valeurs qu’il demande, comme le mode d’authentification.
- Examinez le code, le manifeste et les modifications de configuration qu’il effectue.
- Confirmez que le projet continue de se construire et que l’intégration fonctionne.
Les sept compétences
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-setupdélégués àmake-a365-agent. Utilisez ce chemin lorsque l’agent a besoin d’enregistrement et d’observabilité mais pas de compte utilisateur. -
Coéquipier IA.
a365-setupdélègue àmake-ai-teammate, pour un agent qui a besoin de son propre compte utilisateur. Ce chemin nécessite le programme de prévisualisation Frontier.
| Skill | Purpose |
|---|---|
a365-setup |
Installe la CLI de l’Agent 365, valide les prérequis Azure, détecte la pile d’agents, puis 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é de l’agent dans Microsoft Entra, crée un identité d’agent à partir de celui-ci, et configure les permissions Entra ID dont l’agent a besoin, puis propose l’observabilité et les outils en extensions. |
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. Il faut a365-setup d’abord avoir couru. |
instrument-observability |
Wires OpenTelemetry et l’exportateur de traçage Agent 365 pour que les étendues d’agents atteignent Microsoft Defender, Microsoft Purview et le Microsoft 365 admin center. Demande le type d’agent et le mode d’authentification ; voir Identité de l’agent. |
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. À utiliser instrument-observability pour ajouter de la visibilité à 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. |
test-local |
Exécute localement un agent IA coéquipier et ouvre Agents Playground pour des tests interactifs, sans besoin de déploiement cloud. Cela s’applique au chemin des coéquipiers 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.
Stacks pris en charge
Les compétences détectent automatiquement la pile de projets, donc vous n’avez pas besoin de cartographier votre projet manuellement. Ce sont les stacks que les compétences détectent. Le SDK fonctionne également avec d’autres frameworks.
| Langue | 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é.
- Conscient de l’État. Les compétences détectent ce qui est déjà câblé, donc elles sautent plutôt que de répéter les étapes complétées.
- Gardé par une rambarde. Les compétences ne modifient pas les fichiers en dehors de votre projet, et elles vérifient que la construction passe quand même avant de la terminer.
Utilisez des compétences lorsque :
- Vous avez déjà un agent et vous voulez l’intégrer sans écrire l’intégration à la main.
- 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 êtes en train de dépanner et vous voulez faire chaque étape vous-même.
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.