v2.1.0

2.1.0 (2026-09-01)

Features

• Add execute_bash to the Agent Engine sandbox SDK. (505bd42)
• Allow setting ingress_control_config when creating a SandboxEnvironmentTemplate via the SDK (Python, Java, JS). (2dccde8)
• Expose SandboxEnvironmentTemplateState as a standalone enum class in the Python, Java, and JS SDKs. (a31d2ba)
• Expose STATE_PAUSED, STATE_PAUSING, and STATE_RESUMING values in the SandboxState enum for SandboxEnvironment across Python, Java, and JS SDKs. (ec342d9)

Bug Fixes

• Guard the post-LRO refresh in sandboxes.pause() and sandboxes.resume() on the presence of a resource name in the LRO response. (2c60077)
• Preserve rrf_ranking_alpha=0.0 in MatchingEngineIndexEndpoint hybrid queries (7e1c95a)

Documentation

• Update CHANGELOG.md to mark version 2.0.0 as yanked (75f9361)

v2.0.1

2.0.1 (2026-08-28)

Note: This release contains all updates originally intended for v2.0.0. The version was bumped to 2.0.1 due to a PyPI registry conflict with a previously yanked 2.0.0 package.

⚠ BREAKING CHANGES

• agentplatform: agent_engines module renamed to runtimes.
• agentplatform: a2a tasks module is removed.
• agentplatform: sessions and sandboxes moved to top-level modules.
• agentplatform: Removed global initializer dependency. Agent frameworks now read project and location from environment variables.
• agentplatform: runtime templates import changed from agentplatform.agent_engines.templates to agentplatform.frameworks.
• agentplatform: evals.run_inference(agent=...) now accepts types.Runtime instead of types.AgentEngine.
• agentplatform: Migrate Memory Bank methods to client.memory_banks sub-module.

Features

• Add sandboxes.pause() and sandboxes.resume() methods to the Agent Engine sandbox SDK across Python, Java, and JS SDKs. (9b92c88)
• Add Shell Sandbox environment support to the Agent Engine sandbox SDK (8f87082)
• agentplatform: Support client.memory_banks.get (6dfe678)
• agentplatform: Support client.memory_banks.list (6dfe678)
• agentplatform: Support ExampleStores module for few-shot example management (5248240)
• agentplatform: Support Memory Bank configs. (6dfe678)
• Decouple agentplatform from google-cloud-aiplatform and package it as a standalone PyPI package google-cloud-agentplatform. (e0e32c2)
• Expose ingress_control_config field on SandboxEnvironmentTemplate across Python, Java, and JS SDKs. (c08ed98)
• Expose service_attachment field on SandboxEnvironmentConnectionInfo across Python, Java, JS, and Go SDKs. (b781b0e)

Bug Fixes

• Add identity_type and service_account support to Reasoning Engines and Agent Engines. (a8536aa)
• Propagate the underlying API error from AdkApp's synchronous session methods and streaming agent runs (91cc8ce)
• Serve public A2A agent card at /a2a/card on Agent Runtime (85cba30)
• Treat forwarded OAuth access tokens as ephemeral session state (7e95ce6)

v1.165.1

1.165.1 (2026-08-19)

Bug Fixes

• Truncate default pipeline and staging bucket names to 63 chars (03edd90)

v1.165.0

1.165.0 (2026-08-18)

Features

• Add enable_data_retention to ToolParallelAiSearch, Add step_count to ReinforcementTuningHyperParameters, Add BidiGenerateContentSetup (09acba7)
• Expose public update() and update_async() methods on Sessions and AsyncSessions client modules. (5df3113)
• GenAI Client(evals) - add import_evaluation_set (eed0b4f)
• GenAI Client(evals) - add list_evaluation_sets and delete_evaluation_set (6ee088b)
• Onboard Vertex Model Garden to GenAI Python SDK: Add deploy_publisher_model support (9ef9093)

Bug Fixes

• Check GCS ownership for default pipeline bucket (2baea5b)
• Make the Telemetry API enablement check non-fatal in AdkApp.set_up(). (20205a8)
• Parse Server-Sent Events in Agent Engine streaming responses (7cb2fe9)
• Stop logging the "experimental" warning when creating a computer-use sandbox in the Vertex AI GenAI Python SDK. (6056aa0)

v1.164.0

1.164.0 (2026-08-12)

Features

