La migration ne consiste pas à remplacer mécaniquement les imports. Les concepts restent proches, mais l’orchestration évolue : AutoGen combine un cœur événementiel et des équipes, tandis que Microsoft Agent Framework organise les traitements dans des workflows typés reliés par des arêtes.
1. Inventorier l’application
Listez les AssistantAgent, clients de modèles, outils, équipes, conditions d’arrêt et mécanismes de persistance. Identifiez aussi les comportements implicites : nombre maximal d’appels d’outils, parallélisme, reprises et validation humaine. Ajoutez un test d’acceptation pour chaque parcours avant de modifier le code.
2. Migrer un agent isolé
Commencez par un agent sans orchestration complexe. Dans AutoGen, un AssistantAgent reçoit un client, des instructions et des outils. Agent Framework conserve cette structure autour d’un Agent, mais peut poursuivre les appels d’outils jusqu’à produire une réponse finale. Vérifiez donc les limites, délais et budgets plutôt que de supposer un comportement identique.
Le guide Microsoft fournit des correspondances concrètes pour les clients, le streaming, les messages, les outils et les sessions. Utilisez-les comme référence de code, mais conservez vos tests métier comme source de vérité.
3. Adapter l’état et les outils
Remplacez progressivement l’état conversationnel par des sessions explicites. Pour chaque fonction-outil, contrôlez le schéma d’entrée, les erreurs et les autorisations. Les décorateurs et l’inférence de schéma simplifient l’enregistrement, sans supprimer la nécessité de valider les arguments côté serveur.
4. Repenser le multi-agent
Ne traduisez pas automatiquement chaque GroupChat. Modélisez les étapes, les embranchements et les points de validation dans un Workflow. Un ancien GraphFlow se rapproche naturellement d’un graphe, tandis qu’une conversation libre peut demander une règle de routage plus explicite.
5. Déployer progressivement
Faites fonctionner l’ancien et le nouveau chemin sur les mêmes cas anonymisés. Comparez les résultats, la latence, les coûts, les appels d’outils et les traces. Activez ensuite le nouveau parcours pour une faible part du trafic avec une possibilité de retour arrière.
Une migration réussie préserve les contrats métier tout en améliorant la maîtrise de l’exécution. Supprimez AutoGen seulement après validation des sauvegardes, des scénarios de reprise et des métriques en production.