Utiliser la compétence Microsoft Foundry dans les agents de codage

La compétence Microsoft Foundry fournit aux agents de codage des directives réutilisables pour les flux de travail des agents Foundry. Utilisez-le pour standardiser le déploiement, l’évaluation, l’optimisation des prompts, la constitution de jeux de données à partir des traces et les tâches de dépannage dans les environnements de développement intégrant des agents.

Prerequisites

  • Un compte Azure avec un abonnement actif. Si vous n’en avez pas, créez un compte Azure gratuit.

  • Hôte d’agent de codage, tel que GitHub Copilot dans Visual Studio Code, Copilot CLI ou Claude Code.

  • Node.js 18 ou version ultérieure sur votre PATH. Le plug-in utilise npx pour démarrer des serveurs MCP dans des hôtes compatibles.

  • Git, afin que l’hôte puisse télécharger le plug-in et le contenu des compétences.

  • Azure CLI installé et authentifié :

    az login

  • Azure Developer CLI installé et authentifié si vous envisagez d’utiliser azd les flux de travail de déploiement :

    azd auth login

  • Un projet Microsoft Foundry si vous souhaitez que l’agent inspecte ou modifie des ressources dans l’étendue du projet. Pour connaître les étapes de configuration, consultez Créer un projet.

Ce qu’offre la fonctionnalité Foundry

La microsoft-foundry compétence est une compétence transversale pour le travail dans Foundry. Il permet à un agent de codage de choisir le flux de travail Foundry approprié, de charger la sous-compétence correspondante, d’inspecter les outils MCP Foundry disponibles et de maintenir la cohérence du contexte de déploiement et d’évaluation entre les tours.

Utilisez-le lorsque vous souhaitez que l’agent vous aide à utiliser ces domaines de fonctionnalité :

Zone de capacité Ce que la compétence aide l’agent à faire
Prise en main de Foundry Créez ou connectez-vous à un projet Foundry, approvisionnez une ressource Foundry, choisissez une configuration publique ou isolée du réseau et préparez l’espace de travail pour le développement de l’agent.
Accès et capacité Vérifiez les attributions RBAC, les identités managées, les principaux de service, le quota, la disponibilité du modèle, la capacité au niveau de la région et les prérequis en termes de déploiement.
Déploiement du modèle Déployez des modèles avec des présélections rapides ou des paramètres personnalisés tels que la version, la référence SKU, la capacité et la configuration d’IA responsable.
Personnalisation des modèles Ajustez les modèles avec un ajustement fin supervisé, une optimisation directe des préférences ou des workflows d’ajustement fin par renforcement.
Création d’un agent Créez des applications d’agent hébergées qui utilisent Microsoft Framework Agent, LangGraph ou des frameworks personnalisés dans Python ou C#.
Déploiement de l’agent Conteneurisez un agent, générez et envoyez des images à Azure Container Registry, créez ou mettez à jour des déploiements d’agents hébergés et redéployez après les modifications du code.
Appel et test Envoyez des messages à un ou plusieurs tours aux assistants déployés, testez les assistants de prompt et les assistants hébergés utilisant des protocoles basés sur HTTP ou WebSocket.
Évaluation et optimisation Exécutez des évaluations par lots, configurez l’évaluation continue, comparez les versions, optimisez les prompts, améliorez les instructions de l’agent et préparez des tâches d’Agent Optimizer.
Travail de traçage et de jeu de données Interrogez les traces, analysez la latence ou les défaillances, corrélez les résultats d’évaluation avec les réponses et constituez des jeux de données d’évaluation à partir de traces de production.
Troubleshooting Inspectez les journaux d’activité de l’agent hébergé, interrogez la télémétrie, diagnostiquez les échecs de déploiement ou d’exécution et planifiez une boucle de réparation et de redéploiement.

La compétence installée comprend des sous-compétences spécialisées pour ces domaines. Vous n’avez généralement pas besoin de nommer directement la sous-compétence. Décrivez le résultat que vous souhaitez obtenir, et l’assistant de développement utilisera les instructions de compétence pour acheminer la tâche vers le bon traitement.

Installation

L’extension Foundry Toolkit pour VS Code est fournie avec la compétence Foundry. Pour installer l’extension, consultez Utiliser l’extension Microsoft Foundry pour Visual Studio Code.

Après l’installation, rechargez Visual Studio Code si vous y êtes invité. Ouvrez Copilot Chat, basculez vers le mode agent et vérifiez que les compétences Foundry sont disponibles. Lorsque vous y êtes invité, connectez-vous avec le compte Azure qui a accès à votre projet Foundry.

Pour plus d’informations sur la configuration de MCP dans Visual Studio Code, consultez Prise en main du serveur MCP Azure et Prise en main du serveur MCP Foundry.

