v2.47.0 (2026-09-21)
Pydantic AI 发布 v2.47.0（2026-09-21）。兼容性变更：None 输出路由被命名为 None 而非 NoneType；当 UserPromptPart.content 不是 str 或序列时改为抛错，而不是静默发送 dict 的键。功能方面 TypeSafeModel 新增支持三种字段类型。修复包括：拒绝元组输出字段与自包含模型而非崩溃、拒绝层级数超过 Jev 评分上限的 rubric、允许 None 作为 TypeSafeModel 可选路由、允许 Choices 集合以 TypeSafeModel 路由自描述、识别带描述的 None 路由与 None 选项、在填充 TypeSafeModel 请求中命名所选路由。依赖方面将 ag-ui-protocol 固定版本。
发展脉络
- 首次出现v2.47.0 (2026-09-21)Pydantic AI
- 当前判断这是开源 Agent 框架在类型安全与可观测性上的常规迭代，而非能力跃迁。把路由显式化、把静默容错改为报错，反映 Agent 工具链正从「能跑通」转向「可调试、可复现」，对依赖该框架构建生产 Agent 的团队意味着升级需做兼容性检查。Agent Pulse · 分析
Pydantic AI 发布 v2.47.0，主要围绕 TypeSafeModel 的路由与类型校验做收敛：允许 None 作为可选路由、让 Choices 集合自描述为路由、识别带描述的 None 路由与 None 选项，并在请求中命名所选路由；同时新增三种字段类型支持。兼容性上，None 输出路由改名为 None，UserPromptPart.content 非 str 或序列时由静默发送 dict 键改为抛错。修复项拒绝元组输出字段与自包含模型、拒绝层级超过 Jev 评分上限的 rubric，避免崩溃。依赖将 ag-ui-protocol 固定版本。
从变更看，TypeSafeModel 正在把「路由选择」纳入类型系统：None 可被显式命名与描述，Choices 可自描述，请求中回填所选路由名，说明框架在减少隐式行为。UserPromptPart.content 由静默降级改为抛错，属于输入契约收紧，可能让依赖旧宽松行为的调用方在升级后报错。可验证下一信号：后续版本是否把路由命名与描述扩展到更多输出类型，以及是否有迁移说明。
这是开源 Agent 框架在类型安全与可观测性上的常规迭代，而非能力跃迁。把路由显式化、把静默容错改为报错，反映 Agent 工具链正从「能跑通」转向「可调试、可复现」，对依赖该框架构建生产 Agent 的团队意味着升级需做兼容性检查。
对使用 Pydantic AI 的团队，本次升级的价值在于减少静默错误与崩溃，提升 Agent 输出路由的可解释性，降低线上排障成本；代价是兼容性变更需要回归测试。建议在升级前检查 None 路由命名与 UserPromptPart.content 传参路径。
若该方向延续，TypeSafeModel 的路由描述可能成为结构化输出与工具调用的统一契约，降低多路由 Agent 的调试成本。可验证下一信号：官方 changelog 是否出现路由元数据在日志或追踪中的暴露，以及社区是否报告升级破坏。