La migration officielle conserve les grandes intentions — agent, instructions, outils, messages et état — mais simplifie plusieurs abstractions. Procédez par parcours métier afin de pouvoir comparer l’ancien et le nouveau comportement à chaque étape.
1. Établir l’inventaire
Recensez les paquets Semantic Kernel, les instances de Kernel, agents, plugins, fonctions, filtres, connecteurs vectoriels et mécanismes de persistance. Relevez aussi les fonctionnalités expérimentales. Pour chaque parcours, enregistrez des entrées de test anonymisées et les critères de réussite attendus.
2. Installer les paquets nécessaires
Le paquet Python historique est semantic-kernel. Agent Framework utilise un cœur et des paquets par fournisseur. Le méta-paquet facilite le démarrage, puis une installation plus ciblée réduit les dépendances. Verrouillez les versions et consultez le guide officiel :
pip install agent-frameworkLes imports passent de semantic_kernel à agent_framework. Ne faites pas un remplacement textuel global : les responsabilités de certaines classes ont changé.
3. Migrer un agent simple
Dans Semantic Kernel, un agent dépend généralement d’un Kernel contenant les services et plugins. Agent Framework associe directement un client et des outils à un Agent. Migrez d’abord un agent sans orchestration, puis comparez réponses, appels d’outils, streaming et erreurs.
Le guide Microsoft décrit également une couche de compatibilité pour réutiliser certaines fonctions et certains connecteurs vectoriels Semantic Kernel pendant la transition. Cette stratégie permet d’éviter une bascule simultanée de toutes les briques.
4. Remplacer les threads par des sessions
Mappez chaque conversation vers une session isolée. Testez la création, la reprise, l’expiration et la suppression. Une erreur de séparation peut exposer le contexte d’un utilisateur à un autre ; ce contrôle doit être automatisé.
5. Repenser l’orchestration
Transformez les processus structurés en workflows explicites au lieu de reproduire exactement l’ancien graphe d’agents. Placez les règles déterministes dans du code, les décisions sémantiques dans des agents et les actions sensibles derrière une validation humaine.
6. Déployer par étapes
Exécutez les deux versions sur un jeu d’évaluation commun. Comparez qualité, latence, coût, traces et taux d’échec. Activez progressivement Agent Framework avec une possibilité de retour arrière. Retirez Semantic Kernel uniquement lorsque les données persistées, les outils et les scénarios de reprise sont validés en production.