ScriptsApr 1, 2026·2 min read

Google ADK — Official AI Agent Dev Kit

Google's open-source Agent Development Kit for building, evaluating, and deploying AI agents in Python. 18.7K+ stars. Multi-agent, tool use, eval. Apache 2.0.

TL;DR
Google ADK is Google's official open-source Python toolkit for building, evaluating, and deploying AI agents with multi-agent orchestration and tool use.
§01

What it is

Google ADK (Agent Development Kit) is Google's official open-source Python toolkit for building AI agents. It provides a code-first framework for defining agents with tool use, multi-agent orchestration, evaluation, and deployment capabilities. ADK supports Gemini models natively and integrates with the Google AI ecosystem.

ADK targets Python developers building AI agents who want an officially supported framework from Google. It handles agent definition, tool binding, conversation management, multi-agent delegation, and evaluation in a unified API.

§02

How it saves time or tokens

ADK provides the scaffolding for agent development that you would otherwise build yourself: tool registration, conversation state management, multi-agent routing, and evaluation harnesses. The CLI (adk create, adk run, adk eval) accelerates the development loop. Built-in evaluation tools let you test agent behavior systematically before deployment.

§03

How to use

  1. Install ADK: pip install google-adk.
  2. Create an agent project: adk create my_agent.
  3. Define your agent, add tools, and run it: adk run my_agent.
§04

Example

from google.adk import Agent, Tool

# Define a tool
@Tool
def search_docs(query: str) -> str:
    '''Search documentation for relevant information.'''
    # Your search implementation
    return f'Results for: {query}'

# Create an agent
agent = Agent(
    name='doc_assistant',
    model='gemini-2.0-flash',
    tools=[search_docs],
    instruction='You are a documentation assistant. Use search_docs to find answers.'
)

# Run via CLI
# adk run doc_assistant
# CLI workflow
pip install google-adk
adk create my_agent
adk run my_agent
adk eval my_agent --test-file tests.json
§05

Related on TokRepo

§06

Common pitfalls

  • ADK is optimized for Gemini models. While other models may work through adapters, Gemini gets the best support for tool calling and multi-turn conversations.
  • Multi-agent orchestration adds complexity. Start with a single agent and add delegation only when a single agent cannot handle the task scope.
  • Evaluation test files require structured input/output pairs. Invest in creating good test cases early to catch agent regressions.

Frequently Asked Questions

What models does Google ADK support?+

ADK is designed for Gemini models (gemini-2.0-flash, gemini-2.0-pro, etc.) through the Google AI API or Vertex AI. It may support other models through adapter layers, but Gemini gets first-class support.

How does multi-agent work in ADK?+

ADK supports multi-agent orchestration where a supervisor agent delegates tasks to specialized sub-agents. Each agent has its own tools and instructions. The supervisor routes requests based on the task type.

Can I deploy ADK agents to production?+

Yes. ADK agents can be deployed as APIs using standard Python web frameworks. Google also provides deployment options through Vertex AI for managed hosting with auto-scaling.

How does evaluation work?+

ADK includes an evaluation framework where you define test cases (input, expected output) in JSON files. Run adk eval to test your agent against these cases and get pass/fail results with detailed comparison.

Is Google ADK free?+

Yes. ADK is open-source under the Apache 2.0 license. You pay only for the LLM API calls (Gemini API or Vertex AI). The framework itself is free.

Citations (3)

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets