feat: support setting current_page to resume sessions; expose transit…

…ion_route_groups in flows and language_code in webhook (#91)

PiperOrigin-RevId: 367052612
Source-Link: googleapis/googleapis@9a386bc
Source-Link: googleapis/googleapis-gen@0801046
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/flow.proto

@@ -225,6 +225,20 @@ message Flow {
   // get executed, with the rest being ignored.
   repeated EventHandler event_handlers = 10;
 
+  // A flow's transition route group serve two purposes:
+  //
+  // *   They are responsible for matching the user's first utterances in the
+  // flow.
+  // *   They are inherited by every page's [transition
+  // route groups][Page.transition_route_groups]. Transition route groups
+  // defined in the page have higher priority than those defined in the flow.
+  //
+  // Format:`projects/<Project ID>/locations/<Location ID>/agents/<Agent
+  // ID>/flows/<Flow ID>/transitionRouteGroups/<TransitionRouteGroup ID>`.
+  repeated string transition_route_groups = 15 [(google.api.resource_reference) = {
+                                                  type: "dialogflow.googleapis.com/TransitionRouteGroup"
+                                                }];
+
   // NLU related settings of the flow.
   NluSettings nlu_settings = 11;
 }

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/intent.proto

@@ -199,7 +199,7 @@ message Intent {
   // fallback intents act as negative examples that triggers no-match event.
   bool is_fallback = 6;
 
-  // Optional. The key/value metadata to label an intent. Labels can contain
+  // The key/value metadata to label an intent. Labels can contain
   // lowercase letters, digits and the symbols '-' and '_'. International
   // characters are allowed, including letters from unicase alphabets. Keys must
   // start with a letter. Keys and values can be no longer than 63 characters
@@ -211,11 +211,11 @@ message Intent {
   // * sys-contextual
   // The above labels do not require value. "sys-head" means the intent is a
   // head intent. "sys-contextual" means the intent is a contextual intent.
-  map<string, string> labels = 7 [(google.api.field_behavior) = OPTIONAL];
+  map<string, string> labels = 7;
 
-  // Optional. Human readable description for better understanding an intent like its
+  // Human readable description for better understanding an intent like its
   // scope, content, result etc. Maximum character limit: 140 characters.
-  string description = 8 [(google.api.field_behavior) = OPTIONAL];
+  string description = 8;
 }
 
 // The request message for [Intents.ListIntents][google.cloud.dialogflow.cx.v3beta1.Intents.ListIntents].

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/session.proto

@@ -388,6 +388,21 @@ message QueryParameters {
   //     -   Else: parameter value
   google.protobuf.Struct parameters = 5;
 
+  // The unique identifier of the [page][google.cloud.dialogflow.cx.v3beta1.Page] to override the [current
+  // page][QueryResult.current_page] in the session. Format: `projects/<Project
+  // ID>/locations/<Location ID>/agents/<Agent ID>/pages/<page ID>`.
+  //
+  // If `current_page` is specified, the previous state of the session will be
+  // ignored by Dialogflow, including the [previous
+  // page][QueryResult.current_page] and the [previous session
+  // parameters][QueryResult.parameters].
+  // In most cases, [current_page][google.cloud.dialogflow.cx.v3beta1.QueryParameters.current_page] and
+  // [parameters][google.cloud.dialogflow.cx.v3beta1.QueryParameters.parameters] should be configured together to
+  // direct a session to a specific state.
+  string current_page = 6 [(google.api.resource_reference) = {
+                             type: "dialogflow.googleapis.com/Page"
+                           }];
+
   // Whether to disable webhook calls for this request.
   bool disable_webhook = 7;
 

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/webhook.proto

@@ -314,6 +314,10 @@ message WebhookRequest {
     string trigger_event = 14;
   }
 
+  // The language code specified in the [original
+  // request][QueryInput.language_code].
+  string language_code = 15;
+
   // Always present. Information about the fulfillment that triggered this
   // webhook call.
   FulfillmentInfo fulfillment_info = 6;