Google ADK Examples
Google Agent Development Kit (ADK) is a framework for building LLM agents using Google's Gemini models. AgentVisor integrates natively with ADK — your agents run inside a hardened sandbox with policy enforcement, credential brokering, and durable session state via the Thread State API.
Prerequisites
- Google AI API key — the examples use Gemini via the AgentVisor proxy
- Temporal — required for durable execution
- AgentVisor CLI —
agentvisor serve .starts the runtime
Examples
| Example | Difficulty | Key Feature |
|---|---|---|
| Research Agent | Intermediate | Web research with stateful multi-turn conversation |
How It Works
ADK agents in AgentVisor work through the ADK framework provider:
- Discovery: AgentVisor detects
agent.yamland selects the ADK provider automatically - Schema extraction: Agent name and description are read from
agent.yaml - Execution:
python3 -m agentvisor.adk.runnerdiscoversroot_agent, wiresAgentVisorSessionService, and runs the agent inside the sandbox - Session state: ADK's
SessionStateis automatically routed to the Thread State API for durable, thread-scoped persistence
State Scope Routing
ADK has four state scopes, each backed by a different AgentVisor storage primitive:
| ADK Scope | Prefix | Backend | Lifetime |
|---|---|---|---|
| Session state | (none) | Thread State API | Per-thread (durable) |
| User state | user: | Store API | Per-principal |
| App state | app: | Store API | Global |
| Temp state | temp: | In-memory | Request only |
Key Concepts
| Concept | What It Is | Where You'll See It |
|---|---|---|
agent.yaml | Discovery file with agent name and description | All examples |
register_agent() | Registers root agent for schema extraction | All examples |
AgentVisorSessionService | Wired automatically by the runner | Transparent to agent code |
| Thread State API | Thread-scoped KV store in Temporal | Session state backend |
For a deep dive into ADK integration — including agent.yaml format, state routing, and credential brokering — see the Google ADK Agents Guide.
Quick Start
# Create a project from the research agent template
agentvisor template create adk/research-agent
cd research-agent
export GOOGLE_API_KEY=your-api-key-here
temporal server start-dev &
agentvisor serve . --sandbox=none