adk-go

环境要求

• 已安装 Go 开发环境（能执行 go 命令）
• 一个用于存放 Agent 代码的 Go 项目目录
• 可选：可访问 google.golang.org 拉取模块依赖

安装与启动步骤

1. 1确认 Go 环境

   先确认本机已安装 Go，后续 go get 与 go build 都依赖它。若未安装请先到 go.dev 下载安装。

   go version

   复制

2. 2初始化 Go 模块

   在项目目录中初始化模块，为引入 ADK 依赖做准备。模块名可换成你自己的仓库路径。

   go mod init example.com/myagent

   复制

3. 3安装 ADK Go

   README 给出的唯一安装命令，把 ADK Go 加入项目依赖，执行后 go.mod、go.sum 会更新。

   go get google.golang.org/adk/v2

   复制

4. 4查看官方示例

   README 指向 examples 目录，克隆仓库后进入 examples 参考现成的 Agent 写法再改自己的代码。

   git clone https://github.com/google/adk-go.git
   cd adk-go/examples

   复制

5. 5查阅官方文档

   README 首推的文档站，包含构建、评估、部署 Agent 的完整说明，建议照着文档写第一个 Agent。

如何确认成功

执行 go get 无报错，且 go.mod 中出现依赖 google.golang.org/adk/v2 即表示安装成功。

常见问题

注意事项

• README 只给出了 go get google.golang.org/adk/v2 这一条安装命令，具体 Agent 写法请以官方文档和 examples 为准。
• adk-go 当前处于成长阶段，接口可能变化，建议锁定依赖版本后再用于生产环境。
• 除安装外 README 未给出 API Key、端口、配置文件等说明，遇到这类配置请查阅 google.github.io/adk-docs。