google/adk-python v1.23.0

on GitHub

1.23.0 (2026-01-22)

⚠ BREAKING CHANGES

• Breaking: Use OpenTelemetry for BigQuery plugin tracing, replacing custom ContextVar implementation (ab89d12)
• Add support to automatically create a session if one does not exist (8e69a58)

Features

• [Core]

  • Remove @experimental decorator from AgentEngineSandboxCodeExecutor (135f763)
  • Add --disable_features CLI option to override default feature enable state (53b67ce)
  • Add otel_to_cloud flag to adk deploy agent_engine command (21f63f6)
  • Add is_computer_use field to agent information in adk-web server (5923da7)
  • Allow thinking_config in generate_content_config (e162bb8)
  • Convert A2UI messages between A2A DataPart metadata and ADK events (1133ce2)
  • Add --enable_features CLI option to override default feature enable state (79fcddb)

• [Tools]

  • Add flush mechanism to BigQueryAgentAnalyticsPlugin to ensure pending log events are written to BigQuery (9579bea)
  • Allow Google Search tool to set a different model (b57a3d4)
  • Support authentication for MCP tool listing (e3d542a 19315fe)
  • Use JSON schema for base_retrieval_tool, load_artifacts_tool, and load_memory_tool declarations when the feature is enabled (69ad605)
  • Use JSON schema for IntegrationConnectorTool declaration when the feature is enabled (2ed6865)
  • Start and close ClientSession in a single task in McpSessionManager (cce430d)
  • Use JSON schema for RestApiTool declaration when the feature is enabled (a5f0d33)

• [Evals]

  • Update adk eval CLI to consume custom metrics by adding CustomMetricEvaluator (ea0934b)
  • Update EvalConfig and EvalMetric data models to support custom metrics (6d2f33a)

• [Observability]

  • Add minimal generate_content {model.name} spans and logs for non-Gemini inference and when opentelemetry-inference-google-genai dependency is missing (935c279)

• [Integrations]

  • Enhance TraceManager asynchronous safety, enrich BigQuery plugin logging, and fix serialization (a4116a6)

• [Live]

  • Persist user input content to session in live mode (a04828d)

Bug Fixes

• Recursively extract input/output schema for AgentTool (bf2b56d)
• Yield buffered function_call and function_response events during live streaming (7b25b8f)
• Update authlib and mcp dependency versions (7955177)
• Set LITELLM_MODE to PRODUCTION before importing LiteLLM to prevent implicit .env file loading (215c2f5)
• Redact sensitive information from URIs in logs (5257869)
• Handle asynchronous driver URLs in the migration tool (4b29d15)
• Remove custom metadata from A2A response events (81eaeb5)
• Handle None inferences in eval results (7d4326c)
• Mark all parts of a thought event as thought (f92d4e3)
• Use json.dumps for error messages in SSE events (6ad18cc)
• Use the correct path for config-based agents when deploying to AgentEngine (83d7bb6)
• Support Generator and Async Generator tool declarations in JSON schema (19555e7 7c28297)
• Prevent stopping event processing on events with None content (ed2c3eb)
• Fix 'NoneType' object is not iterable error (7db3ce9)
• Use canonical tools to find streaming tools and register them by tool.name (ec6abf4)
• Initialize self._auth_config inside BaseAuthenticatedTool to access authentication headers in McpTool (d4da1bb)
• Only filter out audio content when sending history (712b5a3)
• Add finish reason mapping and remove custom file URI handling in LiteLLM (89bed43)
• Convert unsupported inline artifact MIME types to text in LoadArtifactsTool (fdc98d5)
• Pass log_level to uvicorn in web and api_server commands (38d52b2)
• Use the agent name as the author of the audio event (ab62b1b)
• Handle NOT_FOUND error when fetching Vertex AI sessions (75231a3)
• Fix httpx client closure during event pagination (b725045)

Improvements

• Add new conversational analytics API toolset (82fa10b)
• Filter out adk_request_input event from content list (295b345)
• Always skip executing partial function calls (d62f9c8)
• Update comments of request confirmation preprocessor (1699b09)
• Fix various typos (a8f2ddd)
• Update sample live streaming tools agent to use latest live models (3dd7e3f)
• Make the regex to catch CLI reference strict by adding word boundary anchor (c222a45)
• Migrate ToolboxToolset to use toolbox-adk and align validation (7dc6adf 277084e)
• Always log API backend when connecting to live model (7b035aa)
• Add a sample BigQuery agent using BigQuery MCP tools (672b57f)
• Add a DebugLoggingPlugin to record human-readable debugging logs (8973618)
• Upgrade the sample BigQuery agent model version to gemini-2.5-flash (fd2c0f5)
• Import migration_runner lazily within the migrate command (905604f)