Go ADK 实战完全指南

从零掌握 Google Agent Development Kit for Go（ADK Go）——45 篇深度教程覆盖工具使用、记忆管理、多 Agent 协作、流式交互、部署运维，附完整可运行代码与流程图。

学习路线图

本系列按模块组织，每个模块包含 2~6 篇文章。你可以选择按顺序学习，也可以根据需要选择性阅读。

模块过滤： [全部] [环境] [入门] [工具] [记忆] [协作] [流式] [部署] [A2A] [进阶] [实战]

模块 0：开篇

系列介绍与学习路线图

背景、目标、读者对象、学习路径建议 阅读时长：10 分钟 | 状态：✅ 已发布

模块 1：环境与安装

Go 1.24+ 安装与验证

Go 环境安装、版本验证、环境变量配置 阅读时长：15 分钟 | 配套案例：adk-go-env-verify-go | 状态：✅ 已发布

ADK Go 安装与快速验证

ADK Go 安装、Hello World 验证 阅读时长：20 分钟 | 配套案例：adk-go-env-install-adk | 状态：✅ 已发布

项目结构规范与 .env 管理

目录结构、.env 示例、gitignore 最佳实践 阅读时长：15 分钟 | 配套案例：adk-go-env-project-template | 状态：✅ 已发布

模块 2：快速入门

Agent 核心概念：Model、Tool、Instruction

Agent 的三要素：Model、Tool、Instruction 的关系 阅读时长：20 分钟 | 配套案例：adk-go-quickstart-concepts | 状态：✅ 已发布

Hello World Agent

最小可运行 Agent、CLI 运行方式 阅读时长：25 分钟 | 配套案例：adk-go-quickstart-hello-world | 状态：✅ 已发布

CLI vs Web：运行方式对比

命令行交互 vs Web 界面交互，各有适用场景 阅读时长：15 分钟 | 配套案例：adk-go-quickstart-run-modes | 状态：✅ 已发布

API Key 与 Model 选择

Gemini API Key 获取、Model 选型（flash/lite/pro） 阅读时长：15 分钟 | 配套案例：adk-go-quickstart-api-key | 状态：✅ 已发布

模块 3：工具使用

Function Tool 编写基础

自定义 Go 函数作为 Tool 接入 Agent 阅读时长：30 分钟 | 配套案例：adk-go-tools-function-basics | 状态：✅ 已发布

Function Tool 性能优化

Tool 超时、并发处理的工程实践 阅读时长：25 分钟 | 配套案例：adk-go-tools-function-performance | 状态：✅ 已发布

MCP Server 接入实战

通过 MCP 连接外部 Server 阅读时长：30 分钟 | 配套案例：adk-go-tools-mcp-client | 状态：✅ 已发布

OpenAPI Tool：将外部 API 纳入 Agent

通过 OpenAPI spec 动态生成 Tool 阅读时长：25 分钟 | 配套案例：adk-go-tools-openapi | 状态：✅ 已发布

Tool Confirmation 与安全认证

用户确认机制、API Key / OAuth 认证 阅读时长：20 分钟 | 配套案例：adk-go-tools-confirmation | 状态：✅ 已发布

模块 4：记忆与上下文

Session 管理：会话创建与恢复

会话的创建、持久化、恢复机制 阅读时长：25 分钟 | 配套案例：adk-go-memory-session | 状态：✅ 已发布

State 读写：Agent 内部状态

State 的读写 API、跨 turn 状态共享 阅读时长：20 分钟 | 配套案例：adk-go-memory-state | 状态：✅ 已发布

Event 系统：理解 Agent 的事件流

Event 类型、EventHandler 使用 阅读时长：25 分钟 | 配套案例：adk-go-memory-event | 状态：✅ 已发布

Context Caching：大上下文优化

缓存上下文减少 token 消耗 阅读时长：20 分钟 | 配套案例：adk-go-memory-context-caching | 状态：✅ 已发布

Context Compression：上下文压缩

压缩历史消息，保持上下文精简 阅读时长：20 分钟 | 配套案例：adk-go-memory-context-compression | 状态：✅ 已发布

Rewind Sessions：会话回溯

将 Agent 回溯到历史状态重新执行 阅读时长：25 分钟 | 配套案例：adk-go-memory-rewind | 状态：✅ 已发布

模块 5：多 Agent 协作

Agent Team 架构入门

多个 Agent 如何协同工作、分工模式 阅读时长：20 分钟 | 配套案例：adk-go-team-intro | 状态：✅ 已发布

Sequential 工作流：顺序执行

输入 → Agent A → Agent B → 输出 阅读时长：25 分钟 | 配套案例：adk-go-team-sequential | 状态：✅ 已发布

Parallel 工作流：并行分发

