feat: GenAI SDK client - Add sandbox code execution SDK support

PiperOrigin-RevId: 797860270

Author: vertex-sdk-bot

tests/unit/vertexai/genai/replays/test_create_agent_engine_sandbox.py

@@ -0,0 +1,47 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# pylint: disable=protected-access,bad-continuation,missing-function-docstring
+
+from tests.unit.vertexai.genai.replays import pytest_helper
+from vertexai._genai import types
+
+
+def test_create_sandbox(client):
+    agent_engine = client.agent_engines.create()
+    assert isinstance(agent_engine, types.AgentEngine)
+    assert isinstance(agent_engine.api_resource, types.ReasoningEngine)
+
+    operation = client.agent_engines.sandboxes.create(
+        name=agent_engine.api_resource.name,
+        spec={
+            "code_execution_environment": {
+                "machineConfig": "MACHINE_CONFIG_VCPU4_RAM4GIB"
+            }
+        },
+        config=types.CreateAgentEngineSandboxConfig(display_name="test_sandbox"),
+    )
+    assert isinstance(operation, types.AgentEngineSandboxOperation)
+    assert operation.response.display_name == "test_sandbox"
+    assert operation.response.spec == {
+        "code_execution_environment": {"machineConfig": "MACHINE_CONFIG_VCPU4_RAM4GIB"}
+    }
+    assert operation.response.name.startswith(agent_engine.api_resource.name)
+
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method="agent_engines.create_sandbox",
+)

vertexai/_genai/agent_engines.py

@@ -907,6 +907,7 @@ def _update(
         return return_value
 
     _memories = None
+    _sandboxes = None
     _sessions = None
 
     @property
@@ -928,6 +929,25 @@ def memories(self):
                 ) from e
         return self._memories.Memories(self._api_client)
 
+    @property
+    @_common.experimental_warning(
+        "The Vertex SDK GenAI agent_engines.sandboxes module is experimental, "
+        "and may change in future versions."
+    )
+    def sandboxes(self):
+        if self._sandboxes is None:
+            try:
+                # We need to lazy load the sandboxes module to handle the
+                # possibility of ImportError when dependencies are not installed.
+                self._sandboxes = importlib.import_module(".sandboxes", __package__)
+            except ImportError as e:
+                raise ImportError(
+                    "The agent_engines.sandboxes module requires additional"
+                    " packages. Please install them using pip install"
+                    " google-cloud-aiplatform[agent_engines]"
+                ) from e
+        return self._sandboxes.Sandboxes(self._api_client)
+
     @property
     @_common.experimental_warning(
         "The Vertex SDK GenAI agent_engines.sessions module is experimental, "