This commit is contained in:
wehub-resource-sync
@@ -1,3 +1,9 @@
|
||||
<!-- WEHUB_ZH_README -->
|
||||
> [!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 @@
|
||||
<img src="https://raw.githubusercontent.com/google/adk-python/main/assets/agent-development-kit.png" width="256"/>
|
||||
</h2>
|
||||
<h3 align="center">
|
||||
An open-source, code-first Python framework for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
|
||||
一个开源、代码优先（code-first）的 Python 框架，用于以灵活性和可控性构建、评估和部署复杂的 AI 智能体。
|
||||
</h3>
|
||||
<h3 align="center">
|
||||
Important Links:
|
||||
<a href="https://google.github.io/adk-docs/">Docs</a>,
|
||||
<a href="https://github.com/google/adk-samples">Samples</a> &
|
||||
<a href="https://github.com/google/adk-web">ADK Web</a>.
|
||||
重要链接：
|
||||
<a href="https://google.github.io/adk-docs/">Docs</a>、
|
||||
<a href="https://github.com/google/adk-samples">Samples</a> 与
|
||||
<a href="https://github.com/google/adk-web">ADK Web</a>。
|
||||
</h3>
|
||||
|
||||
______________________________________________________________________
|
||||
|
||||
> **⚠️ 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) 文件。
|
||||
|
||||
Reference in New Issue
Block a user