输入 → [Agent A, Agent B] 并行 → 聚合输出 阅读时长：25 分钟 | 配套案例：adk-go-team-parallel | 状态：✅ 已发布

Loop 工作流：循环执行

循环调用直到满足退出条件 阅读时长：25 分钟 | 配套案例：adk-go-team-loop | 状态：✅ 已发布

Custom Workflow：自定义工作流

根据业务逻辑编排 Agent 执行顺序 阅读时长：30 分钟 | 配套案例：adk-go-team-custom | 状态：✅ 已发布

Agent 路由：动态选择下一个 Agent

基于输入内容动态路由到合适的 Agent 阅读时长：25 分钟 | 配套案例：adk-go-team-routing | 状态：✅ 已发布

模块 6：流式交互

Streaming 原理与 Event 模型

流式输出原理、Server-Sent Events 机制 阅读时长：20 分钟 | 配套案例：adk-go-streaming-principles | 状态：✅ 已发布

Event 处理：实时捕获 Agent 输出

逐 token 输出、增量展示 阅读时长：25 分钟 | 配套案例：adk-go-streaming-event-handling | 状态：✅ 已发布

多模态：音频、图像、视频处理

音视频内容的输入与处理 阅读时长：25 分钟 | 配套案例：adk-go-streaming-multimodal | 状态：✅ 已发布

流式界面实战：构建实时聊天

Web 前端 + Agent 流式交互 阅读时长：30 分钟 | 配套案例：adk-go-streaming-chat-ui | 状态：✅ 已发布

模块 7：部署与运维

Agent Runtime 架构解析

ADK Go 运行架构、进程模型 阅读时长：20 分钟 | 配套案例：adk-go-deploy-runtime | 状态：✅ 已发布

CLI 部署：生产级命令行工具

通过 CLI 部署和运维 Agent 阅读时长：25 ���钟 | 配套案例：adk-go-deploy-cli | 状态：✅ 已发布

Web 界面部署与维护

Web 界面运维注意事项 阅读时长：15 分钟 | 配套案例：adk-go-deploy-web | 状态：✅ 已发布

Docker 容器化部署

编写 Dockerfile、镜像构建与运行 阅读时长：30 分钟 | 配套案例：adk-go-deploy-docker | 状态：✅ 已发布

Cloud Run / GKE 部署

云端部署：日志、Metrics、Traces 阅读时长：35 分钟 | 配套案例：adk-go-deploy-cloud | 状态：✅ 已发布

模块 8：A2A 协议

A2A 协议介绍：跨 Agent 通信

A2A 协议设计理念、与 MCP 的区别 阅读时长：20 分钟 | 配套案例：adk-go-a2a-intro | 状态：✅ 已发布

Exposing：暴露 Go Agent 给外部

将 Go Agent 通过 A2A 对外提供服务 阅读时长：30 分钟 | 配套案例：adk-go-a2a-expose | 状态：✅ 已发布

Consuming：消费外部 Agent

在 Go Agent 中调用其他语言暴露的 Agent 阅读时长：30 分钟 | 配套案例：adk-go-a2a-consume | 状态：✅ 已发布

跨语言协作实战：Python + Go

Python ADK Agent + Go ADK Agent 协作 阅读时长：35 分钟 | 配套案例：adk-go-a2a-cross-language | 状态：✅ 已发布

模块 9：进阶主题

Grounding：搜索增强生成

Google Search Grounding 集成 阅读时长：25 分钟 | 配套案例：adk-go-advanced-grounding | 状态：✅ 已发布

Artifacts：结构化内容生成

生成代码、Markdown 等结构化内容 阅读时长：20 分钟 | 配套案例：adk-go-advanced-artifacts | 状态：✅ 已发布

Skills for Agents：Agent 技能扩展

给 Agent 挂载预设技能 阅读时长：20 分钟 | 配套案例：adk-go-advanced-skills | 状态：✅ 已发布

Callbacks 与 Plugins：生命周期钩子

Agent 生命周期回调、插件机制 阅读时长：25 分钟 | 配套案例：adk-go-advanced-callbacks | 状态：✅ 已发布

模块 10：实战综合

端到端项目实战：从设计到部署

完整项目：需求 → 设计 → 实现 → 部署 阅读时长：60 分钟 | 配套案例：adk-go-realworld-full-project | 状态：✅ 已发布

踩坑记录与性能调优

常见问题与解决方案、性能瓶颈排查 阅读时长：30 分钟 | 配套案例：adk-go-realworld-debugging | 状态：✅ 已发布

Evaluation：Agent 效果评估

评估 Agent 输出质量、自定义指标 阅读时长：25 分钟 | 配套案例：adk-go-realworld-evaluation | 状态：✅ 已发布

配套资源

本系列持续更新中，关注公众号获取最新动态。