feat: provide new parameter cx_current_page, the unique identifier of…

… the CX page to override the `current_page` in the session. Add filter field to ListAnswerRecordsRequest. And add AudioInput to analysis requests docs: add more meaningful comments

PiperOrigin-RevId: 459325028
Source-Link: googleapis/googleapis@a076084
Source-Link: googleapis/googleapis-gen@278f4fd
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjc4ZjRmZGI0YTRlZjVmZjY4ZGEzZjQwZjMwMzY3Y2EzZTE3MTdiZiJ9
See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

protos/google/cloud/dialogflow/v2beta1/answer_record.proto

@@ -280,6 +280,17 @@ message ListAnswerRecordsRequest {
                        child_type: "dialogflow.googleapis.com/AnswerRecord"
                      }];
 
+  // Optional. Filters to restrict results to specific answer records.
+  //
+  // Marked deprecated as it hasn't been, and isn't currently, supported.
+  //
+  // For more information about filtering, see
+  // [API Filtering](https://aip.dev/160).
+  string filter = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+
   // Optional. The maximum number of records to return in a single page.
   // The server may return fewer records than this. If unspecified, we use 10.
   // The maximum is 100.

protos/google/cloud/dialogflow/v2beta1/conversation_profile.proto

@@ -437,7 +437,8 @@ message HumanAgentAssistantConfig {
 
   // Custom conversation models used in agent assist feature.
   //
-  // Supported feature: ARTICLE_SUGGESTION, SMART_COMPOSE, SMART_REPLY.
+  // Supported feature: ARTICLE_SUGGESTION, SMART_COMPOSE, SMART_REPLY,
+  // CONVERSATION_SUMMARIZATION.
   message ConversationModelConfig {
     // Conversation model resource name. Format: `projects/<Project
     // ID>/conversationModels/<Model ID>`.

protos/google/cloud/dialogflow/v2beta1/participant.proto

@@ -107,6 +107,7 @@ service Participants {
     };
     option (google.api.method_signature) = "participant,text_input";
     option (google.api.method_signature) = "participant,event_input";
+    option (google.api.method_signature) = "participant,audio_input";
   }
 
   // Adds a text (e.g., chat) or audio (e.g., phone recording) message from a
@@ -408,6 +409,17 @@ message UpdateParticipantRequest {
   google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
+// Represents the natural language speech audio to be processed.
+message AudioInput {
+  // Required. Instructs the speech recognizer how to process the speech audio.
+  InputAudioConfig config = 1;
+
+  // Required. The natural language speech audio to be processed.
+  // A single request can contain up to 1 minute of speech audio data.
+  // The transcribed text cannot contain more than 256 bytes.
+  bytes audio = 2;
+}
+
 // Represents the natural language speech audio to be played to the end user.
 message OutputAudio {
   // Required. Instructs the speech synthesizer how to generate the speech
@@ -544,6 +556,9 @@ message AnalyzeContentRequest {
     // The natural language text to be processed.
     TextInput text_input = 6;
 
+    // The natural language speech audio to be processed.
+    AudioInput audio_input = 7;
+
     // An input event to send to Dialogflow.
     EventInput event_input = 8;
   }
@@ -569,6 +584,22 @@ message AnalyzeContentRequest {
   // CX agent.
   google.protobuf.Struct cx_parameters = 18;
 
+  // The unique identifier of the CX page to override the `current_page` in the
+  // session.
+  // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+  // ID>/flows/<Flow ID>/pages/<Page ID>`.
+  //
+  // If `cx_current_page` is specified, the previous state of the session will
+  // be ignored by Dialogflow CX, including the [previous
+  // page][QueryResult.current_page] and the [previous session
+  // parameters][QueryResult.parameters]. In most cases, `cx_current_page` and
+  // `cx_parameters` should be configured together to direct a session to a
+  // specific state.
+  //
+  // Note: this field should only be used if you are connecting to a Dialogflow
+  // CX agent.
+  string cx_current_page = 20;
+
   // Optional. The send time of the message from end user or human agent's
   // perspective. It is used for identifying the same message under one
   // participant.
@@ -753,6 +784,22 @@ message StreamingAnalyzeContentRequest {
   // CX agent.
   google.protobuf.Struct cx_parameters = 13;
 
+  // The unique identifier of the CX page to override the `current_page` in the
+  // session.
+  // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+  // ID>/flows/<Flow ID>/pages/<Page ID>`.
+  //
+  // If `cx_current_page` is specified, the previous state of the session will
+  // be ignored by Dialogflow CX, including the [previous
+  // page][QueryResult.current_page] and the [previous session
+  // parameters][QueryResult.parameters]. In most cases, `cx_current_page` and
+  // `cx_parameters` should be configured together to direct a session to a
+  // specific state.
+  //
+  // Note: this field should only be used if you are connecting to a Dialogflow
+  // CX agent.
+  string cx_current_page = 15;
+
   // Enable partial virtual agent responses. If this flag is not enabled,
   // response stream still contains only one final response even if some
   // `Fulfillment`s in Dialogflow virtual agent have been configured to return

protos/google/cloud/dialogflow/v2beta1/session.proto

@@ -356,7 +356,8 @@ message QueryResult {
   bool all_required_params_present = 5;
 
   // Indicates whether the conversational query triggers a cancellation for slot
-  // filling.
+  // filling. For more information, see the [cancel slot filling
+  // documentation](https://cloud.google.com/dialogflow/es/docs/intents-actions-parameters#cancel).
   bool cancels_slot_filling = 21;
 
   // The text to be pronounced to the user or shown on the screen.