google/adk-python v1.21.0

Release 1.21.0

on GitHub

1.21.0 (2025-12-11)

Features

• [Interactions API Support]

  • The newly released Gemini Interactions API is supported in ADK Now. To use it:

  Agent(
    model=Gemini(
        model="gemini-3-pro-preview",
        use_interactions_api=True,
    ),
    name="...",
    description="...",
    instruction="...",
  )

  see samples for details

• [Services]

  • Add add_session_to_memory to CallbackContext and ToolContext to explicitly save the current session to memory (7b356dd)

• [Plugins]

  • Add location for table in agent events in plugin BigQueryAgentAnalytics (507424a)
  • Upgrade BigQueryAgentAnalyticsPlugin to v2.0 with improved performance, multimodal support, and reliability (7b2fe14)

• [A2A]

  • Adds ADK EventActions to A2A response (32e87f6)

• [Tools]

  • Add header_provider to OpenAPIToolset and RestApiTool (e1a7593)
  • Allow overriding connection template (cde7f7c)
  • Add SSL certificate verification configuration to OpenAPI tools using the verify parameter (9d2388a)
  • Use json schema for function tool declaration when feature enabled (cb3244b)

• [Models]

  • Add Gemma3Ollama model integration and a sample (e9182e5)

Bug Fixes

• Install dependencies for py 3.10 (9cccab4)
• Refactor LiteLLM response schema formatting for different models (894d8c6)
• Resolve project and credentials before creating Spanner client (99f893a)
• Avoid false positive "App name mismatch" warnings in Runner (6388ba3)
• Update the code to work with either 1 event or more than 1 events (4f54660)
• OpenAPI schema generation by skipping JSON schema for judge_model_config (56775af)
• Add tool_name_prefix support to OpenAPIToolset (82e6623)
• Pass context to client interceptors (143ad44)
• Yield event with error code when agent run raised A2AClientHTTPError (b7ce5e1)
• Handle string function responses in LiteLLM conversion (2b64715)
• ApigeeLLM support for Built-in tools like GoogleSearch, BuiltInCodeExecutor when calling Gemini models through Apigee (a9b853f)
• Extract and propagate task_id in RemoteA2aAgent (82bd4f3)
• Update FastAPI and Starlette to fix CVE-2025-62727 (ReDoS vulnerability) (c557b0a)
• Add client id to token exchange (f273517)

Improvements

• Normalize multipart content for LiteLLM's ollama_chat provider (055dfc7)
• Update adk web, fixes image not rendering, state not updating, update drop down box width and trace icons (df86847)
• Add sample agent for interaction api integration (68d7048)
• Update genAI SDK version (f0bdcab)
• Introduce build_function_declaration_with_json_schema to use pydantic to generate json schema for FunctionTool (51a638b)
• Update component definition for triaging agent (ee743bd)
• Migrate Google tools to use the new feature decorator (bab5729)
• Migrate computer to use the new feature decorator (1ae944b)
• Add Spanner execute sql query result mode using list of dictionaries (f22bac0)
• Improve error message for missing invocation_id and new_message in run_async (de841a4)