Si votre hôte dispose déjà de la configuration du serveur MCP et que vous avez uniquement besoin du contenu des compétences, installez la microsoft-foundry compétence directement :

npx skills add https://github.com/microsoft/azure-skills --skill microsoft-foundry

L’option avec compétence uniquement télécharge le guide du flux de travail Foundry. Utilisez Azure Skills Plugin lorsque vous voulez installer ensemble la compétence, la configuration du serveur Azure MCP et la configuration du serveur Foundry MCP.

Vérifier la configuration

Après l’installation, essayez ces vérifications à partir de votre agent de codage :

  • Demandez What AI models are available in Microsoft Foundry? La réponse doit utiliser les outils Foundry au lieu d’un résumé générique.
  • Demander à List my Azure resource groups. La réponse doit utiliser les outils MCP Azure une fois authentifié.
  • Dans un projet d’agent Foundry, demandez Use the Microsoft Foundry Skill to review this agent for deployment readiness. La réponse doit identifier les vérifications de flux de travail telles que la configuration, l’accès au projet, le déploiement de modèles, les données d’évaluation et la validation du déploiement.

Si une vérification échoue, rechargez l’hôte, vérifiez que le plug-in est installé correctement et vérifiez que l’abonnement az login contient vos ressources Foundry.

Utiliser la compétence dans un projet

Ouvrez le dossier qui contient le code de votre agent Foundry. Demandez le résultat souhaité et incluez le projet cible, l’environnement, le dossier de l’agent ou le nom de déploiement si vous le connaissez déjà.

Utilisez ces modèles d’invite pour appeler les fonctionnalités de la compétence :

Objectif Exemple d’invite Flux de travail classique
Configurer Foundry pour un nouvel agent Use the Microsoft Foundry Skill to create a public Foundry project, deploy a model, and scaffold a hosted agent. Configuration du projet, déploiement du modèle, création d’agent, déploiement et invocation.
Configurer un environnement privé Use the Microsoft Foundry Skill to plan a network-isolated Foundry deployment for this project. Planification du réseau privé, sélection de modèles, vérifications de déploiement et validation.
Déployer un agent hébergé existant Use the Microsoft Foundry Skill to prepare this hosted agent for deployment to my dev environment. Résolution du contexte de l’espace de travail, génération du conteneur, envoi vers ACR, déploiement de l’assistant hébergé et test de validation.
Redéployer après les modifications du code Use the Microsoft Foundry Skill to redeploy this agent and verify it still responds correctly. Mise à jour du déploiement, invocation et suivi de l’évaluation.
Tester un agent Use the Microsoft Foundry Skill to invoke this agent with a short multi-turn test conversation. Recherche, invocation et examen de la réponse de l’agent.
Évaluer la qualité Use the Microsoft Foundry Skill to create an evaluation plan for this agent from eval.yaml. Configuration de la suite d’évaluation, vérifications des jeux de données et des évaluateurs, évaluation par lots et résumé des résultats.
Instructions d’optimisation Use the Microsoft Foundry Skill to improve the agent instructions based on recent evaluation results. Analyse de l’évaluation, optimisation de la requête, examen des candidats et évaluation de suivi.
Créer un jeu de données d’évaluation Use the Microsoft Foundry Skill to create an evaluation dataset from the last seven days of production traces. Requête de trace, curation de jeu de données, contrôle de version et suivi de traçabilité.
Résoudre une défaillance Use the Microsoft Foundry Skill to troubleshoot why this hosted agent deployment is failing. Contrôle d’invocation, journaux, télémétrie, analyse de la cause première, plan de réparation, redéploiement et nouveau test.
Vérifier l’accès ou la capacité Use the Microsoft Foundry Skill to check RBAC and quota blockers before I deploy this model. Révision de l’attribution de rôle, recherche de quota, planification de la capacité et étapes de correction.
Ajuster un modèle Use the Microsoft Foundry Skill to plan a supervised fine-tuning workflow for this training dataset. Préparation du jeu de données, configuration de l’entraînement, révision de point de contrôle, déploiement de modèle et évaluation.

Avant d’approuver les modifications ou les commandes, passez en revue le plan, les fichiers générés et Azure ressources que l’agent propose de créer ou de modifier. Pour les tâches de déploiement, d’optimisation et d’approvisionnement, vérifiez les attributions de rôles et les ressources de prise en charge des coûts avant l’exécution des commandes de l’agent.

Utiliser les compétences de Foundry Toolkit dans VS Code

