v1.8.0

1.8.0 (2025-07-23)

Features

• [Core]Add agent card builder (18f5bea)
• [Core]Add an to_a2a util to convert adk agent to A2A ASGI application (a77d689)
• [Core]Add camel case converter for agents (0e173d7)
• [Evals]Use LocalEvalService to run all evals in cli and web (d1f182e)
• [Evals]Enable FinalResponseMatchV2 metric as an experiment (36e45cd)
• [Models]Add support for model-optimizer-* family of models in vertex (ffe2bdb)
• [Services]Added a sample for History Management (67284fc)
• [Services]Support passing fully qualified agent engine resource name when constructing session service and memory service ([2e77804](2e778049d0a675e458f4e
  35fe4104ca1298dbfcf))
• [Tools]Add ComputerUseToolset (083dcb4)
• [Tools]Allow toolset to process llm_request before tools returned by it (3643b4a)
• [Tools]Support input/output schema by fully-qualified code reference (dfee06a)
• [Tools]Enhance LangchainTool to accept more forms of functions (0ec69d0)

Bug Fixes

• Attention: Logging level for some API requests and responses was moved from INFO to DEBUG (ff31f57)
  • Please set --log_level=DEBUG, if you are interested in having those API request and responses in logs.
• Add buffer to the write file option (f2caf2e)
• Allow current sub-agent to finish execution before exiting the loop agent due to a sub-agent's escalation. (2aab1cf)
• Check that mean_score is a valid float value (65cb6d6)
• Handle non-json-serializable values in the execute_sql tool (13ff009)
• Raise NotFoundError in list_eval_sets function when app_name doesn't exist (b17d8b6)
• Fixed serialization of tools with nested schema (53df35e)
• Set response schema for function tools that returns None (33ac838)
• Support path level parameters for open_api_spec_parser (6f01660)
• Use correct type for actions parameter in ApplicationIntegrationToolset (ce7253f)
• Use the same word extractor for query and event contents in InMemoryMemoryService (1c4c887)

Documentation

• Fix missing toolbox-core dependency and improve installation guide (2486349)

v1.7.0

1.7.0 (2025-07-16)

Features

• Add ability to send state change with message 3f9f773
• [Eval] Support for persisting eval run results bab3be2
• Introduce [Plugin]: Plugin is simply a class that packages these individual callback functions together for a broader purpose162228d

Bug Fixes

• Create correct object for image and video content in litellm bf7745f
• Support project-based gemini model path for BuiltInCodeExecutor and all built-in tools a5d6f1e
• Add instruction in long running tool description to avoid being invoked again by model 62a6119
• [A2A] Import A2A well known path from A2A sdk a6716a5
• Fix the long running function response event merge logic 134ec0d
• [A2A] Return final task result in task artifact instead of status message a8fcc1b
• Make InMemoryMemoryService thread-safe 10197db

Improvements

• Improve partial event handling and streaming aggregation 584c8c6

Documentation

• Update agent transfer related doc string and comments b1fa383
• Update doc string for GcsArtifactService 498ce90

Release 1.6.1

1.6.1 (2025-07-09)

Features

• Add A2A support as experimental features f0183a9

  • Install google-adk with a2a extra: pip install google-adk[a2a]
  • Users can serve agents as A2A agent with --a2a option for adk web and
    adk api_server
  • Users can run a remote A2A agent with RemoteA2AAgent class
  • Three A2A agent samples are added:
    • contributing/samples/a2a_basic
    • contributing/samples/a2a_auth
    • contributing/samples/a2a_human_in_loop

• Support agent hot reload.e545e5a
  Users can add --reload_agents flag to adk web and adk api_server command
  to reload agents automatically when new changes are detected.

• Eval features

  • Implement auto rater-based evaluator for responses 75699fb
  • Add Safety evaluator metric 0bd05df
  • Add BaseEvalService declaration and surrounding data models b0d88bf

