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](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](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 智能体。

- Important Links: - Docs, - Samples & - ADK Web. + 重要链接: + Docs、 + Samples 与 + ADK Web

______________________________________________________________________ -> **⚠️ 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) 文件。