Foundry Toolkit pour Visual Studio Code rend également les compétences spécifiques à Foundry disponibles dans VS Code. Ces compétences, telles que vscode-microsoft-foundry et foundrytk-quick-start, se concentrent sur l’expérience de développement VS Code : intégration à Foundry Toolkit, exploration de modèles, génération d’agents, sélection d’un modèle, déploiement d’un agent, évaluation des performances et gestion des boîtes à outils. Ils sont différents de la compétence de base microsoft-foundry, qui fournit les connaissances générales et des détails concrets sur les flux de travail liés à la gestion des ressources Foundry, au RBAC, aux quotas, au déploiement de modèles, au déploiement d’agents hébergés, à l’évaluation, au traçage et à la résolution des problèmes. Installez Foundry Toolkit pour VS Code pour rendre ces compétences fournies par extension disponibles dans votre expérience de l’agent VS Code.

Fonctionnement de la compétence

Lorsqu’un agent de codage utilise la compétence Microsoft Foundry, il suit quelques modèles courants :

  1. Cela commence par la découverte MCP de Foundry pour savoir quels outils et paramètres de Foundry sont disponibles dans votre environnement.
  2. Il charge le sous-domaine de compétence correspondant à votre flux de travail, comme la création, le déploiement, l’invocation, l’évaluation, le traçage, le dépannage, le contrôle d’accès en fonction des rôles (RBAC), les quotas ou le déploiement de modèles.
  3. Il résout le contexte du projet et de l’agent à partir de votre espace de travail avant de proposer des modifications ou des commandes.
  4. Il préfère les outils MCP Foundry et Azure structurés lorsqu'ils sont disponibles.
  5. Il demande des valeurs manquantes uniquement lorsqu’elles ne peuvent pas être déterminées à partir de votre requête, des fichiers de l’espace de travail ou du contexte Azure authentifié.

La compétence prend en charge deux types d’agents courants :

Type d’agent Cas d’utilisation
Agent de prompt Assistant basé sur un LLM utilisant un déploiement de modèle et une configuration de requêtes.
Agent hébergé Agent basé sur des conteneurs qui exécute du code personnalisé dans Foundry Agent Service.

Pour les flux de travail d’agents hébergés, la compétence peut également fonctionner avec des agents qui utilisent les protocoles responses, invocations ou invocations_ws. Utiliser invocations_ws pour les scénarios WebSocket en temps réel ou duplex, tels que les agents vocaux ou les interactions de streaming.

Fichiers d’espace de travail utilisés par la compétence

La compétence recherche le contexte du projet et de l’agent Foundry dans les fichiers d’espace de travail courants. Conservez ces fichiers à jour afin que votre agent de codage puisse formuler des recommandations spécifiques et reproductibles.

Fichier ou dossier Comment la compétence l’utilise
azure.yaml Recherche les azd services, les dossiers de projet de l’agent, les paramètres de l’hôte de déploiement et les liaisons d’environnement.
.azure/<environment>/.env Résout les valeurs d’environnement authentifiées azd, telles que l’abonnement, le groupe de ressources, le point de terminaison du projet, le nom de l’agent, le registre et la chaîne de connexion d’Application Insights.
.foundry/agent-metadata.yaml Stocke un état de superposition propre à Foundry, notamment les références aux suites d’évaluation, les références aux jeux de données, les chemins du cache local, les résumés des résultats et les remplacements ne relevant pas de azd.
.foundry/agent-metadata.<env>.yaml Stocke un état de superposition propre à un environnement cible, tel que la production ou l’intégration continue (CI).
agent.yaml Fournit la configuration de l’agent local pour créer, déployer, appeler et évaluer des flux de travail.
eval.yaml Définit l’intention d’évaluation locale, telle que le fichier de jeu de données, les noms des évaluateurs, le seuil de passage, le nombre d’échantillons, la recherche de trace et les instructions de génération.

Pour les flux de travail de déploiement et d’évaluation, préférez .foundry/agent-metadata.yaml pour l’état de superposition non secret. Ne stockez pas les secrets dans les .foundry fichiers. Si azd elle fournit déjà une valeur de déploiement, telle qu’un point de terminaison de projet ou un registre, laissez l’agent de codage utiliser la azd valeur au lieu de la dupliquer dans les métadonnées.

Troubleshooting

Problème Résolution
L’hôte ne trouve pas la compétence. Vérifiez que le plug-in est installé correctement, puis rechargez ou redémarrez l’hôte afin qu’il réindexe le contenu du plug-in.
Les outils MCP n’apparaissent pas. Vérifiez que Node.js est installé, npx fonctionne et les entrées de serveur Azure et Foundry MCP ont été ajoutées pour votre hôte.
Les requêtes Azure échouent avec des erreurs d’authentification. Exécutez de nouveau az login. Pour les flux de travail azd, exécutez également azd auth login.
L’agent utilise l’abonnement incorrect. Définissez l’abonnement Azure prévu dans Azure CLI avant de réessayer l’invite.
Les opérations du projet Foundry échouent. Vérifiez que votre compte a accès au projet Foundry et dispose des rôles Azure RBAC requis.

Contenu connexe

  • Last updated on