v2.26.0 (2026-08-06)
Pydantic AI 发布 v2.26.0，新增支持隐藏函数工具直到通过工具搜索、load_capability 或 ToolReturn.tools 揭示，使用各提供商的本地延迟/添加通道；新增第一方运行取消功能 AgentRun.cancel()、RunContext.cancel()、RunCancelled；新增 Model.resolve_prompt_cache_retention() 解析有效提示缓存保留；将 run_stream_events() 迭代器提升为公共 AgentRunEvents 句柄，支持取消和运行状态访问；覆盖并记录 DeepSeek V4 Flash 通过 OpenAIResponsesModel + DeepSeekProvider；修复多个 bug，包括转发 model_id 通过 WrapperModel 并在 TemporalModel 中解析、按索引映射流式 OpenRouter 推理细节、在 supports_inline_system_prompts=False 时关闭 OpenRouter 原生对话中系统消息、恢复遗留 profile-key shim 并修复两个揭示状态边缘。
发展脉络
- 首次出现v2.26.0 (2026-08-06)Pydantic AI
- 当前判断Pydantic AI 作为 Python 生态中流行的 Agent 框架，其持续迭代反映了 Agent 开发工具链的成熟趋势。隐藏工具和运行取消等功能表明框架正在向生产级应用靠拢，满足复杂工作流的需求。对 DeepSeek 等新模型的支持也体现了开源生态对多模型兼容性的重视。Agent Pulse · 分析
Pydantic AI 发布 v2.26.0，带来多项功能增强和错误修复。主要功能包括：支持隐藏函数工具直到通过工具搜索、load_capability 或 ToolReturn.tools 揭示，利用各提供商的本地延迟/添加通道；新增第一方运行取消功能，提供 AgentRun.cancel()、RunContext.cancel() 和 RunCancelled 异常；新增 Model.resolve_prompt_cache_retention() 方法，用于从模型设置中解析有效的提示缓存保留策略；将 run_stream_events() 迭代器提升为公共 AgentRunEvents 句柄，支持取消和运行状态访问；覆盖并记录 DeepSeek V4 Flash 通过 OpenAIResponsesModel 和 DeepSeekProvider。错误修复包括：转发 model_id 通过 WrapperModel 并在 TemporalModel 中解析；按索引映射流式 OpenRouter 推理细节；在 supports_inline_system_prompts=False 时关闭 OpenRouter 原生对话中系统消息；恢复遗留 profile-key shim 并修复两个揭示状态边缘（is_tool_available、TestModel 原生添加）。
该版本引入的隐藏工具机制允许开发者延迟暴露工具，直到特定条件触发，这有助于减少模型在初始提示中的工具选择负担，并可能提高推理效率。运行取消功能提供了对 Agent 运行生命周期的更精细控制，对于长时间运行的任务至关重要。提示缓存保留解析功能允许开发者根据模型设置动态调整缓存策略，可能降低成本。DeepSeek V4 Flash 的支持表明 Pydantic AI 正在扩展对新兴模型提供商的兼容性。
Pydantic AI 作为 Python 生态中流行的 Agent 框架，其持续迭代反映了 Agent 开发工具链的成熟趋势。隐藏工具和运行取消等功能表明框架正在向生产级应用靠拢，满足复杂工作流的需求。对 DeepSeek 等新模型的支持也体现了开源生态对多模型兼容性的重视。
对于使用 Pydantic AI 构建 Agent 的团队，此版本提供了更灵活的工具管理、可靠的取消机制和潜在的缓存成本优化，有助于提升生产环境的稳定性和效率。对 DeepSeek V4 Flash 的支持可能降低推理成本，吸引成本敏感的用户。
后续可关注 Pydantic AI 是否进一步优化工具隐藏的触发条件，以及取消功能在分布式场景下的表现。提示缓存保留解析可能推动更智能的缓存管理，未来可能集成到更多模型提供商。DeepSeek V4 Flash 的集成可能带动更多开发者采用该模型。