feat: support setting current_page to resume sessions; expose transition_route_groups in flows and language_code in webhook (#90)

PiperOrigin-RevId: 367042726 Source-Link: googleapis/googleapis@163ed6c Source-Link: https://github.com/googleapis/googleapis-gen/commit/3e5eb0f5399b760ea4b3003cbfb89c4e5db8f70e

Author: gcf-owl-bot[bot]

protos/google/cloud/dialogflow/cx/v3/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;
 }

protos/google/cloud/dialogflow/cx/v3/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.v3.Intents.ListIntents].

protos/google/cloud/dialogflow/cx/v3/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.v3.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.v3.QueryParameters.current_page] and
+ // [parameters][google.cloud.dialogflow.cx.v3.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;
 

protos/google/cloud/dialogflow/cx/v3/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;