Agent Development Kit (ADK) for Java

一个开源的、代码优先（code-first）的 Java 工具包，用于构建、评估和部署具有高灵活性和可控性的复杂 AI Agent。

重要链接： 文档 | 示例 | Python ADK

Agent Development Kit (ADK) 专为那些在构建与 Google Cloud 服务紧密集成的高级 AI Agent 时，追求细粒度控制和灵活性的开发者而设计。它允许您直接在代码中定义 Agent 行为、编排逻辑和工具使用，从而实现稳健的调试、版本控制，并支持从本地笔记本电脑到云端的随时随地部署。

---

✨ 核心特性

• 丰富的工具生态系统：利用预置工具、自定义函数、OpenAPI 规范或集成现有工具，赋予 Agent 多样的能力，并与 Google 生态系统实现深度集成。

• 代码优先的开发模式：直接使用 Java 定义 Agent 逻辑、工具和编排，以获得极致的灵活性、可测试性和版本控制能力。

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

🚀 安装

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

<dependency>
  <groupId>com.google.adk</groupId>
  <artifactId>google-adk</artifactId>
  <version>1.0.0-rc.1</version>
</dependency>

<dependency>
    <groupId>com.google.adk</groupId>
    <artifactId>google-adk-dev</artifactId>
    <version>1.0.0-rc.1</version>
</dependency>

若要使用未发布的版本，您可以使用 jitpack；请参阅此处获取相关示例。

📚 文档

请遵循以下 Java 文档和示例来构建、评估和部署 Agent：

• 文档
• 示例

🏁 特性亮点

与 Python ADK 相同的功能和熟悉的接口：

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

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())
    .build();

开发 UI

与广受好评的 Python 开发 UI 一致。 内置开发 UI 可帮助您测试、评估、调试和展示您的 Agent。

评估 Agent

即将推出...

🤖 A2A 与 ADK 集成

针对远程 Agent 到 Agent (A2A) 的通信，ADK 集成了 A2A 协议。 请参阅 a2a/README.md 获取端到端的设置说明和示例命令。

🤝 贡献

我们欢迎来自社区的贡献！无论是提交 Bug 反馈、功能需求、文档改进还是代码贡献，请查阅我们的 贡献指南 以开始。

📄 许可证

本项目采用 Apache 2.0 许可证 - 有关详细信息，请参阅 LICENSE 文件。

预览说明

本特性受 服务特定条款 中“Pre-GA 产品条款”的约束。Pre-GA 特性按“原样”提供，可能支持有限。有关更多信息，请参阅 产品发布阶段描述。

---

祝您 Agent 构建愉快！