Pydantic AI v2.58.0 发布：用量统计修正、请求超时与步骤存储优化

Pydantic AI 于 2026-10-17 发布 v2.58.0，以下为原文列出的变化。

兼容性说明

• 在 RunUsage、UsageLimits 与 SpendLimits 中，恢复的 "suspended" 响应用量只计入产生它的那次运行。
• RealtimeConnection 通过公开的 pydantic_ai.realtime.lifecycle 模块产出生命周期事件。
• read_file 可返回图片和 PDF，并描述其他二进制文件。
• 用户在实时回复生成完成后中断的回复记为 interrupted；播种时标记中断语音。
• 当模型无法应用 allowed_domains、blocked_domains、max_uses 或 external_web_access 设置时，将原生工具视为不支持。
• 新增请求作用域的 SystemPromptPart(scope='request')，以 Anthropic 的 clear_at 系统消息原生发送。
• Planning 状态工具事件改为在存储读取之后发出，使带 event_stream_handler 的 DBOS 恢复按序重放。原文提示：使用 Planning 与 event_stream_handler 的既有 DBOS 工作流升级后可能无法恢复，建议先让进行中的工作流完成，或部署新的 DBOS 应用版本。

新功能

• 用 DelegationTasks.steer 引导运行中的委派任务。
• SqliteStepStore、PostgresStepStore 与 MongoStepStore 改为每条消息只存一次，不再在每个快照中重复历史。
• ModelSettings['max_retries'] 设置提供商 SDK 重试请求的次数；ModelSettings['request_timeout'] 覆盖单次模型请求的所有尝试与流式消费。
• 用 timeout= 与 RunContext.deadline 限定整次代理运行。
• 将 ctx.enqueue 消息以历史形式流式发送给 Vercel AI 与 AG-UI 前端，前端会回传但不渲染。
• Skill 支持 unknown_names='skip'，忽略没有库拥有的 include/exclude 名称。

缺陷修复（节选） 涵盖符号链接指令文件名、中途系统提示保留、并行工具调用保留、Bedrock/Mistral 工具选择、默认输出模式解析、工具结果批量清理、流式错误回退、事件循环更换后的 HTTP 客户端、提示缓存保持、HuggingFace 客户端关闭、realtime 用量同步、Mistral 工具调用 ID 重写及 Anthropic Vertex 自动提示缓存等。原文末尾给出从 v2.57.0 到 v2.58.0 的完整变更日志链接。