ADK for Go 智能体开发套件

它是什么

ADK Go 是 Agent Development Kit（ADK）的 Go 版本。ADK 是谷歌开源的框架，用代码构建 AI 智能体。智能体本身、它用的模型、它的工具，以及几个智能体怎样配合，都用普通的 Go 来写，所以能像服务里的其他代码一样测试和做版本管理。README 说 ADK 针对 Gemini 做了优化，但不绑定模型，仓库里也有 Claude 和 OpenAI 的示例。2.0 版自 2026 年 6 月 30 日起正式发布（GA），加入了图工作流，能把模型步骤和普通的 Go 函数混在一起，还加入了由人确认工具调用的功能。编译进程序里的启动器（launcher）能把它跑成终端对话、网页聊天页、REST API 或 A2A 服务器。

1. 你用 Go 写一个智能体：模型、指令和工具
2. go get 把 google.golang.org/adk/v2 加进你的模块
3. go run agent.go 在终端里开始对话
4. web api webui 在 8080 端口提供聊天页面
5. adkgo 把同一个程序部署到 Cloud Run

适合谁

想把智能体放进自己服务里的 Go 开发者，沿用他们已经在用的类型、测试和单个可执行文件。用 Google Cloud 的团队得到的帮助最多，因为 README 点名了 Cloud Run，部署工具也以它为目标。Python、Java、Kotlin 和 TypeScript 团队各有自己的 ADK 版本。

如果你想不写代码就搭建智能体，可以不用它。网页界面里的可视化构建器（Visual Builder）只支持 Python，文档里评估智能体的那一页也只支持 Python。

用在哪里

README 说 ADK 不绑定部署方式。快速入门给出了 macOS 和 Linux 的步骤，以及 Windows 上 PowerShell 和命令提示符的写法。

• macOS 和 Linux：快速入门里的 shell 命令，密钥放在 .env 文件里
• Windows：同样的 Go 命令，用 env.bat 代替 .env
• Google Cloud Run：adkgo 工具负责构建和部署程序，不用自己写 Dockerfile
• Claude Code、Cursor 和 Antigravity：一个 MCP 服务器，让它们在帮你写代码时读取 ADK 文档
• 其他编程智能体：llms.txt 和 llms-full.txt，也就是纯文本形式的文档

模型：Gemini 可以用 API 密钥或通过 Google Cloud 调用。Claude 可以走 Vertex AI 或 Anthropic API。OpenAI，或提供 Responses API 或 Chat Completions API 的兼容服务商，也可以。

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，里面按 ADK 文档列出了每个平台的步骤。主要途径是 Go 快速入门：一个文件夹、一个 Go 文件和一个 Gemini 密钥。

1. 建一个文件夹和两个文件。文件是 agent.go 和 .env，在 Windows 上快速入门用 env.bat 代替 .env。
2. 复制快速入门的代码。把它粘进 agent.go，它的智能体用 gemini-flash-latest 模型和内置的 Google Search 工具，并从 GOOGLE_API_KEY 读取你的密钥。
3. 运行三行模块命令。它们创建模块、加入 ADK Go 2.0，再拉取导入语句需要的包。
4. 把 Gemini 密钥存进 .env。第二段代码是 macOS 和 Linux 的写法，两种 Windows 写法在工具包里。
5. 用 go run agent.go 启动。按快速入门注释里说的，先加载 .env。

go mod init my-agent/main
go get google.golang.org/adk/v2
go mod tidy

echo 'export GOOGLE_API_KEY="YOUR_API_KEY"' > .env
# Remember to load keys and settings: source .env OR env.bat
go run agent.go

如何使用

go run agent.go 后面跟的关键字决定智能体怎么运行。什么都不加，它就在终端里对话。

在聊天页面的左上角选中你的智能体，然后输入请求。页面会列出你的会话、会话状态，以及每个回答背后的全部事件，让你一步步看清它做了什么。想从自己的代码里调用智能体，就启动 API。API Server 页面给了一行 Go 命令，把它改到 8000 端口并去掉前缀，这样页面上的 curl 示例就能照原样使用。

