Agent Development Kit (ADK) 2.0

一个开源的、代码优先（code-first）的 Python 框架，旨在为构建、评估和部署复杂的 AI Agent 提供灵活性与可控性。

重要链接：文档、示例 以及 ADK Web。

---

⚠️ 2.0 版本重大变更说明

本版本在 Agent API、事件模型和会话 schema 方面包含重大变更。由 ADK 2.0 生成的会话可被 ADK 1.28+ 读取（多余字段将被忽略），但与旧版 1.x 不兼容。

---

🔥 2.0 版本新特性

• Workflow Runtime（工作流运行时）：一个基于图的执行引擎，用于构建 Agent 应用的确定性执行流。支持路由、分发/聚合（fan-out/fan-in）、循环、重试、状态管理、动态节点、人工干预（human-in-the-loop）以及嵌套工作流。

• Task API（任务 API）：实现结构化的 Agent 间委派，支持多轮任务模式、单轮受控输出、混合委派模式、人工干预，以及将任务 Agent 作为工作流节点使用。

🚀 安装

pip install google-adk

要求： Python 3.11+。

如需安装可选集成功能，可以使用以下命令：

pip install "google-adk[extensions]"

发布周期约为每两周一次。

快速上手

Agent

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.",
)

Workflow（工作流）

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)],
)

本地运行

# 交互式 CLI
adk run path/to/my_agent

# Web UI（支持多 Agent 目录或直接指向单个 Agent 文件夹）
adk web path/to/agents_dir

📚 文档

• 入门指南：https://google.github.io/adk-docs/
• 示例：查看 contributing/workflow_samples/ 和 contributing/task_samples/ 获取工作流及任务 API 的示例。

🤝 参与贡献

详情请参阅 CONTRIBUTING.md。

📄 许可证

本项目采用 Apache 2.0 许可证授权 — 详情请参阅 LICENSE 文件。