ak-google-adk-python

name	ak:google-adk-python
description	Build AI agents with Google ADK Python. Multi-agent systems, A2A protocol, MCP tools, workflow agents, state/memory, callbacks/plugins, Vertex AI deployment, evaluation.
user-invocable	true
when_to_use	Invoke for Google ADK agents, A2A, MCP, or Vertex deployment.
category	ai-ml
keywords	["google-adk","agents","a2a","mcp","vertex-ai"]
license	Apache-2.0
argument-hint	[agent or feature]
metadata	{"author":"agentkit","version":"2.0.0"}

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),
)