Go ADK Complete Guide

Master Google Agent Development Kit for Go (ADK Go) — 45 in-depth tutorials covering tool usage, memory management, multi-agent collaboration, streaming, deployment, with complete runnable code and flowcharts.

Learning Roadmap

Organized by modules, each containing 2-6 articles. Follow sequentially or jump to specific topics as needed.

Module filter: [All] [Environment] [Quickstart] [Tools] [Memory] [Team] [Streaming] [Deployment] [A2A] [Advanced] [Realworld]

Module 0: Introduction

Series Introduction & Learning Path

Background, goals, target audience, learning path recommendations Reading time: 10 min | Status: ✅ Published

Module 1: Environment & Installation

Go 1.24+ Installation & Verification

Go installation, version verification, environment variables Reading time: 15 min | Case: adk-go-env-verify-go | Status: ✅ Published

ADK Go Installation & Quick Verification

ADK Go installation, Hello World verification Reading time: 20 min | Case: adk-go-env-install-adk | Status: ✅ Published

Project Structure & .env Management

Directory structure, .env examples, gitignore best practices Reading time: 15 min | Case: adk-go-env-project-template | Status: ✅ Published

Module 2: Quick Start

Agent Core Concepts: Model, Tool, Instruction

Agent’s three elements: relationship of Model, Tool, Instruction Reading time: 20 min | Case: adk-go-quickstart-concepts | Status: ✅ Published

Hello World Agent

Minimal runnable Agent, CLI execution Reading time: 25 min | Case: adk-go-quickstart-hello-world | Status: ✅ Published

CLI vs Web: Execution Modes Comparison

Command-line vs web interface,各有适用场景 Reading time: 15 min | Case: adk-go-quickstart-run-modes | Status: ✅ Published

API Key & Model Selection

Gemini API Key acquisition, model selection (flash/lite/pro) Reading time: 15 min | Case: adk-go-quickstart-api-key | Status: ✅ Published

Module 3: Tool Usage

Function Tool Basics

Custom Go functions as Tools接入 Agent Reading time: 30 min | Case: adk-go-tools-function-basics | Status: ✅ Published

Function Tool Performance Optimization

Tool timeout, concurrency best practices Reading time: 25 min | Case: adk-go-tools-function-performance | Status: ✅ Published

MCP Server Integration

Connect to external servers via MCP Reading time: 30 min | Case: adk-go-tools-mcp-client | Status: ✅ Published

OpenAPI Tool: External APIs in Agent

Dynamic Tool generation from OpenAPI specs Reading time: 25 min | Case: adk-go-tools-openapi | Status: ✅ Published

Tool Confirmation & Security Authentication

User confirmation mechanism, API Key / OAuth authentication Reading time: 20 min | Case: adk-go-tools-confirmation | Status: ✅ Published

Module 4: Memory & Context

Session Management: Creation & Recovery

Session creation, persistence, recovery mechanism Reading time: 25 min | Case: adk-go-memory-session | Status: ✅ Published

State Read/Write: Agent Internal State

State read/write API, cross-turn state sharing Reading time: 20 min | Case: adk-go-memory-state | Status: ✅ Published

Event System: Understanding Agent Event Flow

Event types, EventHandler usage Reading time: 25 min | Case: adk-go-memory-event | Status: ✅ Published

Context Caching: Large Context Optimization

Cache context to reduce token consumption Reading time: 20 min | Case: adk-go-memory-context-caching | Status: ✅ Published

Context Compression: Context Compression

Compress historical messages, keep context lean Reading time: 20 min | Case: adk-go-memory-context-compression | Status: ✅ Published

Rewind Sessions: Session Rewind

Rewind Agent to historical state and re-execute Reading time: 25 min | Case: adk-go-memory-rewind | Status: ✅ Published

Module 5: Multi-Agent Collaboration

Agent Team Architecture

How multiple Agents collaborate, division of labor patterns Reading time: 20 min | Case: adk-go-team-intro | Status: ✅ Published

Sequential Workflow: Sequential Execution

Input → Agent A → Agent B → Output Reading time: 25 min | Case: adk-go-team-sequential | Status: ✅ Published

Parallel Workflow: Parallel Distribution