• Add build configuration support to Vertex AI Reasoning Engine (e20c003)
• Add encryption_spec (CMEK) support to EvaluationMetric SDK. (6dd3179)
• Add encryption_spec (CMEK) support to EvaluationRun SDK (50a43af)
• Add encryption_spec (CMEK) support to EvaluationSet resource (c2244f9)
• Add endpoint field to BatchPredictionJob for bring-your-own-endpoint batch prediction (19144a4)
• Add sandbox templates and snapshots submodules to the Vertex AI GenAI SDK for Java. (f7e3a70)
• Add Tool.ExaAiSearch to Vertex AI v1 (19144a4)
• Add Tool.ExaAiSearch to Vertex AI v1beta1 (19144a4)
• Allow users to configure max wait time for prompt management queries for Python and JS (ad63bfe)
• Allow users to search for spaces without requiring admin privileges (19144a4)
• Forward per-request labels to RunConfig in streaming_agent_run_with_events (f8eb68c)
• GenAI Client(evals) - async auto-create EvaluationExperiment parity (e689f0e)
• GenAI Client(evals) - auto-create EvaluationExperiment in create_evaluation_run (eb75e14)
• GenAI Client(evals) - Pin SDK predefined metrics to latest Gemini 3.5 Flash versions by default (f5d94b4)
• GenAI Client(evals) - Support show() for EvaluationDataset built from eval_cases (5b1a0aa)
• Support Endpoints module for OpenModel prediction, and .get/undeploy/delete (8848353)
• Update Compute v1 to revision 20260722 (19144a4)

Bug Fixes

• Add aiohttp to ADK extra requirements. (390f2d1)
• deps: Update the Java code generator (gapic-generator-java) to v2.75.0 (19144a4)
• Enable automatic session creation in ADK template. (f343270)
• GenAI Client(evals) - skip agent config fetch when agent and client locations differ (8b43add)
• Import iam_credentials_v1 lazily in the sandboxes module. (2a18bff)
• Persist the AgentCard on Agent Engine update() (5d5a1ca), refs #7064
• Remove the google-cloud-iam dependency from the agent_engines extra. (25deb44)
• Update generator configuration and SDK bindings for Agent Engine Session update calls to return Session directly. (2702857)

Documentation

• A comment for field order_by in message .google.chat.v1.SearchSpacesRequest is changed (19144a4)
• A comment for field query in message .google.chat.v1.SearchSpacesRequest is changed (19144a4)
• A comment for field spaces in message .google.chat.v1.SearchSpacesResponse is changed (19144a4)
• A comment for field use_admin_access in message .google.chat.v1.SearchSpacesRequest is changed (19144a4)
• A comment for method SearchSpaces in service ChatService is changed (19144a4)
• Communicate on upcoming updates in the next major version (c64b25f)
• Communicate on upcoming updates in the next major version (76b9616)
• Update copyright year (19144a4)
• Update various comments (19144a4)

v1.163.0

1.163.0 (2026-07-28)

Features

• GenAI Client(evals) - add create EvaluationExperiment (07ade2e)
• GenAI Client(evals) - add delete/update EvaluationExperiment (09e5a65)
• GenAI Client(evals) - add get/list EvaluationExperiment (52b1c24)
• Onboard Vertex Model Garden to GenAI Python SDK: Add export_open_model support (c2ba5d2)
• Support us mREP endpoint for Batch Prediction, Training, and Online Prediction. (96a9fcf)

Bug Fixes

• Depend on the autogen distribution instead of ag2 for the AG2 integration. (dbcf815)
• GenAI client - Resolve opentelemetry-resourcedetector-gcp dependency error (a16fc0d)
• Merge sandbox-only turns in SDK-side interaction-to-AgentData conversion. (f93c455)
• Send display_name when creating a sandbox environment template. (243ca19)

v1.162.0

1.162.0 (2026-07-21)

Features

• Add detailed agent tool definitions for display (762079f)
• Add Route to GroundingChunk.Maps in Vertex AI v1 (4331d55)
• Add Route to GroundingChunk.Maps in Vertex AI v1beta1 (4331d55)
• Delegate agent resolution to server via geminiAgentConfig (ab757c7)
• GenAI client - Add warning on vertexai.Client instantiation and recommend agentplatform.Client (f141415)
• GenAI Client(evals) - multi-turn user simulation for Gemini Agents API run_inference (c74e996)

Bug Fixes

• Use the correct enum for RagFile.file_status (23145f3)

Documentation

• Expand GroundingChunk.Maps documentation to describe route support (4331d55)
• Expand GroundingChunk.Maps documentation to describe route support (4331d55)
• GenAI client - Add example usage to RAG docstrings (df3dcd9)
• Update product name from "Vertex AI" to "Gemini Enterprise Agent Platform" in README, and add a note to rename Agent Engine to Agent Runtime in upcoming major release (a3179c2)

