feat: GenAI SDK client - Agent Engine Session SDK

PiperOrigin-RevId: 789182389

Author: shawn-yang-google

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

@@ -0,0 +1,45 @@
+# 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_session(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.create_session(
+ name=agent_engine.api_resource.name,
+ user_id="test-user-123",
+ config=types.CreateAgentEngineSessionConfig(
+ display_name="my_session",
+ session_state={"foo": "bar"},
+ ),
+ )
+ assert isinstance(operation, types.AgentEngineSessionOperation)
+ assert operation.response.display_name == "my_session"
+ assert operation.response.session_state == {"foo": "bar"}
+ assert operation.response.user_id == "test-user-123"
+ 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_session",
+)

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

@@ -0,0 +1,37 @@
+# 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_session(client):
+ agent_engine = client.agent_engines.create()
+ operation = client.agent_engines.create_session(
+ name=agent_engine.api_resource.name,
+ user_id="test-user-123",
+ )
+ session = operation.response
+ operation = client.agent_engines.delete_session(name=session.name)
+ assert isinstance(operation, types.DeleteAgentEngineSessionOperation)
+ assert "/operations/" in operation.name
+
+
+pytestmark = pytest_helper.setup(
+ file=__file__,
+ globals_for_file=globals(),
+ test_method="agent_engines.delete_session",
+)

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

@@ -0,0 +1,39 @@
+# 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_session(client):
+ agent_engine = client.agent_engines.create()
+ operation = client.agent_engines.create_session(
+ name=agent_engine.api_resource.name,
+ user_id="test-user-123",
+ )
+ assert isinstance(operation, types.AgentEngineSessionOperation)
+ session = client.agent_engines.get_session(
+ name=operation.response.name,
+ )
+ assert isinstance(session, types.Session)
+ assert session.name == operation.response.name
+
+
+pytestmark = pytest_helper.setup(
+ file=__file__,
+ globals_for_file=globals(),
+ test_method="agent_engines.get_session",
+)

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

@@ -0,0 +1,43 @@
+# 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_sessions(client):
+ agent_engine = client.agent_engines.create()
+ assert not list(
+ client.agent_engines.list_sessions(
+ name=agent_engine.api_resource.name,
+ )
+ )
+ client.agent_engines.create_session(
+ name=agent_engine.api_resource.name,
+ user_id="test-user-123",
+ )
+ session_list = client.agent_engines.list_sessions(
+ name=agent_engine.api_resource.name,
+ )
+ assert len(session_list) == 1
+ assert isinstance(session_list[0], types.Session)
+
+
+pytestmark = pytest_helper.setup(
+ file=__file__,
+ globals_for_file=globals(),
+ test_method="agent_engines.list_sessions",
+)