Google ADK Integration
Dedicated wrappers for Google Agent Development Kit — wrapADKAgent, wrapADKRunner, and instrumentADK. Full support for ADK's multi-agent patterns.
Google Agent Development Kit (ADK) is Google's framework for building, orchestrating, and deploying multi-agent AI systems using Gemini models.
Getting Started
Install the SDK
Install @zespan/sdk alongside the Google ADK package.
npm install @zespan/sdk @google/adkInstrument your ADK agent
Use instrumentADK() to wrap your agent. Zespan captures every agent step, Gemini call, and tool invocation automatically.
import { Zespan, instrumentADK } from '@zespan/sdk';
import { Agent } from '@google/adk';
const lt = new Zespan({ apiKey: process.env.ZESPAN_API_KEY });
const agent = instrumentADK(
new Agent({
name: 'research-agent',
model: 'gemini-1.5-pro',
instruction: 'You are a research assistant.',
tools: [searchTool],
}),
lt
);
const result = await agent.run({ query: 'Latest AI papers' });View traces in Zespan
Open the Agent Registry and Trace Explorer. ADK agents appear with their Gemini model usage, tool calls, and any sub-agent delegations.
What's captured automatically
- ADK-native wrappers: wrapADKAgent, wrapADKRunner, and instrumentADK
- Gemini call tracing: token usage, cost, and latency per Gemini call
- Sub-agent delegation: ADK sub-agent calls appear in the delegation graph
- Function tool spans: each ADK function tool call with inputs and outputs
- Agent auto-discovery: ADK agents registered in the Agent Registry on first run
- Battle-tested: ZespanPilot (our own AI copilot) runs on Google ADK
FAQ
Which ADK patterns are supported?
wrapADKAgent wraps single agents, wrapADKRunner wraps the ADK runner, and instrumentADK provides full instrumentation for multi-agent ADK systems including sub-agent delegation.
Do I need to use wrapGoogle() separately for Gemini calls?
No. instrumentADK handles all Gemini API calls made by the agent automatically. You don't need a separate provider wrapper.
Start for free — 10K traces/month, no card needed
Google ADK integration works on all plans including the free tier.