• Minor features

  • Add custom_metadata to VertexAiSessionService when adding events a021222
  • Support protected write in BigQuery execute_sql tool dc43d51
  • Added clone() method to BaseAgent to allow users to create copies of an agent [d263afd] (d263afd)

Bug Fixes

• Support project-based gemini model path to use enterprise_web_search_tool e33161b
• Use inspect.signature() instead of typing.get_type_hints for examining function signatures4ca77bc
• Replace Event ID generation with UUID4 to prevent SQLite integrity constraint failures e437c7a
• Remove duplicate options from adk deploy 3fa2ea7
• Fix scenario where a user can access another users events given the same session id 362fb3f
• Handle unexpected 'parameters' argument in FunctionTool.run_async 0959b06
• Make sure each partial event has different timestamp 17d6042
• Avoid pydantic.ValidationError when the model stream returns empty final chunk 9b75e24
• Fix google_search_tool.py to support updated Gemini LIVE model naming 77b869f
• Adding detailed information on each metric evaluation 04de3e1
• Converts litellm generate config err 3901fad
• Save output in state via output_key only when the event is authored by current agent 20279d9
• Treat SQLite database update time as UTC for session's last update time 3f621ae
• Raise ValueError when sessionId and userId are incorrect combination(#1653) 4e765ae
• Support API-Key for MCP Tool authentication 045aea9
• Lock LangGraph version to <= 0.4.10 9029b8a
• Update the retry logic of create session polling 3d2f13c

Chores

• Extract mcp client creation logic to a separate method 45d60a1
• Add tests for live streaming configs bf39c00
• Update ResponseEvaluator to use newer version of Eval SDK 62c4a85
• Add util to build our llms.txt and llms-full.txt files a903c54
• Create an example for multi agent live streaming a58cc3d
• Refactor the ADK Triaging Agent to make the code easier to read b6c7b5b

Documentation

• Update the a2a exmaple link in README.md d0fdfb8
• Adds AGENTS.md to provide relevant project context for the Gemini CLI 37108be
• Update CONTRIBUTING.md ffa9b36
• Add adk project overview and architecture 28d0ea8
• Add docstring to clarify that inmemory service are not suitable for production dc414cb
• Update agents.md to include versioning strategy 6a39c85
• Add tenacity into project.toml df141db
• Updating CONTRIBUTING.md with missing extra e153d07

v1.5.0

1.5.0 (2025-06-25)

Features

• Add a new option eval_storage_uri in adk web & adk eval to specify GCS bucket to store eval data (fa025d7)
• Add ADK examples for litellm with add_function_to_prompt (f33e090)
• Add implementation of VertexAiMemoryBankService and support in FastAPI endpoint (abc89d2)
• Add rouge_score library to ADK eval dependencies, and implement RougeEvaluator that is computes ROUGE-1 for "response_match_score" metric (9597a44)
• Add usage span attributes to telemetry (#356) (ea69c90)
• Add Vertex Express mode compatibility for VertexAiSessionService (00cc8cd)

Bug Fixes

• Include current turn context when include_contents='none' (9e473e0)
• Make LiteLLM streaming truly asynchronous (bd67e84)
• Make raw_auth_credential and exchanged_auth_credential optional given their default value is None (acbdca0)
• Minor typo fix in the agent instruction (ef3c745)
• Typo fix in sample agent instruction (ef3c745)
• Update contributing links (a1e1441)
• Use starred tuple unpacking on GCS artifact blob names (3b1d9a8)

Chore

• Do not send api request when session does not have events (88a4402)
• Leverage official uv action for install(09f1269)
• Update google-genai package and related deps to latest(ed7a21e)
• Add credential service backed by session state(29cd183)
• Clarify the behavior of Event.invocation_id(f033e40)
• Send user message to the agent that returned a corresponding function call if user message is a function response(7c670f6)
• Add request converter to convert a2a request to ADK request(fb13963)
• Support allow_origins in cloud_run deployment (2fd8feb)

v1.4.2

1.4.2 (2025-06-20)

Bug Fixes

• Add type checking to handle different response type of genai API client (4d72d31)
  • This fixes the broken VertexAiSessionService
• Allow more credentials types for BigQuery tools (2f716ad)

v1.4.1

1.4.1 (2025-06-18)

Features

• Add Authenticated Tool (Experimental) (dcea776)
• Add enable_affective_dialog and proactivity to run_config and llm_request (fe1d5aa)
• Add import session API in the fast API (233fd20)
• Add integration tests for litellm with and without turning on add_function_to_prompt (8e28587)
• Allow data_store_specs pass into ADK VAIS built-in tool (675faef)
• Enable MCP Tool Auth (Experimental) (157d9be)
• Implement GcsEvalSetResultsManager to handle storage of eval sets on GCS, and refactor eval set results manager (0a5cf45)
• Re-factor some eval sets manager logic, and implement GcsEvalSetsManager to handle storage of eval sets on GCS (1551bd4)
• Support real time input config (d22920b)
• Support refresh access token automatically for rest_api_tool (1779801)

Bug Fixes

• Fix Agent generate config err (#1305) (badbcbd)
• Fix Agent generate config error (#1450) (694b712)
• Fix liteLLM test failures (fef8778)
• Fix tracing for live (58e07ca)
• Merge custom http options with adk specific http options in model api request (4ccda99)
• Remove unnecessary double quote on Claude docstring (bbceb4f)
• Set explicit project in the BigQuery client (6d174eb)
• Support streaming in litellm + adk and add corresponding integration tests (aafa80b)
• Support project-based gemini model path to use google_search_tool (b2fc774)
• Update conversion between Celsius and Fahrenheit (1ae176a)

Chores

• Set agent_engine_id in the VertexAiSessionService constructor, also use the agent_engine_id field instead of overriding app_name in FastAPI endpoint (fc65873)

v1.3.0

1.3.0 (2025-06-11)

Features

• Add memory_service option to CLI (416dc6f)
• Add support for display_name and description when deploying to agent engine (aaf1f9b)
• Dev UI: Trace View
  • New trace tab which contains all traces grouped by user messages
  • Click each row will open corresponding event details
  • Hover each row will highlight the corresponding message in dialog
• Dev UI: Evaluation
  • Evaluation Configuration: users can now configure custom threshold for the metrics used for each eval run (d1b0587)
  • Each eval case added can now be viewed and edited. Right now we only support edit of text.
  • Show the used metric in evaluation history (6ed6351)
• Tool enhancements:
  • Add url_context_tool (fe1de7b)
  • Support to customize timeout for mcpstdio connections (54367dc)
  • Introduce write protected mode to BigQuery tools (6c999ca)

Bug Fixes

• Agent Engine deployment:
  • Correct help text formatting for adk deploy agent_engine (13f98c3)
  • Handle project and location in the .env properly when deploying to Agent Engine (0c40542)
• Fix broken agent graphs (3b1f2ae)
• Forward __annotations__ to the fake func for FunctionTool inspection (9abb841)
• Handle the case when agent loading error doesn't have msg attribute in agent loader (c224626)
• Prevent agent_graph.py throwing when workflow agent is root agent (4b1c218)
• Remove display_name for non-Vertex file uploads (cf5d701)

Documentation

• Add DeepWiki badge to README (f38c08b)
• Update code example in tool declaration to reflect BigQuery artifact description (3ae6ce1)

v1.2.1

1.2.1 (2025-06-04)

Bug Fixes

• Import deprecated from typing_extensions (068df04)

v1.2.0

1.2.0 (2025-06-04)

Features

• Add agent engine as a deployment option to the ADK CLI (2409c3e)
• Add an option to use gcs artifact service in adk web. (8d36dbd)
• Add index tracking to handle parallel tool call using litellm (05f4834)
• Add sortByColumn functionality to List Operation (af95dd2)
• Add implementation for get_eval_case, update_eval_case and delete_eval_case for the local eval sets manager. (a7575e0)
• Expose more config of VertexAiSearchTool from latest Google GenAI SDK (2b5c89b)
• New Agent Visualization (da4bc0e)
• Set the max width and height of view image dialog to be 90% (98a635a)
• Support Langchain StructuredTool for Langchain tool (7e637d3)
• Support Langchain tools that has run_manager in _run args and don't have args_schema populated (3616bb5)
• Update for anthropic models (16f7d98)
• Use bigquery scope by default in bigquery credentials. (ba5b80d)
• Add jira_agent adk samples code which connect Jira cloud (8759a25)
• Render HTML artifact in chat window (5c2ad32)
• Add export to json button in the chat window (fc3e374)
• Add tooltip to the export session button (2735942)

Bug Fixes

• Add adk icon for UI (2623c71)
• Add cache_ok option to remove sa warning. (841e10a)
• Add support for running python main function in UnsafeLocalCodeExecutor when the code has an if _name_ == "_main_" statement. (95e33ba)
• Adk web not working on some env for windows, fixes google/adk-web#34 (daac8ce)
• Assign empty inputSchema to MCP tool when converting an ADK tool that wraps a function which takes no parameters. (2a65c41)
• Call all tools in parallel calls during partial authentication (0e72efb)
• Continue fetching events if there are multiple pages. (6506302)
• Do not convert "false" value to dict (60ceea7)
• Enhance agent loader exception handler and expose precise error information (7b51ae9)
• Ensure function description is copied when ignoring parameters (7fdc6b4)
• Filter memory by app_name and user_id. (db4bc98)
• Fix filtering by user_id for vertex ai session service listing (9d4ca4e)
• fix parameter schema generation for gemini (5a67a94)
• Handle non-indexed function call chunks with incremental fallback index (b181cbc)
• Handles function tool parsing corner case where type hints are stored as strings. (a8a2074)
• Introduce PreciseTimestamp to fix mysql datetime precision issue. (841e10a)
• match arg case in errors (b226a06)
• ParallelAgent should only append to its immediate sub-agent, not transitive descendants (ec8bc73)
• Relax openapi spec to gemini schema conversion to tolerate more cases (b1a74d0)
• Remove labels from config when using API key from Google AI Studio to call model (5d29716)
• sample: Correct text artifact saving in artifact_save_text sample (5c6001d)
• Separate thinking from text parts in streaming mode (795605a)
• Simplify content for ollama provider (eaee49b)
• Timeout issues for mcpstdio server when mcp tools are incorrect. (45ef668)
• transfer_to_agent: update docstring for clarity and accuracy (854a544)
• Update unit test code for test_connection (b0403b2)
• Use inspect.cleandoc on function docstrings in generate_function_declaration. (f7cb666)
• Restore errors path (32c5ffa)
• Unused import for deprecated (ccd05e0)
• Prevent JSON parsing errors and preserve non-ascii characters in telemetry (d587270)
• Raise HTTPException when running evals in fast_api if google-adk[eval] is not installed (1de5c34)
• Fix typos in README for sample bigquery_agent and oauth_calendar_agent (9bdd813)
• Make tool_call one span for telemetry and renamed to execute_tool (999a7fe)
• Use media type in chat window. Remove isArtifactImage and isArtifactAudio reference (1452dac)
• Set output_schema correctly for LiteLllm (6157db7)
• Update pending event dialog style (1db601c)
• Remove the gap between event holder and image (63822c3)

Documentation

• Adds a sample agent to illustrate state usage via callbacks. (18fbe3c)
• Fix typos in documentation (7aaf811)
• Change eval_dataset to eval_dataset_file_path_or_dir (62d7bf5)
• Fix broken link to A2A example (0d66a78)
• Fix typo in envs.py (bd588bc)
• Updates CONTRIBUTING.md to refine setup process using uv. (04e07b4)
• Create and update project documentation including README.md and CONTRIBUTING.md (f180331)
• Rename the root agent in the example to match the example name (94c0aca)
• ADK: add section comment ([349a414](349a414120fbff0937966af95...

v1.1.1

1.1.1

Features

• Add BigQuery first-party tools. See here for more details.