fix!: Removed support for session resource paths that do not include reasoning engine

Google APIs · copybara-github · commit 404a0ad946e9 · 2025-04-21T17:25:02.000-07:00
feat: Deprecated EventActions.transfer_to_agent and replaced with EventActions.transfer_agent

PiperOrigin-RevId: 749972321
diff --git a/google/cloud/aiplatform/v1beta1/session.proto b/google/cloud/aiplatform/v1beta1/session.proto
@@ -34,7 +34,6 @@ option ruby_package = "Google::Cloud::AIPlatform::V1beta1";
 message Session {
   option (google.api.resource) = {
     type: "aiplatform.googleapis.com/Session"
-    pattern: "projects/{project}/locations/{location}/sessions/{session}"
     pattern: "projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}"
     plural: "sessions"
     singular: "session"
@@ -74,7 +73,6 @@ message Session {
 message SessionEvent {
   option (google.api.resource) = {
     type: "aiplatform.googleapis.com/SessionEvent"
-    pattern: "projects/{project}/locations/{location}/sessions/{session}/events/{event}"
     pattern: "projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}/events/{event}"
     plural: "sessionEvents"
     singular: "sessionEvent"
@@ -162,8 +160,8 @@ message EventActions {
   map<string, int32> artifact_delta = 3
       [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. If set, the event transfers to the specified agent.
-  bool transfer_to_agent = 5 [(google.api.field_behavior) = OPTIONAL];
+  // Deprecated. If set, the event transfers to the specified agent.
+  bool transfer_to_agent = 5 [deprecated = true];
 
   // Optional. The agent is escalating to a higher level agent.
   bool escalate = 6 [(google.api.field_behavior) = OPTIONAL];
@@ -174,4 +172,7 @@ message EventActions {
   // required auth config, which can be another struct.
   google.protobuf.Struct requested_auth_configs = 7
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If set, the event transfers to the specified agent.
+  string transfer_agent = 8 [(google.api.field_behavior) = OPTIONAL];
 }
diff --git a/google/cloud/aiplatform/v1beta1/session_service.proto b/google/cloud/aiplatform/v1beta1/session_service.proto
@@ -40,17 +40,12 @@ service SessionService {
   option (google.api.oauth_scopes) =
       "https://www.googleapis.com/auth/cloud-platform";
 
-  // Creates a new [Session][google.cloud.aiplatform.v1beta1.Session] in a given
-  // project and location.
+  // Creates a new [Session][google.cloud.aiplatform.v1beta1.Session].
   rpc CreateSession(CreateSessionRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
-      post: "/v1beta1/{parent=projects/*/locations/*}/sessions"
+      post: "/v1beta1/{parent=projects/*/locations/*/reasoningEngines/*}/sessions"
       body: "session"
-      additional_bindings {
-        post: "/v1beta1/{parent=projects/*/locations/*/reasoningEngines/*}/sessions"
-        body: "session"
-      }
     };
     option (google.api.method_signature) = "parent,session";
     option (google.longrunning.operation_info) = {
@@ -63,35 +58,25 @@ service SessionService {
   // [Session][google.cloud.aiplatform.v1beta1.Session].
   rpc GetSession(GetSessionRequest) returns (Session) {
     option (google.api.http) = {
-      get: "/v1beta1/{name=projects/*/locations/*/sessions/*}"
-      additional_bindings {
-        get: "/v1beta1/{name=projects/*/locations/*/reasoningEngines/*/sessions/*}"
-      }
+      get: "/v1beta1/{name=projects/*/locations/*/reasoningEngines/*/sessions/*}"
     };
     option (google.api.method_signature) = "name";
   }
 
   // Lists [Sessions][google.cloud.aiplatform.v1beta1.Session] in a given
-  // project and location.
+  // reasoning engine.
   rpc ListSessions(ListSessionsRequest) returns (ListSessionsResponse) {
     option (google.api.http) = {
-      get: "/v1beta1/{parent=projects/*/locations/*}/sessions"
-      additional_bindings {
-        get: "/v1beta1/{parent=projects/*/locations/*/reasoningEngines/*}/sessions"
-      }
+      get: "/v1beta1/{parent=projects/*/locations/*/reasoningEngines/*}/sessions"
     };
     option (google.api.method_signature) = "parent";
   }
 
   // Updates the specific [Session][google.cloud.aiplatform.v1beta1.Session].
   rpc UpdateSession(UpdateSessionRequest) returns (Session) {
     option (google.api.http) = {
-      patch: "/v1beta1/{session.name=projects/*/locations/*/sessions/*}"
+      patch: "/v1beta1/{session.name=projects/*/locations/*/reasoningEngines/*/sessions/*}"
       body: "session"
-      additional_bindings {
-        patch: "/v1beta1/{session.name=projects/*/locations/*/reasoningEngines/*/sessions/*}"
-        body: "session"
-      }
     };
     option (google.api.method_signature) = "session,update_mask";
   }
@@ -101,10 +86,7 @@ service SessionService {
   rpc DeleteSession(DeleteSessionRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
-      delete: "/v1beta1/{name=projects/*/locations/*/sessions/*}"
-      additional_bindings {
-        delete: "/v1beta1/{name=projects/*/locations/*/reasoningEngines/*/sessions/*}"
-      }
+      delete: "/v1beta1/{name=projects/*/locations/*/reasoningEngines/*/sessions/*}"
     };
     option (google.api.method_signature) = "name";
     option (google.longrunning.operation_info) = {
@@ -117,9 +99,6 @@ service SessionService {
   rpc ListEvents(ListEventsRequest) returns (ListEventsResponse) {
     option (google.api.http) = {
       get: "/v1beta1/{parent=projects/*/locations/*/reasoningEngines/*/sessions/*}/events"
-      additional_bindings {
-        get: "/v1beta1/{parent=projects/*/locations/*/sessions/*}/events"
-      }
     };
     option (google.api.method_signature) = "parent";
   }
@@ -138,7 +117,7 @@ service SessionService {
 // [SessionService.CreateSession][google.cloud.aiplatform.v1beta1.SessionService.CreateSession].
 message CreateSessionRequest {
   // Required. The resource name of the location to create the session in.
-  // Format: `projects/{project}/locations/{location}` or
+  // Format:
   // `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}`
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
@@ -246,7 +225,6 @@ message UpdateSessionRequest {
 message DeleteSessionRequest {
   // Required. The resource name of the session.
   // Format:
-  // `projects/{project}/locations/{location}/sessions/{session}` or
   // `projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
@@ -271,6 +249,7 @@ message ListEventsRequest {
 
   // Optional. The maximum number of events to return. The service may return
   // fewer than this value. If unspecified, at most 100 events will be returned.
+  // These events are ordered by timestamp in ascending order.
   int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The
@@ -284,7 +263,8 @@ message ListEventsRequest {
 // Response message for
 // [SessionService.ListEvents][google.cloud.aiplatform.v1beta1.SessionService.ListEvents].
 message ListEventsResponse {
-  // A list of events matching the request.
+  // A list of events matching the request. Ordered by timestamp in ascending
+  // order.
   repeated SessionEvent session_events = 1;
 
   // A token, which can be sent as
