Java 版代理开发工具包 (ADK)

一个开源、以代码为中心的 Java 工具包，用于构建、评估和部署具有高度灵活性和可控性的复杂 AI 代理。

重要链接： 文档 & 示例 & Python ADK。

代理开发工具包 (ADK) 专为希望在构建与 Google Cloud 服务紧密集成的高级 AI 代理时获得精细控制和灵活性的开发者而设计。它允许您直接在代码中定义代理的行为、编排和工具使用方式，从而实现强大的调试、版本管理和部署能力——无论是在您的笔记本电脑上还是在云端。

---

✨ 核心特性

• 丰富的工具生态系统：利用预构建的工具、自定义函数、OpenAPI 规范，或集成现有工具，为代理赋予多样化的功能，同时与 Google 生态系统紧密集成。

• 以代码为中心的开发：直接在 Java 中定义代理逻辑、工具和编排流程，以实现极致的灵活性、可测试性和版本管理。

• 模块化多代理系统：通过将多个专业代理组合成灵活的层次结构，设计可扩展的应用程序。

🚀 安装

如果您使用 Maven，请将以下内容添加到您的依赖项中：

<dependency>
  <groupId>com.google.adk</groupId>
  <artifactId>google-adk</artifactId>
  <version>1.1.0</version>
</dependency>
<!-- 开发 UI -->
<dependency>
    <groupId>com.google.adk</groupId>
    <artifactId>google-adk-dev</artifactId>
    <version>1.1.0</version>
</dependency>

如果您想使用尚未发布的版本，可以访问 https://jitpack.io/#google/adk-java/；请参阅 https://github.com/enola-dev/LearningADK#jitpack 以获取相关示例。

📚 文档

如需构建、评估和部署代理，请参考 Java 文档及示例：

• 文档
• 示例

🏁 功能亮点

与 Python ADK 具有相同的功能和熟悉界面：

import com.google.adk.agents.LlmAgent;
import com.google.adk.tools.GoogleSearchTool;

LlmAgent rootAgent = LlmAgent.builder()
    .name("search_assistant")
    .description("一个可以进行网络搜索的助手。")
    .model("gemini-2.0-flash") // 或您偏好的模型
    .instruction("您是一位乐于助人的助手。必要时请使用 Google 搜索回答用户问题。")
    .tools(new GoogleSearchTool())
    .build();

开发 UI

与广受欢迎的 Python 开发 UI 相同。内置开发界面，帮助您测试、评估、调试并展示您的代理。

评估代理

即将推出……

🤖 A2A 与 ADK 集成

为了实现远程代理间的通信，ADK 集成了 A2A 协议。请参阅 a2a/README.md 获取端到端的设置说明和示例命令。

🤝 贡献

我们欢迎社区的贡献！无论是漏洞报告、功能请求、文档改进，还是代码贡献，请参阅我们的 贡献指南 以开始参与。

📄 许可证

本项目采用 Apache 2.0 许可证授权——详细信息请参阅 LICENSE 文件。

预览

此功能受《服务特定条款》中“通用服务条款”部分的“GA 前产品条款”约束。GA 前功能按“现状”提供，可能支持有限。更多信息请参阅 发布阶段说明。

---

祝您构建愉快！

ADK for Java 快速上手指南

Agent Development Kit (ADK) 是 Google 推出的开源 Java 工具包，旨在帮助开发者以“代码优先”的方式构建、评估和部署复杂的 AI 智能体（Agents）。它提供了对智能体行为、编排和工具调用的细粒度控制，并深度集成 Google Cloud 生态。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS 或 Linux
• JDK 版本：建议安装 JDK 17 或更高版本
• 构建工具：Maven 3.6+ 或 Gradle
• Google Cloud 配置：
  • 需要有效的 Google Cloud 项目。
  • 需设置 GOOGLE_APPLICATION_CREDENTIALS 环境变量指向服务账号密钥文件，或已运行 gcloud auth application-default login 进行本地认证。
  • 确保已启用 Vertex AI API 及相关所需服务。

安装步骤

ADK for Java 已发布至 Maven Central，您可以直接在项目的 pom.xml 中添加依赖。

Maven 配置

在 pom.xml 的 <dependencies> 部分添加以下内容：

<!-- 核心库 -->
<dependency>
  <groupId>com.google.adk</groupId>
  <artifactId>google-adk</artifactId>
  <version>1.1.0</version>
</dependency>

<!-- 开发 UI (可选，用于本地调试和可视化) -->
<dependency>
    <groupId>com.google.adk</groupId>
    <artifactId>google-adk-dev</artifactId>
    <version>1.1.0</version>
</dependency>

提示：如果您需要使用尚未发布的快照版本，可以通过 JitPack 引入，具体参考项目仓库中的相关说明。

基本使用

ADK for Java 采用了与 Python 版本相似的直观接口。以下是一个最简单的示例，展示如何创建一个具备 Google 搜索能力的 LLM 智能体。

1. 创建智能体

使用 LlmAgent.builder() 定义智能体的名称、描述、模型、指令以及绑定的工具。

import com.google.adk.agents.LlmAgent;
import com.google.adk.tools.GoogleSearchTool;

public class QuickStart {
    public static void main(String[] args) {
        // 构建根智能体
        LlmAgent rootAgent = LlmAgent.builder()
            .name("search_assistant")
            .description("An assistant that can search the web.")
            .model("gemini-2.0-flash") // 指定使用的模型
            .instruction("You are a helpful assistant. Answer user questions using Google Search when needed.")
            .tools(new GoogleSearchTool()) // 绑定 Google 搜索工具
            .build();
        
        // 此处可添加运行逻辑或启动开发 UI
        System.out.println("Agent created successfully: " + rootAgent.getName());
    }
}

2. 使用开发 UI (Dev UI)

ADK 内置了一个强大的开发界面，帮助您测试、调试和展示智能体。如果您引入了 google-adk-dev 依赖，可以通过运行特定的主类或脚本来启动 Web 界面（具体启动方式请参考官方 Samples 仓库中的完整示例），从而在浏览器中直接与您的智能体交互。

下一步

• 查看文档：访问 官方文档 了解多智能体编排、自定义工具及评估功能。
• 获取示例：浏览 adk-samples 仓库获取更多完整的项目案例。