	In Browser
	StumbleUpon
	del.icio.us
	Google
	Google Buzz
	reddit
	LinkedIn

	Facebook
	Twitter
	Linkedin
	E-Mail

Agentic AI > ADK Agent Testing > Testing ADK Agent SDK Version Upgrades and Backward Compatibility

Testing ADK Agent SDK Version Upgrades and Backward Compatibility

Author: Venkata Sudhakar

ADK SDK upgrades can silently break agent behavior if tool signatures, session contracts, or runner APIs change between versions. ShopMax India pins the ADK version in production and runs a backward-compatibility test suite before every upgrade so that agents handling product search and order management in Delhi and Chennai keep working as expected.

The compatibility test strategy involves capturing reference outputs from the pinned version, then replaying the same inputs against the candidate version and diffing the results. Key areas to check are FunctionTool argument schema, Runner.run() return shape, and InMemorySessionService state keys. Any structural change in these APIs is a breaking change that requires a migration step.

The example below defines a contract test that asserts the tool response schema and session state keys match a known-good baseline, simulating the check run in CI before merging an ADK version bump PR.

import pytest
from google.adk.agents import LlmAgent
from google.adk.tools import FunctionTool
from google.adk.sessions import InMemorySessionService

# Baseline contract for ADK 1.x tool response
EXPECTED_TOOL_RESPONSE_KEYS = {"result"}
EXPECTED_SESSION_STATE_KEYS = {"app_name", "user_id", "session_id"}

def search_product(query: str) -> dict:
    return {"result": f"Top match for {query}: Samsung 4K TV - Rs 65000"}

@pytest.fixture
def agent():
    tool = FunctionTool(search_product)
    return LlmAgent(name="product_agent", tools=[tool])

@pytest.fixture
def session():
    svc = InMemorySessionService()
    return svc.create_session(
        app_name="shopmax", user_id="ravi_delhi", session_id="compat-test-001"
    )

def test_tool_response_schema_stable(agent):
    response = search_product("4K TV")
    assert set(response.keys()) == EXPECTED_TOOL_RESPONSE_KEYS, (
        f"Tool response schema changed: got {set(response.keys())}"
    )

def test_session_state_keys_stable(session):
    state_keys = set(session.__dict__.keys())
    for key in EXPECTED_SESSION_STATE_KEYS:
        assert key in state_keys or hasattr(session, key), (
            f"Session contract broken: missing attribute {key}"
        )
    print(f"Session contract OK for session {session.id}")

It gives the following output,

Session contract OK for session compat-test-001
2 passed in 0.14s

Add these contract tests to a dedicated compatibility/ directory and run them as a pre-merge gate on every ADK bump PR. If a test fails, check the ADK changelog for deprecation notices and update the migration guide before merging. Freeze the baseline snapshot in a JSON file so that future version bumps can be diffed automatically without manual inspection.

Send your comments, suggestions or queries regarding this site to [email protected].