v1.161.0

1.161.0 (2026-07-14)

Features

• Add FeedbackService to Agent Platform Python SDK (f6ecd67)
• Add identity_type to Reasoning Engine public protos (66d4837)
• Add identity_type to Reasoning Engine public protos (66d4837)
• Add support for FeedbackContext to Agent Platform Python SDK (f5f750c)
• Expose retrieval_queries in GroundingMetadata for the v1 API (66d4837)
• GenAI Client(evals) - evaluate Gemini Agents API agents via interaction (a44c520)
• GenAI Client(evals) - evaluate() agent parameter for interaction-id datasets (135224c)
• GenAI Client(evals) - exponential backoff for Gemini agent interaction polling (1f3c074)
• GenAI Client(evals) - generate_conversation_scenarios support for Gemini Agents API agents (df4e672)
• GenAI Client(evals) - run_inference support for Gemini Agents API agents (852c546)
• Onboard Vertex Model Garden to GenAI Python SDK: Add list_custom_model_deploy_options support (239bc13)
• Resolve Interactions API data for agent trace display in eval results. (f158517)
• Support creating evaluation runs from pre-existing Interactions API data (b430014)
• Support Prompt Management in the JS GenAI Modules (89d2b91)

Bug Fixes

• Remove OpenTelemetry event logger setup since the Events API/SDK has been deprecated and is soon being removed entirely. (73fde8d)

Documentation

• Add result_parsing_function field to LLMMetric SDK types (8f1a0a1)

v1.160.0

1.160.0 (2026-07-07)

Features

• Add revision_labels, revision_expire_time, revision_ttl, disable_memory_revisions, metadata, metadata_merge_strategy and overlap_event_count to Memory Bank IngestEvents API (e169af9)
• GenAI Client(evals) - add Gemini Agents API related eval types (c8a38a0)
• Onboard Vertex Model Garden to GenAI Python SDK: Add list_publisher_model_deploy_options support (ce463e6)

Bug Fixes

• Add mTLS and telemetry endpoint configurations to preview AdkApp (c3c1836)
• Avoid shadowing of built-in list in Python 3.14 (195ca27)
• Honor explicitly passed api_endpoint when location is "global" (f9e3c6e), closes #6958

v1.159.0

1.159.0 (2026-06-30)

⚠ BREAKING CHANGES

• datasets.assemble now returns tuple[str, Optional[bigframes.pandas.DataFrame]] (the BigQuery table id without the bq:// prefix, and the assembled table as a BigFrames DataFrame) instead of the BigQuery URI str. By default no DataFrame is loaded (load_dataframe=False): the second element is None, no BigQuery read is performed, and bigframes is not required. Pass load_dataframe=True to load the assembled table.

Features

• Add data_sharing_enabled_provider field (ModelProvider enum) to PublisherModelConfig (51c4d78)
• Add deprecation warning to vertexai.rag module in favor of agentplatform.Client().rag (9ffcbce)
• Add support for session TTL and expiration in Vertex AI session service (a2af300)
• GenAI client - Add upload_file method to RAG module (13b685b)
• GenAI client - Log operation name when RAG operation fails (e368858)
• GenAI SDK client(multimodal) - Return the assembled table as a DataFrame from datasets.assemble. (8e52bd2)
• Onboard Vertex Model Garden to GenAI Python SDK: Add list_models and list_deployable_models support (9cd63ab)

Bug Fixes

• Added safety checks in download_from_gcs (2f5c8f8)
• ai_platform: Black check (97ee94a)
• aiplatform: Safely parse bq:// URIs using removeprefix (97ee94a)
• feature_store: Safely parse bq:// URIs using removeprefix (97ee94a)
• Fix the async_stream_query method. Restore yield_parsed_json method lost during vertex -> agentplatform migration (2eb0fcb)
• GenAI client - Update RagFile.file_status.state to use correct enum (548d897)
• Google_auth_mock universe domain (35edd83)
• offline_store: Safely parse bq:// URIs using removeprefix (97ee94a)
• offline_store: Safely parse bq:// URIs using removeprefix (97ee94a)
• Redact python_spec version in replay tests (8bc007b)
• Resolve AttributeError by supporting both Pydantic and Protobuf AgentCard serialization (4c0c368)

Documentation

• Fix typos across docstrings (dd52cad)
• GenAI client - Update docstrings for RAG GenAI Module (9dbdc9c)

Miscellaneous Chores

• Release 1.159.0 (e17e0fc)