Microsoft Agent Framework propose un chemin de migration officiel depuis AutoGen. Ne traduisez pas les classes ligne par ligne : partez des comportements, outils, états et critères de succès de votre application.
1. Geler une référence
Avant toute modification, épinglez les versions AutoGen et créez des tests de conversation. Enregistrez messages, outils appelés, sorties structurées, nombre de tours, latence et coût sur un jeu représentatif.
2. Faire l’inventaire
Listez pour chaque agent : instructions, fournisseur, outils, mémoire, terminaison, intervention humaine et orchestration. Identifiez les comportements implicites d’un GroupChat ou d’un selector : ils devront devenir explicites.
3. Installer séparément
Créez une branche et un environnement avec le paquet agent-framework correspondant au langage et au fournisseur. Suivez la documentation Microsoft de la version installée : le projet étant récent, évitez les extraits non versionnés.
4. Migrer un agent simple
Commencez par un seul agent sans outils. Reproduisez instructions, modèle et paramètres, puis comparez les résultats. Ajoutez ensuite les outils comme fonctions typées avec descriptions courtes, validation et autorisation dans le code.
5. Migrer les conversations
Mappez l’historique AutoGen vers l’abstraction de conversation ou thread du nouveau framework. Vérifiez reprise après redémarrage, isolation entre utilisateurs et suppression. Ne réutilisez pas un identifiant de thread comme autorisation.
6. Refaire l’orchestration
Transformez les échanges multi-agents en workflow explicite : étapes, branches, nombre maximal de tours, critères d’arrêt et checkpoints. Conservez un humain dans la boucle pour les actions sensibles.
7. Exécuter en parallèle
Faites tourner ancienne et nouvelle implémentation en shadow traffic sans doubler les actions. Comparez qualité, outils, latence et dépense. Migrez progressivement, avec possibilité de revenir à AutoGen.
FAQ
Faut-il migrer immédiatement ?
Non. La migration se justifie par vos besoins de support, d’hébergement ou de workflows, pas par le seul changement de nom.
Peut-on conserver des composants AutoGen ?
Oui derrière des adaptateurs pendant la transition, à condition de tester clairement la frontière.
Migrer un agent simple avant le multi-agent
~~~bash python -m venv .venv source .venv/bin/activate pip install --pre agent-framework-openai ~~~
~~~python from agent_framework.openai import OpenAIChatClient
client = OpenAIChatClient() assistant = client.as_agent( name="researcher", instructions="Résume les faits et cite les sources fournies.", )
response = await assistant.run( "Résume les trois documents de test.", ) print(response.text) ~~~
Mappez chaque AssistantAgent AutoGen vers un Agent Framework Agent, chaque ModelClient vers un ChatClient et chaque outil vers une fonction typée. Pour le streaming, reconstruisez la réponse finale à partir des mises à jour. Ne recréez pas immédiatement une conversation multi-agent : migrez et testez chaque rôle seul, puis reconstruisez l’orchestration avec un nombre de tours borné et des points de validation humaine.