Skip to content
Building Agents with Google ADK
On Trove · from Matan Marudi

Building Agents with Google ADK

Complete developer reference for building, orchestrating, evaluating, and deploying agents with Google ADK (Python).

Read a preview

You can read the contents and the first 2,000 characters.
Free accounts get the whole book.

  • By Matan Marudi
  • 19 chapters
  • Updated Nov 2, 2026
  • 57 readers

What’s inside

  • Core Concepts
  • Building Your First Agent
  • Tools Deep Dive
  • Multi-Agent Systems
  • Session Management & State
  • Memory Services

What is Building Agents with Google ADK?

Complete developer reference for building, orchestrating, evaluating, and deploying agents with Google ADK (Python). Covers tools, multi-agent systems, memory, callbacks, plugins, and production deployment.

markdown · Listed Mar 21, 2026

  • gemini
  • adk
  • google

From the first page

Google ADK is an open-source, code-first Python framework for building, evaluating, and deploying AI agents. Model-agnostic (Gemini, Anthropic, Ollama, etc.) and deployment-agnostic (Cloud Run, Vertex AI Agent Engine).

Languages: ADK ships for Python (latest 2.2.0) and Java (latest 1.4.0, Maven com.google.adk:google-adk:1.4.0), plus TypeScript/Go in earlier-stage support. The abstractions in this chapter are shared across languages; CLI/import examples in this book are Python unless noted. Source: https://central.sonatype.com/artifact/com.google.adk/google-adk (1.4.0);

Preview · 2,000 of 79,521 characters

SEO for AI Agents
Bambu Lab P2S & P1S Complete Reference: Settings, Calibration & Enclosed Printing for Claude Code
FluxCD Official Documentation: The Complete Guide to GitOps on Kubernetes
Kubernetes: Official Documentation

Contents

  1. 01Building Agents with Google ADKp.1
    1. A Developer's Reference for Production Agent Developmentp.1
  2. 02Core Conceptsp.2
    1. The 7 Core Abstractionsp.2
    2. Installation & Scaffoldingp.2
  3. 03Decision Matrixp.3
  4. 04Building Your First Agentp.4
    1. CLI Commandsp.4
  5. 05Tools Deep Divep.5
    1. Tool Typesp.5
    2. AgentTool — Agent as Toolp.5
    3. YAML Tool Configp.5
  6. 06Multi-Agent Systemsp.6
    1. Orchestration Patternsp.6
    2. Hierarchical Planner/Executorp.6
    3. YAML Multi-Agent Configp.6
    4. Agent Registry (v1.26+)p.6
    5. Workflow Runtime (v1.27+)p.6
    6. Task API (v1.27+)p.6
    7. Agent-to-Agent (A2A) Protocolp.6
  7. 07Session Management & Statep.7
    1. Session Backendsp.7
  8. 08Memory Servicesp.8
See all 19 parts
  1. 09Callbacksp.9
  2. 10Pluginsp.10
  3. 11Local Development, Testing & Evaluationp.11
    1. `adk run` — Terminal Testingp.11
    2. `adk web` — Browser Development UIp.11
    3. `adk api_server` — API Server for Integration Testingp.11
    4. Evaluation with `adk eval`p.11
    5. `adk optimize` — Instruction Improvement (v1.27+)p.11
    6. Conformance Testingp.11
    7. Testing Workflow (Recommended Order)p.11
  4. 12Deployment & Observabilityp.12
    1. Deploymentp.12
    2. Observabilityp.12
    3. Production Checklistp.12
  5. 13Quick Referencep.13
    1. Full CLI Referencep.13
    2. Agent Parameter Cheat Sheetp.13
  6. 14Gemini Best Practices for ADK Agentsp.14
    1. Model Selection: Flash vs Prop.14
    2. Writing Agent `instruction` (System Prompts)p.14
    3. Writing Tool Descriptions (Function Calling)p.14
    4. Multi-Turn & Agentic Patternsp.14
    5. Thinking Mode (Chain-of-Thought)p.14
    6. Temperature & Samplingp.14
    7. Structured Outputp.14
    8. ADK Agent Design Dimensions *(p. 125)*p.14
    9. +1 more section
  7. 15ADK Dev Skills — Coding with AIp.15
    1. The 6 Official ADK Skillsp.15
    2. ADK Docs MCP Server (Live Docs in Your Editor)p.15
    3. The Agent Skills Format (Write Your Own)p.15
  8. 16ADK 2.0 — Now GAp.16
    1. What shipped in 2.0 GA (2026-05-19)p.16
    2. Added since GAp.16
    3. Three Major Additionsp.16
    4. Migration Checklist (1.x → 2.0)p.16
  9. 17Project Structure & Folder Conventionsp.17
    1. The Required Agent Structurep.17
    2. Single-Agent Project Layoutp.17
    3. Multi-Agent Project Layoutp.17
    4. Where to Put Whatp.17
    5. Running the CLI Against Your Structurep.17
    6. Production / Cloud Run Layoutp.17
    7. Common Structure Mistakesp.17
  10. 18Version Migration & Breaking Changesp.18
    1. 1.x → 2.0 migration (2.0 GA: 2026-05-19)p.18
    2. 1. Types Module Moved: `google.adk.types` → `google.genai.types`p.18
    3. 2. `SkillToolset` Constructor Changedp.18
    4. 3. Dependency Pinning — Let pip Resolve Transitive Depsp.18
    5. 4. APIs Unchanged in 1.27.2p.18
    6. Full Import Map for 1.27.2p.18
  11. 19Appendix: Rules & Gotchasp.19
    1. Chapter 18: Deep Dives — Auth, Realtime, Review, and Onboardingp.19