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.
La compétence de génération Microsoft Agent Framework pour .NET, agent-framework-builder-dotnetfournit aux agents de codage compatibles des conseils maintenus par Microsoft pour créer des solutions Agent Framework .NET (C#).
Il aide l’agent de programmation à choisir un schéma approprié et à charger progressivement des conseils axés sur la tâche.
La compétence peut guider le travail avec :
- Agents simples, fournisseurs de modèles, outils, sessions, historique, fournisseurs de contexte et intergiciels.
- Exploitez les agents avec des todos, modes, mémoire, approbations, compétences, agents d’arrière-plan, outils d’interpréteur de commandes, compactage et boucles.
- Flux de travail et orchestrations intégrées et définitions déclaratives.
- Évaluation, observabilité, clients personnalisés, agents personnalisés et intégrations.
- Hébergement et déploiement.
La compétence fournit des conseils de développement à un agent de codage externe. Il ne s’agit pas d’un package NuGet et ne s’exécute pas dans votre application Agent Framework.
Important
Cette compétence d’agent de codage diffère des runtime Agent Skills. Les compétences d’exécution sont chargées par un agent Agent Framework pendant l’exécution de votre application. La compétence Builder permet à un agent de codage de créer ou de modifier le code source de votre application.
Tip
Associez la compétence Builder au serveur Microsoft Learn MCP. La compétence fournit à l’agent de codage des conseils ciblés sur le flux de travail et l’implémentation de l’Agent Framework, tandis que le serveur Learn MCP lui permet de rechercher dans la documentation Microsoft actuelle, d’extraire des articles complets et de trouver des exemples de code pendant la tâche. Configurez ce point de terminaison HTTP streamable non authentifié public dans un agent de codage compatible :
https://learn.microsoft.com/api/mcp
Prerequisites
- Agent de codage qui prend en charge la spécification open Agent Skills.
-
GitHub CLI avec les commandes d’aperçu
gh skill, ou Node.js 22.20 ou version ultérieure si vous utilisez la CLI cross-agentskills. - Kit de développement logiciel (SDK) .NET actuellement pris en charge pour les nouvelles applications Agent Framework.
La gestion des compétences GitHub CLI est en préversion et susceptible de changer.
Examiner et installer avec GitHub CLI
La compétence .NET builder n'est pas encore dans une version balisée, vous devez donc spécifier la référence @main ref. Utilisez la version préliminaire de la compétence avant de l'installer :
gh skill preview microsoft/agent-framework agent-framework-builder-dotnet@main
Installez la skill :
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main
L’installation par défaut est limitée au projet et cible GitHub Copilot en utilisation non interactive. Sélectionnez une autre portée utilisateur ou de l’agent de codage prise en charge si nécessaire :
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
--agent claude-code \
--scope user
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
--agent cursor
gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
--agent codex
Pour connaître les options de client et de portée actuelles, consultez gh skill install.
Installer avec l’interface CLI cross-agent skills
En guise d’alternative, installez le skill avec l’interface CLI inter-agent skills :
npx skills add microsoft/agent-framework --skill agent-framework-builder-dotnet
Passez en revue les agents de codage pris en charge par l’interface CLI et les exigences d’exécution avant l’installation.
Utiliser la compétence
Invitez naturellement l’agent de programmation. Les clients compatibles découvrent et activent la skill à partir de ses métadonnées ; ne supposez pas de commande slash universelle.
Exemples de prompts :
Build a .NET Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.Add approval-required tools and persistent conversation history to this Agent Framework application.Convert this multi-agent design into an Agent Framework workflow and add checkpointing.Create a harness agent with todos, file access, and safe shell tooling.Review this .NET Agent Framework application for current APIs and package requirements.Prepare this Agent Framework agent for hosting in ASP.NET Core and add an evaluation plan.
Incluez des contraintes telles que le fournisseur de modèles, la cible d’hébergement, les exigences de persistance, la limite de sécurité et la version .NET cible lorsque vous les connaissez.
Ce que l’agent de programmation doit faire
Le skill demande à un agent de codage de :
- Inspectez la solution existante, notamment les frameworks cibles, la version du SDK, la gestion des packages et les packages installés
Microsoft.Agents.AI.*. - Choisissez le pattern le plus simple adapté, tel qu’un agent simple, un harness, un workflow, une orchestration ou une définition déclarative.
- Chargez uniquement les références sélectionnées pertinentes.
- Ajoutez uniquement les packages strictement nécessaires dont l’application a besoin et vérifiez la maturité de chaque package avant d’en dépendre, car certains packages sont en préversion.
- Lisez les points de terminaison, les modèles et les clés à partir de la configuration, et préférez les informations d’identification de jeton par rapport aux clés API codées en dur.
- Validez l’application générée avec les tests existants et les exemples exécutables du référentiel.
La compétence ne garantit pas que le code généré est prêt pour la production. Passez en revue le plan de l’agent de codage, les choix de package, les limites de sécurité, les commandes et les modifications générées avant l’approbation.
Gestion des versions et confiance
La compétence est une compétence publique, installable, grand public gérée par Microsoft. Sa version des métadonnées de la compétence est 0.1.
- Utilisez la
@mainref jusqu’à ce qu’une version taguée inclue la compétence. - Afficher un aperçu du contenu des skills avant l’installation et passer en revue les mises à jour avant d’approuver de nouveaux scripts ou instructions.
Pour connaître les références source et ciblées, consultez :
- Source de compétence Builder
- Catalogue de compétences d’Agent Framework
- Pull request de Builder skill
Étapes suivantes
Aller plus loin :
La compétence de génération Microsoft Agent Framework pour Python, agent-framework-builder-python, fournit aux agents de codage compatibles des conseils maintenus par Microsoft pour créer des solutions Python Agent Framework.
Il aide l’agent de programmation à choisir un schéma approprié et à charger progressivement des conseils axés sur la tâche.
La compétence peut guider le travail avec :
- Agents simples, fournisseurs de modèles, outils, approbations, sessions, historiques et fournisseurs de contexte.
- Exploitez les agents avec planification, todos, mémoire, compactage, fichiers, agents d’arrière-plan, outils shell et boucles.
- Flux de travail fonctionnels et graphiques, orchestrations intégrées et définitions déclaratives.
- Évaluation, observabilité, intergiciel, clients personnalisés, agents personnalisés et intégrations.
- Auto-hébergement et développement avec l’agent hébergé de Microsoft Foundry.
La compétence est uniquement disponible en Python. Il fournit des conseils de développement à un agent de codage externe ; il n'est pas un package Python, n'est pas installé par pip install agent-framework, et ne s'exécute pas à l'intérieur de votre application Agent Framework.
Important
Cette compétence d’agent de codage diffère des runtime Agent Skills. Les compétences d’exécution sont chargées par un agent Agent Framework pendant l’exécution de votre application. La compétence Builder permet à un agent de codage de créer ou de modifier le code source de votre application.
Tip
Associez la compétence Builder au serveur Microsoft Learn MCP. La compétence fournit à l’agent de codage des conseils ciblés sur le flux de travail et l’implémentation de l’Agent Framework, tandis que le serveur Learn MCP lui permet de rechercher dans la documentation Microsoft actuelle, d’extraire des articles complets et de trouver des exemples de code pendant la tâche. Configurez ce point de terminaison HTTP streamable non authentifié public dans un agent de codage compatible :
https://learn.microsoft.com/api/mcp
Prerequisites
- Agent de codage qui prend en charge la spécification open Agent Skills.
-
GitHub CLI avec les commandes d’aperçu
gh skill, ou Node.js 22.20 ou version ultérieure si vous utilisez la CLI cross-agentskills. - Python 3.11 ou version ultérieure pour les nouvelles applications Agent Framework. Agent Framework 1.23 prend toujours en charge Python 3.10, mais Python 3.10 a atteint la fin de vie en amont.
La gestion des compétences GitHub CLI est en préversion et susceptible de changer.
Examiner et installer avec GitHub CLI
Affichez un aperçu de la compétence publiée avant de l’installer :
gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0
Installez la dernière version étiquetée :
gh skill install microsoft/agent-framework agent-framework-builder-python
Épinglez la version Python 1.23 lorsque vous avez besoin d’instructions reproductibles :
gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0
L’installation par défaut est limitée au projet et cible GitHub Copilot en utilisation non interactive. Sélectionnez une autre portée utilisateur ou de l’agent de codage prise en charge si nécessaire :
gh skill install microsoft/agent-framework agent-framework-builder-python \
--agent claude-code \
--scope user
gh skill install microsoft/agent-framework agent-framework-builder-python \
--agent cursor
gh skill install microsoft/agent-framework agent-framework-builder-python \
--agent codex
Pour connaître les options de client et de portée actuelles, consultez gh skill install.
Installer avec l’interface CLI cross-agent skills
En guise d’alternative, installez le skill avec l’interface CLI inter-agent skills :
npx skills add microsoft/agent-framework --skill agent-framework-builder-python
Passez en revue les agents de codage pris en charge par l’interface CLI et les exigences d’exécution avant l’installation.
Utiliser la compétence
Invitez naturellement l’agent de programmation. Les clients compatibles découvrent et activent la skill à partir de ses métadonnées ; ne supposez pas de commande slash universelle.
Exemples de prompts :
Build a Python Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.Add approval-required tools and persistent conversation history to this Agent Framework application.Convert this multi-agent design into an Agent Framework workflow and add checkpointing.Create a harness agent with planning, todos, file access, and safe shell tooling.Review this Python Agent Framework application for current APIs and package requirements.Prepare this Agent Framework agent for Foundry hosting and add an evaluation plan.
Incluez des contraintes telles que le fournisseur de modèles, la cible d’hébergement, les exigences de persistance, le périmètre de sécurité et la version de Python prise en charge lorsque vous les connaissez.
Ce que l’agent de programmation doit faire
Le skill demande à un agent de codage de :
- Choisissez le pattern le plus simple adapté, tel qu’un agent simple, un harness, un workflow, une orchestration ou une définition déclarative.
- Chargez uniquement les références sélectionnées pertinentes.
- Préférez les recommandations actuelles de Microsoft Learn, les références d’API publiques, les informations de cycle de vie des packages et les exemples maintenus pour les détails susceptibles d’évoluer.
- Installez des ensembles de packages étroits plutôt que de supposer que chaque intégration est stable ou requise.
- Conservez des limites explicites de session, d’approbation, d’authentification et d’hébergement.
- Validez l’application générée avec les tests existants du référentiel, les vérifications de type et les exemples exécutables.
La compétence ne garantit pas que le code généré est prêt pour la production. Passez en revue le plan de l’agent de codage, les choix de package, les limites de sécurité, les commandes et les modifications générées avant l’approbation.
Gestion des versions et confiance
La compétence est une compétence publique, installable, grand public maintenue par Microsoft, publiée sous la balise de dépôt python-1.23.0. Sa version des métadonnées de la compétence est 0.3.
- Utilisez la commande install non qualifiée pour la dernière version étiquetée.
- Épinglez
@python-1.23.0lorsque la reproductibilité est importante. - Utilisez
@mainuniquement lorsque vous souhaitez intentionnellement des instructions non publiées. - Afficher un aperçu du contenu des skills avant l’installation et passer en revue les mises à jour avant d’approuver de nouveaux scripts ou instructions.
Pour connaître les références source et ciblées, consultez :
- Compétence de création publiée
- Catalogue de compétences d’Agent Framework
- Pull request de Builder skill
Étapes suivantes
Aller plus loin :
Note
Une compétence Microsoft Agent Framework Builder pour Go n'est pas encore disponible. Utilisez le didacticiel De prise en main Go et les exemples Go d’Agent Framework pour obtenir des conseils actuels.