Google ADK Python 2.0.0 GA 发布:生产级多智能体工作流引擎
Google 于 2026 年 5 月 19 日正式发布 Agent Development Kit (ADK) Python v2.0.0 GA 版本,引入基于图引擎的 Workflow Runtime 和全新 Task API,为多智能体协作提供生产级基础设施。
版本概览
ADK 2.0.0 是 Google Agent Development Kit 的首个 General Availability 版本,标志着该框架正式迈入生产可用阶段。该版本带来了两项核心架构革新:Workflow Runtime(工作流运行时)——基于图的执行引擎,以及 Task API(任务 API)——结构化智能体间任务委派机制。
核心亮点
- Workflow Runtime(工作流运行时):基于图(Graph)的执行引擎,支持路由、扇出/扇入(Fan-out/Fan-in)、循环、重试、状态管理、动态节点、人工介入(HITL)和嵌套工作流。
- Task API(任务 API):支持多轮任务模式、单轮受控输出、混合委派模式、人工介入,以及将任务智能体作为工作流节点使用。
破坏性变更(Breaking Changes)
ADK 2.0 在设计上兼容 ADK 1.x,但引入了若干重要破坏性变更:
| 变更领域 |
说明 |
| 事件模型 |
新增 node_info 和 output 字段,自定义 Session 存储需更新数据库 schema |
| Agent 执行机制 |
BaseAgent 现继承 BaseNode,Agent 作为工作流图节点运行,旧版 run() 重写不再生效 |
| 上下文回调 |
禁止直接追加事件到 session,必须通过 yield 由框架管理 |
| 错误处理 |
框架自动捕获异常以支持重试和 HITL,不再建议在 tool 内使用宽泛的 try...except |
⚠️ ADK 2.0 生成的 Session 可被 ADK 1.28+ 读取(额外字段将被忽略),但与更早的 1.x 版本不兼容。升级前请确保备份 ADK 1.x 项目。
安装方式
pip install google-adk
最低要求:Python 3.11+
可选安装扩展组件:
pip install "google-adk[extensions]"
快速示例
单智能体:
from google.adk import Agent
root_agent = Agent(
name="greeting_agent",
model="gemini-2.5-flash",
instruction="You are a helpful assistant. Greet the user warmly.",
)
工作流编排:
from google.adk import Agent, Workflow
generate_fruit_agent = Agent(
name="generate_fruit_agent",
instruction="Return the name of a random fruit. Return only the name.",
)
generate_benefit_agent = Agent(
name="generate_benefit_agent",
instruction="Tell me a health benefit about the specified fruit.",
)
root_agent = Workflow(
name="root_agent",
edges=[("START", generate_fruit_agent, generate_benefit_agent)],
)
完整更新日志
ADK 2.0 General Availability
此版本发布 Google Agent Development Kit (ADK) v2.0.0 正式版(GA),为多智能体工作流和高级动态智能体协作奠定生产级基础。
核心架构亮点
多智能体工作流引擎
- 灵活的执行图:建立模型无关的引擎,用于编排非线性、条件性和循环性的智能体执行模式。
- 智能任务委派:引入模块化工作流抽象,支持并行子智能体工作器、嵌套层级团队结构和跨复杂任务步骤的弹性动态调度。
动态智能体协作
- 原生智能体间路由:提供无缝编排,支持智能体间消息传递、控制状态交接和跨协作多智能体流的上下文变量传播。
相关链接
引用链接
[1]GitHub 仓库: https://github.com/google/adk-python
[2]官方文档: https://adk.dev/2.0/
[3]PyPI 页面: https://pypi.org/project/google-adk/
[4]Workflow 示例: https://github.com/google/adk-python/tree/v2/contributing/workflow_samples
[5]Task API 示例: https://github.com/google/adk-python/tree/v2/contributing/task_samples