ADK Go
用 Go 构建、评估、编排并部署复杂 AI Agent 工作流的代码优先工具包。
- Star 数
- ★ 8.9k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Go
- FA 评分
- 31/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- Go 云原生团队需要把 Agent 逻辑、工具和编排与现有 Go 服务一起维护和版本控制时。
- 不适合
- 希望用非 Go 语言构建 Agent 的开发者
- 只想开箱即用、不愿自己写代码编排 Agent 的用户
这个 Agent 能做什么，适合哪些场景？
ADK Go 是 Google 提供的开源 Go 工具包，用于构建、评估和部署复杂的 AI Agent。开发者直接在 Go 中定义 Agent 逻辑、工具和编排，因此代码可测试并可进行版本管理。它支持通过预构建工具、自定义函数或既有工具集成为 Agent 增加能力，并可组合多个专长 Agent 构建多 Agent 系统。项目强调云原生应用，可容器化，并提到对 Google Cloud Run 的强支持。它针对 Gemini 进行了优化，但 README 声明其模型无关、部署无关，并可与其他框架兼容。
开发者将 google.golang.org/adk/v2 加入 Go 项目后，可在 Go 代码中定义 Agent 逻辑、工具和编排流程。工具能力可来自预构建工具、自定义函数或已有工具集成；多个专长 Agent 可被组合为多 Agent 应用。项目将其工作范围描述为构建、评估、部署和编排 Agent 工作流，并支持将应用容器化、部署到包括 Google Cloud Run 在内的云原生环境。所给资料未提供具体的 Go 类型、函数调用、运行入口、输入输出格式或首个可执行示例。
- Go 云原生团队需要把 Agent 逻辑、工具和编排与现有 Go 服务一起维护和版本控制时。
- 需要将多个专长 Agent 组合为一个多 Agent 工作流的应用开发者。
- 希望为 Agent 接入预构建工具、自定义 Go 函数或既有工具集成的工程团队。
- 计划将 Go Agent 应用容器化，并部署到 Google Cloud Run 等云原生环境的团队。
- 以 Gemini 为主要模型、但希望保留模型和部署选择空间的开发者。
如何安装或部署这个 Agent？
在 Go 项目目录运行：
go get google.golang.org/adk/v2资料未说明所需 Go 版本、凭据、环境变量、模块初始化前提或依赖安装细节。
如何使用这个 Agent？
资料只说明开发者可直接在 Go 中定义 Agent 逻辑、工具与编排，并将多个专长 Agent 组合为多 Agent 应用；没有提供可复制的 API 示例、首个运行命令、运行时入口、凭据配置、输入输出格式或部署配置。因此，无法仅根据所给证据给出经过验证的首次调用步骤，也无法确认创建 Agent、连接模型或执行工作流所需的具体代码。
这个 Agent 有哪些优点和局限？
- 以 Go 为中心：Agent 逻辑、工具和编排直接定义在 Go 代码中。
- 明确支持由多个专长 Agent 组成的模块化多 Agent 系统。
- 工具接入方式覆盖预构建工具、自定义函数和既有工具集成。
- 面向云原生部署，可容器化，并明确提到对 Google Cloud Run 的强支持。
- 所给资料没有提供具体 API、可执行示例或运行入口，首次集成仍需查找额外文档。
- 未说明所需 Go 版本、认证方式、环境变量或模型连接配置。
- 虽然声明模型无关，但资料没有列出已验证的非 Gemini 模型提供商或适配方式。
- 评估能力被列为项目目标，但未给出评估接口、指标或执行流程。
这个 Agent 与同类方案有什么区别？
仓库还链接了 Python、Java、Kotlin 和 TypeScript 版本的 ADK，但所给资料未说明这些版本与 Go 版本在功能或兼容性上的差异。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ADK Go 当前 | 31 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 8.9k | 今天 | Go | — |
| Google ADK TypeScript 开发套件 | 51 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.5k | 7 天前 | TypeScript | — |
| AI Agent 工程学习手册 | 55 · 缺口较多 | 开发框架免费 | ★ 651 | 13 天前 | HTML | — |
| Hello-Agents 智能体教程 | 54 · 缺口较多 | 网页应用免费 + 模型费 | ★ 86k | 23 天前 | Python | OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示仓库由Google官方组织发布，但未提供权限管理、用户确认、数据流透明性、敏感数据处理、依赖安全、外部影响或回滚机制的具体实现或文档。因此，除来源归属外，其余标准均因证据不足而评为0。来源归属得2分，因为发布者身份明确且仓库归属清晰。
自一致性得2分，因为README和go.mod等文件在版本和模块路径上保持一致。依赖可用性得2分，因为go.mod列出了大量依赖，但未提供可用性保证。失败消息得1分，因为README提到了mock上下文中的错误处理，但未提供全面的失败消息策略。
受众和场景得1分，因为README提到了面向Go开发者的Agent开发工具包，但未详细说明目标受众。能力边界得1分，因为README提到了breaking changes，但未明确说明能力边界。触发精度得1分，因为README提到了context.Context的使用，但未详细说明触发条件。环境适配得1分，因为go.mod和CI配置表明支持Go环境，但未详细说明其他环境。
信息架构得1分，因为README提供了breaking changes信息，但未提供完整的文档结构。安装说明得1分，因为go.mod提供了模块路径，但未提供安装步骤。命名稳定性得1分，因为README提到了版本2.0，但未提供命名约定。示例和FAQ得1分，因为README提供了代码示例，但未提供FAQ。已知限制得1分，因为README提到了breaking changes，但未明确列出已知限制。许可证得3分，因为LICENSE文件完整提供了Apache 2.0许可证。版本控制和变更日志得1分，因为README提到了版本2.0，但未提供变更日志。维护责任得2分，因为发布者身份明确，但未提供维护计划。
输出可用性得1分，因为README提供了代码示例，但未提供完整的输出格式。边际价值得1分，因为该工具包提供了Agent开发功能，但未与其他工具比较。成本效益得1分，因为开源免费，但未提供性能或资源消耗信息。
声明可追溯性得1分，因为README提到了PR链接，但未提供完整的声明来源。跨来源佐证得1分，因为go.mod和CI配置相互印证，但未提供外部验证。事实与推断分离得1分，因为README区分了breaking changes和迁移建议，但未明确区分事实和推断。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 静态审查无法验证实际运行行为，所有关于安全、可靠性和有效性的结论均基于文件内容推断。
- 仓库未提供权限管理、用户确认、数据流透明性等安全特性的具体实现或文档，使用前需自行评估。
- 依赖众多且未提供安全审计报告，建议使用前运行govulncheck等工具检查依赖漏洞。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
plugin/agentanalytics/v0.1.0 plugin/agentanalytics v0.1.0
发布说明摘录
The first release of the BigQuery Agent Analytics plugin for ADK Go. It logs every agent run to a BigQuery table, so you can query and dashboard agent behavior with SQL: invocations, model requests and responses, tool calls, state changes, agent transfers and human-in-the-loop requests. The table schema, event type names and analytics views match adk-python's BigQuery Agent Analytics plugin, so Go and Python agents can write to the same table and be queried together. Install ```bash go get google.golang.org/adk/plugin/[email protected] ``` …在 GitHub 查看 ↗ -
发布说明摘录
[2.7.1](https://github.com/google/adk-go/compare/v2.7.0...v2.7.1) (2026-11-04) Bug Fixes * agentanalytics: classify Write API errors and split oversized batches ([#2016](https://github.com/google/adk-go/issues/2016)) ([2466e97](https://github.com/google/adk-go/commit/2466e976ac371b8e2074315c70cbbdaf9b1f2498)) * model/openaimodel: refuse media in system and developer Responses messages ([#2025](https://github.com/google/adk-go/issues/2025)) ([40f132d](https://github.com/google/adk-go/commit/40f132d697752596c79d307c4ef2bfb70c55ad9c)) …在 GitHub 查看 ↗ -
发布说明摘录
Highlights v2.7.0 adds Anthropic Claude as a first-party model, search-gated tool discovery for large tool catalogs, an experimental classifier API for workflow routing, and a per-invocation budget on model calls. It also switches telemetry to the OpenTelemetry GenAI semantic conventions by default, which is a breaking change for anyone consuming ADK traces. …在 GitHub 查看 ↗
常见问题
它只能使用 Gemini 吗？
能部署到 Google Cloud Run 吗？
使用它需要哪些凭据？
许可证是什么？
internal/httprr 是 README 明确指出的例外，并有其自身许可证文件。