feat: introduces a new AgentEngineSandboxCodeExecutor class that supports executes agent generated code

The AgentEngineSandboxCodeExecutor uses the Vertex AI Code Execution Sandbox API to execute code

PiperOrigin-RevId: 821197794

Author: google-genai-bot

contributing/samples/agent_engine_code_execution/README

@@ -32,7 +32,7 @@ dependencies = [
   "click>=8.1.8, <9.0.0",                                   # For CLI tools
   "fastapi>=0.115.0, <1.0.0",                               # FastAPI framework
   "google-api-python-client>=2.157.0, <3.0.0",              # Google API client discovery
-  "google-cloud-aiplatform[agent_engines]>=1.121.0, <2.0.0",# For VertexAI integrations, e.g. example store.
+  "google-cloud-aiplatform[agent_engines]>=1.112.0, <2.0.0",# For VertexAI integrations, e.g. example store.
   "google-cloud-bigtable>=2.32.0",                          # For Bigtable database
   "google-cloud-discoveryengine>=0.13.12, <0.14.0",         # For Discovery Engine Search Tool
   "google-cloud-secret-manager>=2.22.0, <3.0.0",            # Fetching secrets in RestAPI Tool

contributing/samples/agent_engine_code_execution/__init__.py

@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from __future__ import annotations
-
 import logging
 
 from .base_code_executor import BaseCodeExecutor
@@ -31,7 +29,6 @@
     'VertexAiCodeExecutor',
     'ContainerCodeExecutor',
     'GkeCodeExecutor',
-    'AgentEngineSandboxCodeExecutor',
 ]
 
 
@@ -66,14 +63,4 @@ def __getattr__(name: str):
           'GkeCodeExecutor requires additional dependencies. '
           'Please install with: pip install "google-adk[extensions]"'
       ) from e
-  elif name == 'AgentEngineSandboxCodeExecutor':
-    try:
-      from .agent_engine_sandbox_code_executor import AgentEngineSandboxCodeExecutor
-
-      return AgentEngineSandboxCodeExecutor
-    except ImportError as e:
-      raise ImportError(
-          'AgentEngineSandboxCodeExecutor requires additional dependencies. '
-          'Please install with: pip install "google-adk[extensions]"'
-      ) from e
   raise AttributeError(f"module '{__name__}' has no attribute '{name}'")

contributing/samples/agent_engine_code_execution/agent.py

@@ -14,8 +14,6 @@
 
 """Utility functions for code execution."""
 
-from __future__ import annotations
-
 import base64
 import binascii
 import copy
@@ -36,9 +34,9 @@ class File:
   The name of the file with file extension (e.g., "file.csv").
   """
 
-  content: str | bytes
+  content: str
   """
-  The base64-encoded bytes of the file content or the original bytes of the file content.
+  The base64-encoded bytes of the file content.
   """
 
   mime_type: str = 'text/plain'