Go 语言的代理开发工具包 (ADK)

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

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

代理开发工具包 (ADK) 是一个灵活且模块化的框架，将软件开发原则应用于 AI 代理的创建。它旨在简化代理工作流的构建、部署和编排，从简单任务到复杂系统。尽管针对 Gemini 进行了优化，但 ADK 具有模型无关性、部署无关性，并与其他框架兼容。

此 Go 版本的 ADK 非常适合构建云原生代理应用的开发者，充分利用 Go 在并发性和性能方面的优势。

---

✨ 核心特性

• 符合 Go 语言习惯： 设计自然流畅，充分发挥 Go 的强大功能。
• 丰富的工具生态系统： 可使用预建工具、自定义函数，或集成现有工具，为代理赋予多样化的能力。
• 以代码为中心的开发： 直接在 Go 中定义代理逻辑、工具和编排流程，实现极致的灵活性、可测试性和版本控制。
• 模块化多代理系统： 通过组合多个专业化代理，设计可扩展的应用程序。
• 随处部署： 轻松将代理容器化并部署，对 Google Cloud Run 等云原生环境提供强力支持。

🚀 安装

要将 ADK Go 添加到您的项目中，请运行：

go get google.golang.org/adk

📄 许可证

本项目采用 Apache 2.0 许可证授权 - 详情请参阅 LICENSE 文件。

例外情况是 internal/httprr - 请参阅其 LICENSE 文件。

adk-go 快速上手指南

Agent Development Kit (ADK) for Go 是 Google 推出的开源工具包，专为构建、评估和部署复杂的 AI 智能体（Agent）而设计。它采用“代码优先”理念，充分利用 Go 语言在并发处理和性能方面的优势，适合开发云原生智能体应用。

环境准备

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

• 操作系统：Linux, macOS 或 Windows (支持 WSL2)。
• Go 版本：需安装 Go 1.21 或更高版本。
  • 检查版本命令：go version
  • 如未安装，请访问 Go 官网 下载。
• 依赖管理：项目需初始化 Go Module (go mod init)。
• 网络环境：由于模块托管在 google.golang.org，国内开发者若遇到下载超时，建议配置 GOPROXY 加速：

  export GOPROXY=https://goproxy.cn,direct
  # 或者
  go env -w GOPROXY=https://goproxy.cn,direct
  

安装步骤

在你的 Go 项目目录中，运行以下命令将 ADK 添加到依赖中：

go get google.golang.org/adk

安装完成后，建议在代码中引入包以验证安装：

import "google.golang.org/adk"

基本使用

ADK 的核心是通过代码定义智能体（Agent）、工具（Tools）和工作流。以下是一个最简化的示例，展示如何创建一个具备简单问候能力的智能体并运行它。

1. 创建主程序文件

新建 main.go 文件，编写如下代码：

package main

import (
	"context"
	"fmt"
	"log"

	"google.golang.org/adk/agent"
	"google.golang.org/adk/session"
)

func main() {
	ctx := context.Background()

	// 1. 定义一个简单的智能体
	// 这里假设你已配置好环境变量 GOOGLE_GENAI_API_KEY
	myAgent := agent.New("GreeterAgent", 
		agent.WithDescription("A simple agent that greets users."),
		agent.WithInstruction("You are a helpful assistant. Greet the user warmly."),
	)

	// 2. 创建会话
	sess, err := session.New(ctx, myAgent)
	if err != nil {
		log.Fatalf("Failed to create session: %v", err)
	}

	// 3. 发送消息并获取响应
	response, err := sess.SendMessage(ctx, "你好，请介绍一下你自己！")
	if err != nil {
		log.Fatalf("Failed to send message: %v", err)
	}

	// 4. 输出结果
	fmt.Println("Agent Response:", response.Text)
}

2. 配置 API 密钥

ADK 默认优化支持 Gemini 模型。在运行代码前，请确保设置了环境变量：

export GOOGLE_GENAI_API_KEY=你的_API_密钥

3. 运行程序

执行以下命令启动智能体：

go run main.go

如果一切正常，你将看到智能体返回的问候语。你可以在此基础上通过 agent.WithTools() 添加自定义工具，或使用 agent.NewMultiAgent() 构建多智能体协作系统。