ck:google-adk-python

Google ADK Python Skill

Expert guide for Google's Agent Development Kit (ADK) Python — open-source, code-first toolkit for building, evaluating, and deploying AI agents. Optimized for Gemini, model-agnostic by design.

When to Activate

• Build single or multi-agent systems with tool integration
• Implement A2A protocol for remote agent communication
• Integrate MCP servers as agent tools
• Use workflow agents (sequential, parallel, loop) for pipelines
• Manage sessions, state, memory, and artifacts
• Add callbacks, plugins, or observability hooks
• Deploy to Cloud Run, Vertex AI Agent Engine, or GKE
• Evaluate agents with adk eval framework

Agent Structure Convention (Required)

my_agent/
├── __init__.py   # MUST: from . import agent
└── agent.py      # MUST: root_agent = Agent(...) OR app = App(...)

Quick Start

pip install google-adk          # stable (weekly releases)
uv sync --all-extras            # dev setup (uv required, Python 3.10+, 3.11+ recommended)

from google.adk import Agent

root_agent = Agent(
    name="assistant",
    model="gemini-2.5-flash",
    instruction="You are a helpful assistant.",
    description="General assistant agent.",
    tools=[get_weather],
)

App Pattern (Production)

from google.adk import Agent
from google.adk.apps import App
from google.adk.apps.app import EventsCompactionConfig
from google.adk.plugins.save_files_as_artifacts_plugin import SaveFilesAsArtifactsPlugin

app = App(
    name="my_app",
    root_agent=Agent(name="my_agent", model="gemini-2.5-flash", ...),
    plugins=[SaveFilesAsArtifactsPlugin()],
    events_compaction_config=EventsCompactionConfig(compaction_interval=2),
)

Use App when needing plugins, event compaction, or custom lifecycle management.

CLI Tools

Command	Purpose
adk web <agents_dir>	Dev UI (recommended for development)
adk run <agent_dir>	Interactive CLI testing
adk api_server <agents_dir>	FastAPI production server
adk eval <agent> <evalset.json>	Run evaluation suite