Microsoft Agent Framework 1.25 pour Python : sept ruptures à vérifier avant de mettre à jour

Microsoft Agent Framework est la bibliothèque libre de Microsoft pour construire des agents et des enchaînements d'agents, en Python et en .NET. Sa version Python 1.25.0, publiée le 7 novembre 2026, contient peu de nouveautés visibles et beaucoup de changements « cassants », c'est-à-dire capables d'interrompre un code qui fonctionnait la veille. Les notes de version en listent sept.

Python 3.10, c'est fini

Tous les paquets exigent désormais Python 3.11 ou plus récent. La version précédente, la 1.24.0 du 30 octobre, avait prévenu. Si vos serveurs ou vos images Docker tournent encore en 3.10, la mise à jour de l'interpréteur passe avant celle du cadre.

MCP : des plafonds par défaut

Quand un agent interroge un serveur MCP pour connaître ses outils, la découverte est maintenant bornée :

• 100 pages et 1 000 éléments au maximum par catalogue (max_discovery_pages, max_discovery_items) ;
• 30 secondes de délai par défaut pour les requêtes gérées par le cadre.

Ces limites se lèvent en passant None, ce que les notes réservent aux serveurs de confiance. Si un rafraîchissement échoue, le catalogue précédent est conservé en entier.

Autre changement, présenté comme un correctif de sécurité : en mode déclaratif, chaque appel ouvre puis ferme sa propre session MCP. Les sessions gardées en cache disparaissent. Un serveur MCP qui comptait sur une continuité implicite entre deux appels ne la retrouvera plus ; il faut passer par un identifiant d'état explicite.

Autorisations, traces et bac à sable

• AG-UI (le protocole qui relie agents et interfaces). Les exécuteurs et sessions d'un workflow sont liés à un seul périmètre d'autorisation, et toute exécution croisée est rejetée avant l'appel au modèle. WorkflowAgent.as_tool() est refusé dans les points d'accès AG-UI.
• Télémétrie. Les traces de workflow suivent les conventions OpenTelemetry GenAI. Les tableaux de bord qui filtraient sur le nom workflow.run doivent filtrer sur l'opération invoke_workflow, et l'attribut workflow.name devient gen_ai.workflow.name.
• Exécution de code. Avec Hyperlight et Monty, le détail des exceptions levées par les outils côté hôte est masqué par défaut avant d'être rendu au code généré. L'option include_detailed_errors=True le rétablit, à réserver aux canaux de confiance.
• Foundry Local. Le paquet migre vers le SDK 2.3.1 et prend en charge Python 3.11 à 3.14. Deux options sont supprimées (do_sample, early_stopping).

La seule vraie nouveauté

Les règles d'approbation appliquées à la découverte MCP peuvent désormais être des fonctions, et les métadonnées d'approbation de Foundry Toolbox sont respectées, y compris les filtres par nom d'outil et par lecture seule.

La longue liste de corrections touche presque tous les connecteurs : Anthropic, Bedrock, Ollama, OpenAI, GitHub Copilot, ainsi que les bases de stockage.

Ce qu'il faut garder en tête

Le rythme est soutenu : les versions Python 1.22.0, 1.23.0, 1.24.0 et 1.25.0 sont sorties entre le 15 octobre et le 7 novembre, chacune avec des changements cassants. La version .NET suit sa propre numérotation (1.28.0 le 6 novembre) et ses propres ruptures. Un numéro « mineur » ne garantit donc pas une mise à jour sans surprise.

Notre lecture

Pour une petite équipe, la consigne est simple : fixez la version exacte du cadre dans vos dépendances et ne montez pas automatiquement. Avant de passer à la 1.25, vérifiez trois points : la version de Python en production, les serveurs MCP qui exposent de très gros catalogues ou qui s'appuient sur une session, et les tableaux de bord de supervision bâtis sur les anciens noms de traces. Les changements vont dans le bon sens, celui de valeurs par défaut plus prudentes. Mais ils demandent une lecture attentive des notes de version à chaque montée.