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

PiperOrigin-RevId: 801031399

Author: vertex-sdk-bot

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

@@ -0,0 +1,48 @@
+# 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.machine_config
+        == "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.sandboxes.create",
+)

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

@@ -0,0 +1,46 @@
+# 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_delete_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)
+    delete_operation = client.agent_engines.sandboxes.delete(
+        name=operation.response.name,
+    )
+    assert isinstance(delete_operation, types.DeleteAgentEngineSandboxOperation)
+    assert "/operations/" in delete_operation.name
+
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method="agent_engines.sandboxes.delete",
+)

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

@@ -0,0 +1,51 @@
+# 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_execute_code_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)
+    input_data = {
+        "language": "python",
+        "code": 'with open("hello.txt","w") as file:\n file.write("Hello, world!")',
+    }
+    response = client.agent_engines.sandboxes.execute_code(
+        name=operation.response.name,
+        input_data=input_data,
+    )
+    assert response.outputs[0].mime_type == "application/json"
+
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method="agent_engines.sandboxes.execute_code",
+)

tests/unit/vertexai/genai/replays/test_get_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_get_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)
+    sandbox = client.agent_engines.sandboxes.get(
+        name=operation.response.name,
+    )
+    assert isinstance(sandbox, types.SandboxEnvironment)
+    assert sandbox.name == operation.response.name
+
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method="agent_engines.sandboxes.get",
+)

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

@@ -0,0 +1,52 @@
+# 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_list_sandboxes(client):
+    agent_engine = client.agent_engines.create()
+    assert not list(
+        client.agent_engines.sandboxes.list(
+            name=agent_engine.api_resource.name,
+        )
+    )
+
+    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)
+
+    sandbox_list = client.agent_engines.sandboxes.list(
+        name=agent_engine.api_resource.name,
+    )
+    assert len(sandbox_list) == 1
+    assert isinstance(sandbox_list[0], types.SandboxEnvironment)
+    assert sandbox_list[0].name == operation.response.name
+
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+    test_method="agent_engines.sandboxes.list",
+)

vertexai/_genai/_agent_engines_utils.py

@@ -367,14 +367,14 @@ def _await_operation(
     *,
     operation_name: str,
     get_operation_fn: GetOperationFunction,
-    poll_interval_seconds: int = 10,
+    poll_interval_seconds: float = 10,
 ) -> Any:
     """Waits for the operation for creating an agent engine to complete.
 
     Args:
         operation_name (str):
             Required. The name of the operation for creating the Agent Engine.
-        poll_interval_seconds (int):
+        poll_interval_seconds (float):
             The number of seconds to wait between each poll.
         get_operation_fn (Callable[[str], Any]):
             Optional. The function to use for getting the operation. If not

vertexai/_genai/agent_engines.py

@@ -845,6 +845,7 @@ def _update(
         return return_value
 
     _memories = None
+    _sandboxes = None
     _sessions = None
 
     @property
@@ -862,6 +863,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
     def sessions(self):
         if self._sessions is None: