Microsoft Agent Framework Python 1.22.0 发布说明

用途与本次变化

根据来源（发布时间 2026-10-15），Microsoft Agent Framework 发布 Python 版 1.22.0。核心框架与根包 agent-framework 宣布支持 Python 3.15，但并非所有包、可选扩展或功能都已支持，原因是上游依赖限制；升级前需查看各包与扩展的 README，Python README 汇总了当前已知限制。

新增内容包括：Cosmos memory provider 加入专用 User-Agent token；foundry 在非流式响应中呈现 OAuth 同意请求；ollama 与 openai 聊天客户端支持可配置服务 URL；oracle 转发连接池配置。

兼容性变化

来源给出持久化状态兼容性警告：适用于含序列化 Content 或流式响应更新记录的持久化产物，如聊天与消息历史、嵌入这些记录的会话存储与协议快照，以及检查点状态中包含这些记录的工作流检查点。1.22 能读取旧版本写入的记录，但 1.22 之前版本无法读取含 hosted 或 merge_mode 的新记录；滚动部署时不要让新旧 worker 共用同一受影响的存储，1.22 写入后也不要降级。

多个包被标记为破坏性变更，涉及内容身份、hosted 执行、协议元数据、重放与流合并语义的统一；AG-UI 请求信任边界与工作流续接、工具审批状态处理；声明式组件的 HTTP 响应体与压缩解码限制。此外包含大量修复，覆盖 A2A、core、declarative、orchestrations、各模型 provider 与托管组件等。

限制与待核实

以上内容均转述自来源发布说明，未进行运行或升级验证；具体各包与扩展对 Python 3.15 的支持范围、破坏性变更的迁移方式，需以对应包文档和完整变更日志为准。