go run agent.go web -port 8000 api -path_prefix ""

在第二个终端里，向 /apps/<app>/users/<user>/sessions/<session> 发一个 POST 来创建会话。之后每条消息都 POST 到 /run，带上应用、用户和会话的 ID。/run 把这一轮的事件作为一个列表一次返回，/run_sse 则以流的形式逐个发送。

示例

你想让一个智能体去用另一个作为独立服务运行的智能体。A2A 快速入门的 a2a_basic 示例里有一个根智能体，它带着一个本地的掷骰子智能体，另有一个通过 A2A 在 8001 端口提供的质数检查智能体。两个都跑起来后，你对根智能体输入：

roll a die and check if it's a prime

根智能体把掷骰子交给 roll_agent，它用六个面调用 roll_die。接着 transfer_to_agent 把这个数交给另一台服务器上的 prime_agent，它调用 prime_checking。在文档的那次运行里，骰子掷出 3，回复是“3 is a prime number.”（3 是质数）。

新手与专家

新手：智能体就是一个语言模型，加上指令和它可以调用的工具，比如网页搜索或你自己写的某个函数。在 ADK Go 里，你用 llmagent.New 建一个智能体，给它名字、模型和指令，再交给启动器。先从快速入门的智能体和它的聊天页面开始，页面上的事件会显示智能体为每个回答做了什么。然后用 functiontool.New 加一个你自己的工具。如果有编程智能体和你一起写代码，就让它去读 llms-full.txt。README 说这个文件里有 Go API 参考和示例。

专家：2.0 的图引擎把智能体、工具和函数都当作节点。workflow.NewFunctionNode 包装一个 Go 函数，workflow.Chain 按顺序连接节点，每个节点带类型的返回值经由 event.Output 传给下一个，不用写会话状态。路由节点设置 event.Routes，再由 StringRoute、IntRoute 或 BoolRoute 的边选出分支。NewJoinNode 等待并行的分支汇合，workflowagent.New 把整张图变成一个标准的 agent.Agent。工作流示例里还有等人输入的暂停，以及用 NewDynamicNode 写成普通 Go 代码的编排。

状态写在代码里，不靠命令行参数。Go 的终端模式没有保存、恢复和重放选项，Go 的 API 服务器也没有 Swagger 页面和更新会话的 PATCH 路由。你要在 launcher.Config 里传入一个持久化的 session.Service，比如 session/database。从 1.x 升级要改用 /v2 导入路径，session.NewEvent 的第一个参数变成 context，事件还多了五个新字段。v2.2.0 之前的版本把其中三个字段按 Go 字段名存储，所以结构固定的数据库要两种写法都接受。

注意事项

ADK Go 是一个库，你在哪里运行它，它就在哪里运行。哪些数据会离开你的电脑，取决于你给智能体配的模型和工具。

• 模型调用：你的提示词和工具结果会发给你配置的服务商，用的是你自己的密钥或 Google Cloud 账号。快速入门的智能体还用了 Gemini 内置的 Google Search 工具
• 使用数据：网页界面页面说，ADK Web UI 的匿名使用统计默认关闭，你在 User Settings 里打开后才会收集。这个选择保存在 ~/.adk/config.json
• 只用于开发：快速入门说 ADK Web 不适合生产环境。adkgo 默认带 --no-allow-unauthenticated 部署到 Cloud Run，并通过本地代理访问这个服务
• Go 版本：README 和 go.mod 要求 Go 1.26.10 或更新，快速入门和安装页面仍写着 1.25
• 实验性：两篇 A2A 快速入门都把 ADK Go 的 A2A 标为实验性功能
• 安全：安全页面把经由工具结果的提示词注入列为一种风险。它建议在网页里显示模型输出前先转义，并在沙箱里运行模型写的代码。MCP 页面建议只开放智能体需要的工具
• 移除：没有要卸载的东西。ADK Go 只是你 go.mod 里的一个模块，工具包里写了怎么把它去掉
• 许可证：Apache-2.0。README 说 internal/httprr 有自己的 LICENSE 文件