google--adk-python/README.md

Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

Agent Development Kit (ADK) 2.0

一个开源、代码优先（code-first）的 Python 框架，用于以灵活性和可控性构建、评估和部署复杂的 AI 智能体。

重要链接： Docs、 Samples 与 ADK Web。

---

⚠️ 与 1.x 相比的重大变更（BREAKING CHANGES）

本版本对智能体 API、事件模型和会话 schema 包含破坏性变更。ADK 2.0 生成的会话可被 ADK 1.28+ 读取（额外字段将被忽略），但与更早的 1.x 版本不兼容。

---

🔥 2.0 新特性

• Workflow Runtime（工作流运行时）：基于图的执行引擎，用于为智能体应用编排确定性执行流程，支持路由、扇出/扇入（fan-out/fan-in）、循环、重试、状态管理、动态节点、人机协同（human-in-the-loop）以及嵌套工作流。

• Task API（任务 API）：结构化的智能体间委托，支持多轮任务模式、单轮受控输出、混合委托模式、人机协同，以及将任务智能体作为工作流节点。

🚀 安装

pip install google-adk

要求： Python 3.10+。

要安装可选集成，可使用以下命令：

pip install "google-adk[extensions]"

发布节奏大约每两周一次。

快速开始

新手提示： ADK 应用使用两个主要类构建： Agent（定义 AI 的指令、工具和行为）以及 Workflow（在基于图的流程中编排智能体与任务）。

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

本地运行

# Interactive CLI
adk run path/to/my_agent

# Web UI (supports multi-agent directories or pointing directly to a single agent folder)
adk web path/to/agents_dir

📚 文档

• 入门指南（Getting Started）：https://google.github.io/adk-docs/
• 示例（Samples）：请参阅 contributing/workflow_samples/ 和 contributing/task_samples/，了解工作流与任务 API 示例。

🤝 贡献

详情请参阅 CONTRIBUTING.md。

📄 许可证

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