Skip to content

欢迎使用 ADK 2.0 Alpha

Alpha Release

ADK 2.0 是一个 Alpha 发布版，与之前的 ADK 版本一起使用时可能会导致破坏性变更。如果你需要向后兼容性（例如在生产环境中），请不要使用 ADK 2.0。我们鼓励你测试此版本，并欢迎提供你的反馈！

ADK 2.0 引入了用于构建复杂 AI 智能体的强大工具，并帮助你构建能够以更强的控制力、可预测性和可靠性执行挑战性任务的智能体。ADK 2.0 目前作为 Python 的 Alpha 版本提供，包含以下关键特性：

  • 基于图的工作流：构建确定性的智能体工作流，更精细地控制任务的路由和执行方式。

  • 协作智能体：通过协调者智能体和多个子智能体协同工作，构建复杂的智能体架构。

  • 动态工作流：使用基于代码的逻辑构建更复杂的工作流，包括迭代循环和复杂的基于决策的分支。

查看上面链接的主题以获取更多信息，并尝试使用 ADK 2.0 构建智能体的新方法！

ADK 1.0 兼容性

ADK 2.0 旨在兼容使用 ADK 1.x 版本开发的智能体。然而，考虑到使用 ADK 1.x 构建的智能体数量和多样性，我们预计某些智能体实现（特别是功能高级且丰富的智能体）会在 ADK 2.0 中发现不兼容问题。在当前的 GA 前发布期间，我们请求你协助我们识别这些问题，以便我们有机会解决它们。请通过我们的 问题追踪器 报告你遇到的任何 ADK 1.0 到 ADK 2.0 的不兼容性。

警告：请勿混用 ADK 2.0 和 ADK 1.0 的数据存储系统

如果你在 ADK 2.0 项目中使用持久化存储，请勿让 ADK 2.0 项目与 ADK 1.0 项目共享存储，包括但不限于会话存储、记忆系统和评估数据。这样做可能会导致数据丢失或使数据在 ADK 1.0 项目中无法使用。

安装 ADK 2.0

由于 ADK 2.0 目前是 GA 前的发布版本，它不会自动安装。你必须将其作为一个安装选项进行选择。此版本有以下系统要求：

  • Python 3.11 或更高版本
  • 用于安装包的 pip

要安装 ADK 2.0，请按照以下步骤操作：

  1. 启用 Python 虚拟环境。请参阅下文的说明。

  2. 使用 pip 安装包，并使用 --pre 参数来选择当前的 ADK 2.0 GA 前版本：

    pip install google-adk --pre
推荐：创建并激活 Python 虚拟环境

创建 Python 虚拟环境：

python -m venv .venv

激活 Python 虚拟环境：

.venv\Scripts\activate.bat

.venv\Scripts\Activate.ps1

source .venv/bin/activate

注意：更新现有的 ADK 1.0 项目

如果你已经在 Python 环境中安装了 ADK 1.0 库，--pre 选项不会安装 ADK 2.0 库。你可以通过在上述安装命令中添加 --force 选项来强制安装 ADK 2.0 库。请记住为 ADK 2.0 使用 Python 虚拟环境，并在将 ADK 1.0 项目更新为使用 ADK 2.0 库 之前 确保已备份这些项目。

下一步

阅读开发指南，了解如何使用 ADK 2.0 特性构建智能体：

查看这些 ADK 2.0 代码示例以进行测试并获取灵感：

感谢你关注 ADK 2.0！我们期待你的 反馈！