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: used in production across Zespan's own platform
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 free — 10K traces a month, no card needed
Google ADK integration works on all plans including the free tier.