diff --git a/README.md b/README.md
index 0eddf28..21f8d82 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,9 @@
+
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
+> [English](./README.en.md) · [原始项目](https://github.com/google/adk-python) · [上游 README](https://github.com/google/adk-python/blob/HEAD/README.md)
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
+
# Agent Development Kit (ADK) 2.0
[](LICENSE)
@@ -11,57 +17,50 @@
- An open-source, code-first Python framework for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
+ 一个开源、代码优先(code-first)的 Python 框架,用于以灵活性和可控性构建、评估和部署复杂的 AI 智能体。
______________________________________________________________________
-> **⚠️ BREAKING CHANGES FROM 1.x**
+> **⚠️ 与 1.x 相比的重大变更(BREAKING CHANGES)**
>
-> This release includes breaking changes to the agent API, event model, and
-> session schema. **Sessions generated by ADK 2.0 are readable by ADK 1.28+
-> (extra fields will be ignored), but are incompatible with older 1.x versions.**
+> 本版本对智能体 API、事件模型和会话 schema 包含破坏性变更。**ADK 2.0 生成的会话可被 ADK 1.28+ 读取(额外字段将被忽略),但与更早的 1.x 版本不兼容。**
______________________________________________________________________
-## 🔥 What's New in 2.0
+## 🔥 2.0 新特性
-- **Workflow Runtime**: A graph-based execution engine for composing
- deterministic execution flows for agentic apps, with support for routing,
- fan-out/fan-in, loops, retry, state management, dynamic nodes,
- human-in-the-loop, and nested workflows.
+- **Workflow Runtime(工作流运行时)**:基于图的执行引擎,用于为智能体应用编排确定性执行流程,支持路由、扇出/扇入(fan-out/fan-in)、循环、重试、状态管理、动态节点、人机协同(human-in-the-loop)以及嵌套工作流。
-- **Task API**: Structured agent-to-agent delegation with multi-turn task
- mode, single-turn controlled output, mixed delegation patterns,
- human-in-the-loop, and task agents as workflow nodes.
+- **Task API(任务 API)**:结构化的智能体间委托,支持多轮任务模式、单轮受控输出、混合委托模式、人机协同,以及将任务智能体作为工作流节点。
-## 🚀 Installation
+## 🚀 安装
```bash
pip install google-adk
```
-**Requirements:** Python 3.10+.
+**要求:** Python 3.10+。
-To install optional integrations, you can use the following command:
+要安装可选集成,可使用以下命令:
```bash
pip install "google-adk[extensions]"
```
-The release cadence is roughly bi-weekly.
+发布节奏大约每两周一次。
-## Quick Start
+## 快速开始
-> **Beginner Note:** ADK applications are built using two main classes:
-> **`Agent`** (defines an AI's instructions, tools, and behavior) and
-> **`Workflow`** (orchestrates agents and tasks in a graph-based flow).
+> **新手提示:** ADK 应用使用两个主要类构建:
+> **`Agent`**(定义 AI 的指令、工具和行为)以及
+> **`Workflow`**(在基于图的流程中编排智能体与任务)。
### Agent
@@ -96,7 +95,7 @@ root_agent = Workflow(
)
```
-### Run Locally
+### 本地运行
```bash
# Interactive CLI
@@ -106,17 +105,17 @@ adk run path/to/my_agent
adk web path/to/agents_dir
```
-## 📚 Documentation
+## 📚 文档
-- **Getting Started**: https://google.github.io/adk-docs/
-- **Samples**: See `contributing/workflow_samples/` and
- `contributing/task_samples/` for workflow and task API examples.
+- **入门指南(Getting Started)**:https://google.github.io/adk-docs/
+- **示例(Samples)**:请参阅 `contributing/workflow_samples/` 和
+ `contributing/task_samples/`,了解工作流与任务 API 示例。
-## 🤝 Contributing
+## 🤝 贡献
-See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+详情请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
-## 📄 License
+## 📄 许可证
-This project is licensed under the Apache 2.0 License — see the
-[LICENSE](LICENSE) file for details.
+本项目采用 Apache 2.0 License 许可 — 详情请参阅
+[LICENSE](LICENSE) 文件。