Microsoft Agent Framework

Utilisez cette compétence lorsque vous travaillez avec des applications, des agents, des workflows ou des migrations construits sur Microsoft Agent Framework.

Microsoft Agent Framework est le successeur unifié de Semantic Kernel et AutoGen, combinant leurs forces avec de nouvelles capacités. Comme il est toujours en preview public et évolue rapidement, fondez toujours les conseils d'implémentation sur la documentation officielle la plus récente et les exemples plutôt que de vous fier à des connaissances obsolètes.

Déterminez d'abord le langage cible

Choisissez le workflow de langage avant de faire des recommandations ou des modifications de code :

1. Utilisez le workflow .NET quand le dépôt contient des fichiers .cs, .csproj, .sln, .slnx ou d'autres fichiers de projet .NET, ou quand l'utilisateur demande explicitement des conseils C# ou .NET. Suivez references/dotnet.md.
2. Utilisez le workflow Python quand le dépôt contient .py, pyproject.toml, requirements.txt, ou quand l'utilisateur demande explicitement des conseils Python. Suivez references/python.md.
3. Si le dépôt contient les deux écosystèmes, faites correspondre le langage utilisé par les fichiers en cours de modification ou l'objectif déclaré de l'utilisateur.
4. Si le langage est ambigu, inspectez d'abord l'espace de travail actuel, puis choisissez la référence spécifique au langage la plus pertinente.

Consultez toujours la documentation en direct

• Lisez d'abord l'aperçu de Microsoft Agent Framework : https://learn.microsoft.com/agent-framework/overview/agent-framework-overview
• Préférez la documentation officielle et les exemples pour la surface API actuelle.
• Utilisez l'outil MCP Microsoft Docs quand disponible pour récupérer les conseils et exemples à jour du framework.
• Traitez les anciens modèles Semantic Kernel ou AutoGen comme des entrées de migration, non comme le modèle d'implémentation par défaut.

Conseils partagés

Quand vous travaillez avec Microsoft Agent Framework dans n'importe quel langage :

• Utilisez des modèles async pour les opérations d'agent et de workflow.
• Implémentez une gestion explicite des erreurs et une journalisation.
• Préférez le typage fort, les interfaces claires et les modèles de composition maintenables.
• Utilisez DefaultAzureCredential quand l'authentification Azure est appropriée.
• Utilisez les agents pour la prise de décision autonome, la planification ad hoc, les flux de conversation, l'utilisation d'outils et les interactions avec des serveurs MCP.
• Utilisez les workflows pour l'orchestration multi-étapes, les graphes d'exécution prédéfinis, les tâches longues et les scénarios avec intervention humaine.
• Supportez les fournisseurs de modèles tels que Azure AI Foundry, Azure OpenAI, OpenAI et autres, mais préférez les services Azure AI Foundry pour les nouveaux projets quand cela correspond aux besoins de l'utilisateur.
• Utilisez la gestion d'état basée sur des threads ou équivalente, les fournisseurs de contexte, les middleware, les points de contrôle, le routage et les modèles d'orchestration quand ils correspondent au problème.

Conseils de migration

• Si vous migrez depuis Semantic Kernel, utilisez le guide de migration officiel : https://learn.microsoft.com/agent-framework/migration-guide/from-semantic-kernel/
• Si vous migrez depuis AutoGen, utilisez le guide de migration officiel : https://learn.microsoft.com/agent-framework/migration-guide/from-autogen/
• Préservez d'abord le comportement, puis adoptez progressivement les modèles natifs d'Agent Framework.

Workflow

1. Déterminez le langage cible et lisez le fichier de référence correspondant.
2. Récupérez la documentation officielle la plus récente et les exemples avant de faire des choix d'implémentation.
3. Appliquez les conseils partagés sur les agents et les workflows de cette compétence.
4. Utilisez les packages spécifiques au langage, les chemins de dépôt, les chemins d'exemples et les pratiques de codage du fichier de référence choisi.
5. Quand les exemples du dépôt diffèrent de la documentation actuelle, expliquez la différence et suivez le modèle actuellement supporté.

Références

• Référence .NET
• Référence Python

Critères de complétude

• Les recommandations correspondent au langage cible.
• Les noms de packages, les chemins de dépôt et les emplacements d'exemples correspondent à l'écosystème sélectionné.
• Les conseils reflètent la documentation actuelle de Microsoft Agent Framework plutôt que des hypothèses héritées.
• Les conseils de migration mentionnent Semantic Kernel et AutoGen uniquement quand c'est pertinent.