feat: added gcs.proto. added support for GcsDestination and TextToSpe…

…echSettings. feat!: Remove [REQUIRED] for VersionConfig docs: add more meaningful comments PiperOrigin-RevId: 510257108
googleapis · Feb 16, 2023 · 140334b · 140334b
1 parent 58e4422
commit 140334b
Show file tree

Hide file tree

Showing 8 changed files with 68 additions and 4 deletions.
diff --git a/google/cloud/dialogflow/cx/v3beta1/BUILD.bazel b/google/cloud/dialogflow/cx/v3beta1/BUILD.bazel
@@ -31,6 +31,7 @@ proto_library(
         "experiment.proto",
         "flow.proto",
         "fulfillment.proto",
+        "gcs.proto",
         "intent.proto",
         "page.proto",
         "response_message.proto",

diff --git a/google/cloud/dialogflow/cx/v3beta1/advanced_settings.proto b/google/cloud/dialogflow/cx/v3beta1/advanced_settings.proto
@@ -17,6 +17,7 @@ syntax = "proto3";
 package google.cloud.dialogflow.cx.v3beta1;
 
 import "google/api/field_behavior.proto";
+import "google/cloud/dialogflow/cx/v3beta1/gcs.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3Beta1";
@@ -48,6 +49,13 @@ message AdvancedSettings {
     bool enable_interaction_logging = 3;
   }
 
+  // If present, incoming audio is exported by Dialogflow to the configured
+  // Google Cloud Storage destination.
+  // Exposed at the following levels:
+  // - Agent level
+  // - Flow level
+  GcsDestination audio_export_gcs_destination = 2;
+
   // Settings for logging.
   // Settings for Dialogflow History, Contact Center messages, StackDriver logs,
   // and speech logging.

diff --git a/google/cloud/dialogflow/cx/v3beta1/agent.proto b/google/cloud/dialogflow/cx/v3beta1/agent.proto
@@ -21,10 +21,12 @@ import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/dialogflow/cx/v3beta1/advanced_settings.proto";
+import "google/cloud/dialogflow/cx/v3beta1/audio_config.proto";
 import "google/cloud/dialogflow/cx/v3beta1/flow.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3Beta1";
@@ -266,6 +268,10 @@ message Agent {
   // Hierarchical advanced settings for this agent. The settings exposed at the
   // lower level overrides the settings exposed at the higher level.
   AdvancedSettings advanced_settings = 22;
+
+  // Settings on instructing the speech synthesizer on how to generate the
+  // output audio content.
+  TextToSpeechSettings text_to_speech_settings = 31;
 }
 
 // The request message for

diff --git a/google/cloud/dialogflow/cx/v3beta1/audio_config.proto b/google/cloud/dialogflow/cx/v3beta1/audio_config.proto
@@ -316,3 +316,11 @@ message OutputAudioConfig {
   // Optional. Configuration of how speech should be synthesized.
   SynthesizeSpeechConfig synthesize_speech_config = 3;
 }
+
+// Settings related to speech generating.
+message TextToSpeechSettings {
+  // Configuration of how speech should be synthesized, mapping from
+  // language (https://dialogflow.com/docs/reference/language) to
+  // SynthesizeSpeechConfig.
+  map<string, SynthesizeSpeechConfig> synthesize_speech_configs = 1;
+}
diff --git a/google/cloud/dialogflow/cx/v3beta1/environment.proto b/google/cloud/dialogflow/cx/v3beta1/environment.proto
@@ -25,6 +25,7 @@ import "google/cloud/dialogflow/cx/v3beta1/webhook.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;
@@ -253,12 +254,11 @@ message Environment {
   // 500 characters. If exceeded, the request is rejected.
   string description = 3;
 
-  // Required. A list of configurations for flow versions. You should include
-  // version configs for all flows that are reachable from [`Start
+  // A list of configurations for flow versions. You should include version
+  // configs for all flows that are reachable from [`Start
   // Flow`][Agent.start_flow] in the agent. Otherwise, an error will be
   // returned.
-  repeated VersionConfig version_configs = 6
-      [(google.api.field_behavior) = REQUIRED];
+  repeated VersionConfig version_configs = 6;
 
   // Output only. Update time of this environment.
   google.protobuf.Timestamp update_time = 5

diff --git a/google/cloud/dialogflow/cx/v3beta1/flow.proto b/google/cloud/dialogflow/cx/v3beta1/flow.proto
@@ -25,6 +25,7 @@ import "google/cloud/dialogflow/cx/v3beta1/validation_message.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;

diff --git a/google/cloud/dialogflow/cx/v3beta1/gcs.proto b/google/cloud/dialogflow/cx/v3beta1/gcs.proto
@@ -0,0 +1,39 @@
+// Copyright 2022 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.
+
+syntax = "proto3";
+
+package google.cloud.dialogflow.cx.v3beta1;
+
+import "google/api/field_behavior.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3Beta1";
+option go_package = "cloud.google.com/go/dialogflow/cx/apiv3beta1/cxpb;cxpb";
+option java_multiple_files = true;
+option java_outer_classname = "GcsProto";
+option java_package = "com.google.cloud.dialogflow.cx.v3beta1";
+option objc_class_prefix = "DF";
+option ruby_package = "Google::Cloud::Dialogflow::CX::V3beta1";
+
+// Google Cloud Storage location for a Dialogflow operation that writes or
+// exports objects (e.g. exported agent or transcripts) outside of Dialogflow.
+message GcsDestination {
+  // Required. The Google Cloud Storage URI for the exported objects. A URI is
+  // of the form:
+  //   gs://bucket/object-name-or-prefix
+  // Whether a full object name, or just a prefix, its usage depends on the
+  // Dialogflow operation.
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/google/cloud/dialogflow/cx/v3beta1/version.proto b/google/cloud/dialogflow/cx/v3beta1/version.proto
@@ -24,6 +24,7 @@ import "google/cloud/dialogflow/cx/v3beta1/flow.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;