v2.40.0 (2026-09-04)

Pydantic AI 于 2026 年 9 月 4 日发布 v2.40.0 版本。主要新功能包括：添加 pydantic_ai.prices.update_in_background() 方法；在会话中处理 barge-in（支持 handle_barge_in=True、interrupt(played_bytes=...) 和 played_audio_bytes）；添加 provider_factory 以推断实时模型；添加 @agent.on_event 用于在 Agent 上注册事件监听器；为 RealtimeSession.send() 添加 respond= 参数，并明确文本轮次会请求回复；添加 RealtimeSession.enqueue() 用于从驱动会话的代码发送带外提示。Bug 修复包括：映射 OpenAI Responses 流终止事件上的 finish_reason；修复 defer_loading 揭示合成拆分并行批次的 tool_result 与 tool_use 的问题；修复实时会话中当音频块不是字节类型时回滚用户轮次状态；允许能力缓存派生状态，并拒绝合并无法重建的集合；使能力的自动分配注册表键看起来像运行本地句柄；停止向过时的 gpt-realtime-2025-08-28 快照发送推理。

该版本聚焦于实时语音会话的精细控制，如 barge-in 处理和带外提示，表明 Pydantic AI 正在增强 Agent 的交互能力。@agent.on_event 提供了事件驱动编程模型，可能简化复杂 Agent 逻辑。