Microsoft Agent Framework Python 1.20.0 发布说明

用途与本次变化

该版本为 Python 包发布更新，来源为 GitHub 发布说明，发布日期标注为 2026-10-02。

新增方面：

• 新增 agent-framework-foundry-hosting，用于在 Foundry Responses 与 Foundry Invocations 上托管原生工作流。
• 新增 DuckDB、SQL Server 原生向量存储连接器，以及 TypeSafe AI 连接器。
• 核心包加入响应流门控与缓冲、会话级文件访问隔离、AgentExecutor 的 checkpoint-state TypedDict，以及技能脚本可选的 FunctionInvocationContext 注入。
• Foundry 与 OpenAI 客户端增加原生计算机使用支持及 Foundry 项目嵌入。
• Azure AI Search 的 AzureAISearchContextProvider 支持 knowledge_source_params。
• 新增 MongoDB agent RAG 示例。

变更方面：

• Foundry 托管为破坏性重设计，围绕请求级 agent 工厂、持久化沙箱隔离会话、可解析的 Invocations 运行等。
• 核心包强化审批与 MCP 运行时上下文处理，匹配到函数结果即视为终止，本地审批需会话支撑，审批绑定无法解析时默认拒绝。
• 声明式包为破坏性实验性调整，涉及工作流状态查找、PowerFx 状态构造、HTTP 请求 URL 规范化等。
• Gemini 与核心向量 API 为破坏性变更，加入 Gemini Embedding 2 与向量任务选项，改用 GOOGLE_* 配置命名空间。
• 多个包补充 py.typed 标记并纳入包检查。

修复方面：涵盖 OpenAI 元数据默认值隔离、MCP 安全标签在工具可调用前应用、响应流热路径开销降低、功能工作流重放身份保持、历史轮次与检查点子类保留、MCP 技能归档校验、流清理钩子、媒体类型接受、Foundry 托管沙箱隔离与取消处理等。

适用场景

面向使用该框架构建 Python agent 应用、托管工作流、向量检索或对接多模型提供方的开发者。破坏性变更较多的包（Foundry 托管、声明式、Gemini 相关向量接口）升级前需评估兼容性。

限制与待核实

以上均为发布说明的转述，未进行安装或运行验证；具体 API 细节、迁移步骤与兼容性影响需查阅对应 PR 与完整变更记录。时间信息为来源标注，不代表当前时间。