ADK-Python 0.3.0版本发布：强化Agent开发体验与功能扩展

ADK-Python（Agent Development Kit for Python）是Google推出的一个用于构建和部署智能代理（Agent）的开发框架。它提供了从本地开发到云端部署的全套工具链，特别适合开发基于大语言模型（LLM）的对话式AI应用。

核心功能升级

认证体系重构

本次0.3.0版本对认证系统进行了重大重构，将原先嵌套在字典中的access_token和refresh_token直接提升到认证凭据的顶层。这一改动虽然带来了breaking change，但显著简化了认证流程的代码实现，开发者现在可以更直观地访问这些关键令牌。

MCPToolset集成增强

新版本显著改进了对MCPToolset的支持，特别是在adk web命令中。MCPToolset是Google内部使用的一套工具集，用于管理和控制模型调用。现在开发者可以更轻松地在本地开发环境中运行集成了MCP工具的Agent，大大提升了开发效率。

开发者体验优化

LLM响应元数据支持

新增的custom_metadata字段为LlmResponse对象提供了扩展能力。通过after_model_callback回调函数，开发者现在可以为LLM响应添加自定义标签和元数据。这个功能特别适合需要跟踪和分析模型响应的场景，例如：

• 记录模型调用的上下文信息
• 添加性能指标标签
• 标记特殊类型的响应

会话数据库配置

adk deploy cloud_run命令新增了--session_db_url选项，允许开发者直接指定会话数据库的URL。这一改进使得部署到Cloud Run时，会话持久化的配置更加灵活和便捷。

开发者工具改进

开发界面增强

Web开发者界面(Dev UI)获得了多项改进：

1. 优化了Google搜索结果渲染，使信息展示更加清晰
2. 现在会显示WebSocket关闭的具体原因，便于调试连接问题
3. 音频和视频相关的错误提示更加友好和详细

问题修复

本次版本修复了多个关键问题：

• 解决了MCP工具JSON schema解析的兼容性问题
• 修复了DatabaseSessionService中的崩溃问题
• 修正了AgentTool中skip_summarization的行为
• 修复了functions.py中的若干问题

技术生态适配

项目将google-genai的最低版本要求提升至1.11.0，确保开发者能够使用最新的生成式AI功能。同时，代码库进行了多项内部改进和优化，包括：

• 代码结构的清理和重构
• 多处拼写错误的修正
• 文档(README.md)的完善

开发者建议

对于正在使用ADK-Python的开发者，升级到0.3.0版本时需要注意：

1. 认证相关的代码需要适配新的token访问方式
2. 可以利用新的custom_metadata功能增强应用的可观测性
3. 推荐使用新的Dev UI功能提升开发效率

这个版本标志着ADK-Python在开发者体验和功能完备性上又向前迈进了一步，特别是对复杂Agent开发工作流的支持更加完善。新加入的元数据支持和认证简化等特性，使得构建生产级的AI应用变得更加高效和可靠。