Input → [Agent A, Agent B] parallel → aggregated output Reading time: 25 min | Case: adk-go-team-parallel | Status: ✅ Published

Loop Workflow: Loop Execution

Loop calls until exit condition is met Reading time: 25 min | Case: adk-go-team-loop | Status: ✅ Published

Custom Workflow: Custom Workflow

Orchestrate Agent execution order per business logic Reading time: 30 min | Case: adk-go-team-custom | Status: ✅ Published

Agent Routing: Dynamic Next Agent Selection

Dynamic routing to appropriate Agent based on input Reading time: 25 min | Case: adk-go-team-routing | Status: ✅ Published

Module 6: Streaming Interaction

Streaming Principles & Event Model

Streaming output principles, Server-Sent Events mechanism Reading time: 20 min | Case: adk-go-streaming-principles | Status: ✅ Published

Event Handling: Real-time Agent Output Capture

Token-by-token output, incremental display Reading time: 25 min | Case: adk-go-streaming-event-handling | Status: ✅ Published

Multimodal: Audio, Image, Video Processing

Audio/video content input and processing Reading time: 25 min | Case: adk-go-streaming-multimodal | Status: ✅ Published

Streaming UI: Building Real-time Chat

Web frontend + Agent streaming interaction Reading time: 30 min | Case: adk-go-streaming-chat-ui | Status: ✅ Published

Module 7: Deployment & Operations

Agent Runtime Architecture

ADK Go runtime architecture, process model Reading time: 20 min | Case: adk-go-deploy-runtime | Status: ✅ Published

CLI Deployment: Production CLI Tool

Deploy and operate Agent via CLI Reading time: 25 min | Case: adk-go-deploy-cli | Status: ✅ Published

Web Interface Deployment & Maintenance

Web interface operations notes Reading time: 15 min | Case: adk-go-deploy-web | Status: ✅ Published

Docker Containerized Deployment

Write Dockerfile, image build and run Reading time: 30 min | Case: adk-go-deploy-docker | Status: ✅ Published

Cloud Run / GKE Deployment

Cloud deployment: logs, metrics, traces Reading time: 35 min | Case: adk-go-deploy-cloud | Status: ✅ Published

Module 8: A2A Protocol

A2A Protocol: Cross-Agent Communication

A2A protocol design, difference from MCP Reading time: 20 min | Case: adk-go-a2a-intro | Status: ✅ Published

Exposing: Expose Go Agent to External

Expose Go Agent via A2A Reading time: 30 min | Case: adk-go-a2a-expose | Status: ✅ Published

Consuming: Consume External Agent

Call agents exposed by other languages in Go Agent Reading time: 30 min | Case: adk-go-a2a-consume | Status: ✅ Published

Cross-Language Collaboration: Python + Go

Python ADK Agent + Go ADK Agent collaboration Reading time: 35 min | Case: adk-go-a2a-cross-language | Status: ✅ Published

Module 9: Advanced Topics

Grounding: Search-Enhanced Generation

Google Search Grounding integration Reading time: 25 min | Case: adk-go-advanced-grounding | Status: ✅ Published

Artifacts: Structured Content Generation

Generate code, Markdown and other structured content Reading time: 20 min | Case: adk-go-advanced-artifacts | Status: ✅ Published

Skills for Agents: Agent Skill Extension

Mount preset skills for Agent Reading time: 20 min | Case: adk-go-advanced-skills | Status: ✅ Published

Callbacks & Plugins: Lifecycle Hooks

Agent lifecycle callbacks, plugin mechanism Reading time: 25 min | Case: adk-go-advanced-callbacks | Status: ✅ Published

Module 10: Real-World Projects

End-to-End Project: Design to Deployment

Complete project: requirements → design → implementation → deployment Reading time: 60 min | Case: adk-go-realworld-full-project | Status: ✅ Published

Debugging Notes & Performance Tuning

Common issues and solutions, performance bottleneck troubleshooting Reading time: 30 min | Case: adk-go-realworld-debugging | Status: ✅ Published

Evaluation: Agent Effectiveness Evaluation

Evaluate Agent output quality, custom metrics Reading time: 25 min | Case: adk-go-realworld-evaluation | Status: ✅ Published

Resources

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