feat: A new field opt_out_conformer_model_migration is added to mes…

…sage `.google.cloud.dialogflow.cx.v3.InputAudioConfig` feat: A new field `language_code` is added to message `.google.cloud.dialogflow.cx.v3.Changelog` feat: A new method `ExportEntityTypes` is added to service `EntityTypes` feat: A new method `ImportEntityTypes` is added to service `EntityTypes` feat: A new message `ExportEntityTypesRequest` is added feat: A new message `ExportEntityTypesResponse` is added feat: A new message `ExportEntityTypesMetadata` is added feat: A new message `ImportEntityTypesRequest` is added feat: A new message `ImportEntityTypesResponse` is added feat: A new message `ImportEntityTypesMetadata` is added feat: A new field `disable_data_store_fallback` is added to message `.google.cloud.dialogflow.cx.v3.GenerativeSettings` feat: A new field `description` is added to message `.google.cloud.dialogflow.cx.v3.Page` feat: A new method `ServerStreamingDetectIntent` is added to service `Sessions` feat: A new field `webhook_ids` is added to message `.google.cloud.dialogflow.cx.v3.QueryResult` feat: A new field `webhook_display_names` is added to message `.google.cloud.dialogflow.cx.v3.QueryResult` feat: A new field `webhook_latencies` is added to message `.google.cloud.dialogflow.cx.v3.QueryResult` feat: A new field `webhook_tags` is added to message `.google.cloud.dialogflow.cx.v3.QueryResult` feat: A new field `current_flow` is added to message `.google.cloud.dialogflow.cx.v3.QueryResult` docs: A comment for field `start_flow` in message `.google.cloud.dialogflow.cx.v3.Agent` is changed docs: A comment for enum value `USE_BEST_AVAILABLE` in enum `SpeechModelVariant` is changed docs: A comment for enum value `USE_ENHANCED` in enum `SpeechModelVariant` is changed docs: A comment for field `model` in message `.google.cloud.dialogflow.cx.v3.InputAudioConfig` is changed docs: A comment for enum value `END_OF_SINGLE_UTTERANCE` in enum `MessageType` is changed docs: A comment for field `session_ttl` in message `.google.cloud.dialogflow.cx.v3.QueryParameters` is changed docs: A comment for message `QueryInput` is changed docs: A comment for field `text` in message `.google.cloud.dialogflow.cx.v3.TextInput` is changed PiperOrigin-RevId: 605402250
googleapis · Feb 8, 2024 · 802bb2c · 802bb2c
1 parent fbcfef0
commit 802bb2c
Show file tree

Hide file tree

Showing 10 changed files with 306 additions and 39 deletions.
diff --git a/google/cloud/dialogflow/cx/v3/BUILD.bazel b/google/cloud/dialogflow/cx/v3/BUILD.bazel
@@ -106,8 +106,8 @@ java_gapic_library(
     rest_numeric_enums = True,
     service_yaml = "dialogflow_v3.yaml",
     test_deps = [
-        "//google/cloud/location:location_java_grpc",
         ":cx_java_grpc",
+        "//google/cloud/location:location_java_grpc",
     ],
     transport = "grpc+rest",
     deps = [
@@ -407,6 +407,7 @@ load(
 
 csharp_proto_library(
     name = "cx_csharp_proto",
+    extra_opts = [],
     deps = [":cx_proto"],
 )
 

diff --git a/google/cloud/dialogflow/cx/v3/agent.proto b/google/cloud/dialogflow/cx/v3/agent.proto
@@ -303,7 +303,8 @@ message Agent {
   // Immutable. Name of the start flow in this agent. A start flow will be
   // automatically created when the agent is created, and can only be deleted by
   // deleting the agent. Format: `projects/<Project ID>/locations/<Location
-  // ID>/agents/<Agent ID>/flows/<Flow ID>`.
+  // ID>/agents/<Agent ID>/flows/<Flow ID>`. Currently only the default start
+  // flow with id "00000000-0000-0000-0000-000000000000" is allowed.
   string start_flow = 16 [
     (google.api.field_behavior) = IMMUTABLE,
     (google.api.resource_reference) = { type: "dialogflow.googleapis.com/Flow" }

diff --git a/google/cloud/dialogflow/cx/v3/audio_config.proto b/google/cloud/dialogflow/cx/v3/audio_config.proto
@@ -97,10 +97,6 @@ enum SpeechModelVariant {
 
   // Use the best available variant of the [Speech
   // model][InputAudioConfig.model] that the caller is eligible for.
-  //
-  // Please see the [Dialogflow
-  // docs](https://cloud.google.com/dialogflow/docs/data-logging) for
-  // how to make your project eligible for enhanced models.
   USE_BEST_AVAILABLE = 1;
 
   // Use standard model variant even if an enhanced model is available.  See the
@@ -118,11 +114,6 @@ enum SpeechModelVariant {
   //   The [Cloud Speech
   //   documentation](https://cloud.google.com/speech-to-text/docs/enhanced-models)
   //   describes which models have enhanced variants.
-  //
-  // * If the API caller isn't eligible for enhanced models, Dialogflow returns
-  //   an error.  Please see the [Dialogflow
-  //   docs](https://cloud.google.com/dialogflow/docs/data-logging)
-  //   for how to make your project eligible.
   USE_ENHANCED = 3;
 }
 
@@ -212,28 +203,10 @@ message InputAudioConfig {
   // for more details.
   repeated string phrase_hints = 4;
 
-  // Optional. Which Speech model to select for the given request. Select the
-  // model best suited to your domain to get best results. If a model is not
-  // explicitly specified, then Dialogflow auto-selects a model based on other
-  // parameters in the InputAudioConfig and Agent settings.
-  // If enhanced speech model is enabled for the agent and an enhanced
-  // version of the specified model for the language does not exist, then the
-  // speech is recognized using the standard version of the specified model.
-  // Refer to
-  // [Cloud Speech API
-  // documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model)
-  // for more details.
-  // If you specify a model, the following models typically have the best
-  // performance:
-  //
-  // - phone_call (best for Agent Assist and telephony)
-  // - latest_short (best for Dialogflow non-telephony)
-  // - command_and_search
-  //
-  // Leave this field unspecified to use
-  // [Agent Speech
-  // settings](https://cloud.google.com/dialogflow/cx/docs/concept/agent#settings-speech)
-  // for model selection.
+  // Optional. Which Speech model to select for the given request.
+  // For more information, see
+  // [Speech
+  // models](https://cloud.google.com/dialogflow/cx/docs/concept/speech-models).
   string model = 7;
 
   // Optional. Which variant of the [Speech
@@ -252,6 +225,12 @@ message InputAudioConfig {
 
   // Configuration of barge-in behavior during the streaming of input audio.
   BargeInConfig barge_in_config = 15;
+
+  // If `true`, the request will opt out for STT conformer model migration.
+  // This field will be deprecated once force migration takes place in June
+  // 2024. Please refer to [Dialogflow CX Speech model
+  // migration](https://cloud.google.com/dialogflow/cx/docs/concept/speech-model-migration).
+  bool opt_out_conformer_model_migration = 26;
 }
 
 // Gender of the voice as described in

diff --git a/google/cloud/dialogflow/cx/v3/changelog.proto b/google/cloud/dialogflow/cx/v3/changelog.proto
@@ -153,4 +153,7 @@ message Changelog {
 
   // The timestamp of the change.
   google.protobuf.Timestamp create_time = 4;
+
+  // The affected language code of the change.
+  string language_code = 14;
 }
diff --git a/google/cloud/dialogflow/cx/v3/dialogflow_grpc_service_config.json b/google/cloud/dialogflow/cx/v3/dialogflow_grpc_service_config.json
@@ -11,6 +11,9 @@
         {
           "service": "google.cloud.dialogflow.cx.v3.Deployments"
         },
+        {
+          "service": "google.cloud.dialogflow.cx.v3.EncryptionSpecService"
+        },
         {
           "service": "google.cloud.dialogflow.cx.v3.EntityTypes"
         },
@@ -35,6 +38,15 @@
         {
           "service": "google.cloud.dialogflow.cx.v3.Pages"
         },
+        {
+          "service": "google.cloud.dialogflow.cx.v3.Playbooks"
+        },
+        {
+          "service": "google.cloud.dialogflow.cx.v3.Examples"
+        },
+        {
+          "service": "google.cloud.dialogflow.cx.v3.Tools"
+        },
         {
           "service": "google.cloud.dialogflow.cx.v3.SecuritySettingsService"
         },

diff --git a/google/cloud/dialogflow/cx/v3/dialogflow_v3.yaml b/google/cloud/dialogflow/cx/v3/dialogflow_v3.yaml
@@ -31,11 +31,15 @@ types:
 - name: google.cloud.dialogflow.cx.v3.DeployFlowMetadata
 - name: google.cloud.dialogflow.cx.v3.DeployFlowResponse
 - name: google.cloud.dialogflow.cx.v3.ExportAgentResponse
+- name: google.cloud.dialogflow.cx.v3.ExportEntityTypesMetadata
+- name: google.cloud.dialogflow.cx.v3.ExportEntityTypesResponse
 - name: google.cloud.dialogflow.cx.v3.ExportFlowResponse
 - name: google.cloud.dialogflow.cx.v3.ExportIntentsMetadata
 - name: google.cloud.dialogflow.cx.v3.ExportIntentsResponse
 - name: google.cloud.dialogflow.cx.v3.ExportTestCasesMetadata
 - name: google.cloud.dialogflow.cx.v3.ExportTestCasesResponse
+- name: google.cloud.dialogflow.cx.v3.ImportEntityTypesMetadata
+- name: google.cloud.dialogflow.cx.v3.ImportEntityTypesResponse
 - name: google.cloud.dialogflow.cx.v3.ImportFlowResponse
 - name: google.cloud.dialogflow.cx.v3.ImportIntentsMetadata
 - name: google.cloud.dialogflow.cx.v3.ImportIntentsResponse

diff --git a/google/cloud/dialogflow/cx/v3/entity_type.proto b/google/cloud/dialogflow/cx/v3/entity_type.proto
@@ -20,6 +20,8 @@ import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/cloud/dialogflow/cx/v3/inline.proto";
+import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 
@@ -94,6 +96,32 @@ service EntityTypes {
     };
     option (google.api.method_signature) = "parent";
   }
+
+  // Exports the selected entity types.
+  rpc ExportEntityTypes(ExportEntityTypesRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v3/{parent=projects/*/locations/*/agents/*}/entityTypes:export"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "ExportEntityTypesResponse"
+      metadata_type: "ExportEntityTypesMetadata"
+    };
+  }
+
+  // Imports the specified entitytypes into the agent.
+  rpc ImportEntityTypes(ImportEntityTypesRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v3/{parent=projects/*/locations/*/agents/*}/entityTypes:import"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "ImportEntityTypesResponse"
+      metadata_type: "ImportEntityTypesMetadata"
+    };
+  }
 }
 
 // Entities are extracted from user input and represent parameters that are
@@ -230,6 +258,202 @@ message EntityType {
   bool redact = 9;
 }
 
+// The request message for
+// [EntityTypes.ExportEntityTypes][google.cloud.dialogflow.cx.v3.EntityTypes.ExportEntityTypes].
+message ExportEntityTypesRequest {
+  // Data format of the exported entity types.
+  enum DataFormat {
+    // Unspecified format. Treated as `BLOB`.
+    DATA_FORMAT_UNSPECIFIED = 0;
+
+    // EntityTypes will be exported as raw bytes.
+    BLOB = 1;
+
+    // EntityTypes will be exported in JSON Package format.
+    JSON_PACKAGE = 5;
+  }
+
+  // Required. The name of the parent agent to export entity types.
+  // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+  // ID>`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "dialogflow.googleapis.com/EntityType"
+    }
+  ];
+
+  // Required. The name of the entity types to export.
+  // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+  // ID>/entityTypes/<EntityType ID>`.
+  repeated string entity_types = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // The destination to export.
+  oneof destination {
+    // Optional. The [Google Cloud
+    // Storage](https://cloud.google.com/storage/docs/) URI to export the entity
+    // types to. The format of this URI must be
+    // `gs://<bucket-name>/<object-name>`.
+    //
+    // Dialogflow performs a write operation for the Cloud Storage object
+    // on the caller's behalf, so your request authentication must
+    // have write permissions for the object. For more information, see
+    // [Dialogflow access
+    // control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
+    string entity_types_uri = 3 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The option to return the serialized entity types inline.
+    bool entity_types_content_inline = 4
+        [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Optional. The data format of the exported entity types. If not specified,
+  // `BLOB` is assumed.
+  DataFormat data_format = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The language to retrieve the entity type for. The following
+  // fields are language dependent:
+  //
+  // *   `EntityType.entities.value`
+  // *   `EntityType.entities.synonyms`
+  // *   `EntityType.excluded_phrases.value`
+  //
+  // If not specified, all language dependent fields will be retrieved.
+  // [Many
+  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // are supported.
+  // Note: languages must be enabled in the agent before they can be used.
+  string language_code = 6 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The response message for
+// [EntityTypes.ExportEntityTypes][google.cloud.dialogflow.cx.v3.EntityTypes.ExportEntityTypes].
+message ExportEntityTypesResponse {
+  // Exported entity types can be either in cloud storage or local download.
+  oneof exported_entity_types {
+    // The URI to a file containing the exported entity types. This field is
+    // populated only if `entity_types_uri` is specified in
+    // [ExportEntityTypesRequest][google.cloud.dialogflow.cx.v3.ExportEntityTypesRequest].
+    string entity_types_uri = 1;
+
+    // Uncompressed byte content for entity types. This field is populated only
+    // if `entity_types_content_inline` is set to true in
+    // [ExportEntityTypesRequest][google.cloud.dialogflow.cx.v3.ExportEntityTypesRequest].
+    InlineDestination entity_types_content = 2;
+  }
+}
+
+// Metadata returned for the
+// [EntityTypes.ExportEntityTypes][google.cloud.dialogflow.cx.v3.EntityTypes.ExportEntityTypes]
+// long running operation.
+message ExportEntityTypesMetadata {}
+
+// The request message for
+// [EntityTypes.ImportEntityTypes][google.cloud.dialogflow.cx.v3.EntityTypes.ImportEntityTypes].
+message ImportEntityTypesRequest {
+  // Merge option when display name conflicts exist during import.
+  enum MergeOption {
+    // Unspecified. If used, system uses REPORT_CONFLICT as default.
+    MERGE_OPTION_UNSPECIFIED = 0;
+
+    // Replace the original entity type in the agent with the new entity type
+    // when display name conflicts exist.
+    REPLACE = 1;
+
+    // Merge the original entity type with the new entity type when display name
+    // conflicts exist.
+    MERGE = 2;
+
+    // Create new entity types with new display names to differentiate them from
+    // the existing entity types when display name conflicts exist.
+    RENAME = 3;
+
+    // Report conflict information if display names conflict is detected.
+    // Otherwise, import entity types.
+    REPORT_CONFLICT = 4;
+
+    // Keep the original entity type and discard the conflicting new entity type
+    // when display name conflicts exist.
+    KEEP = 5;
+  }
+
+  // Required. The agent to import the entity types into.
+  // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "dialogflow.googleapis.com/EntityType"
+    }
+  ];
+
+  // Required. The entity types to import.
+  oneof entity_types {
+    // The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI
+    // to import entity types from. The format of this URI must be
+    // `gs://<bucket-name>/<object-name>`.
+    //
+    // Dialogflow performs a read operation for the Cloud Storage object
+    // on the caller's behalf, so your request authentication must
+    // have read permissions for the object. For more information, see
+    // [Dialogflow access
+    // control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
+    string entity_types_uri = 2;
+
+    // Uncompressed byte content of entity types.
+    InlineSource entity_types_content = 3;
+  }
+
+  // Required. Merge option for importing entity types.
+  MergeOption merge_option = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The target entity type to import into.
+  // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+  // ID>/entity_types/<EntityType ID>`.
+  // If set, there should be only one entity type included in
+  // [entity_types][google.cloud.dialogflow.cx.v3.ImportEntityTypesRequest.entity_types],
+  // of which the type should match the type of the target entity type. All
+  // [entities][google.cloud.dialogflow.cx.v3.EntityType.entities] in the
+  // imported entity type will be added to the target entity type.
+  string target_entity_type = 5 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "dialogflow.googleapis.com/EntityType"
+    }
+  ];
+}
+
+// The response message for
+// [EntityTypes.ImportEntityTypes][google.cloud.dialogflow.cx.v3.EntityTypes.ImportEntityTypes].
+message ImportEntityTypesResponse {
+  // Conflicting resources detected during the import process. Only filled when
+  // [REPORT_CONFLICT][ImportEntityTypesResponse.REPORT_CONFLICT] is set in the
+  // request and there are conflicts in the display names.
+  message ConflictingResources {
+    // Display names of conflicting entity types.
+    repeated string entity_type_display_names = 1;
+
+    // Display names of conflicting entities.
+    repeated string entity_display_names = 2;
+  }
+
+  // The unique identifier of the imported entity types.
+  // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
+  // ID>/entity_types/<EntityType ID>`.
+  repeated string entity_types = 1 [(google.api.resource_reference) = {
+    type: "dialogflow.googleapis.com/EntityType"
+  }];
+
+  // Info which resources have conflicts when
+  // [REPORT_CONFLICT][ImportEntityTypesResponse.REPORT_CONFLICT] merge_option
+  // is set in ImportEntityTypesRequest.
+  ConflictingResources conflicting_resources = 2;
+}
+
+// Metadata returned for the
+// [EntityTypes.ImportEntityTypes][google.cloud.dialogflow.cx.v3.EntityTypes.ImportEntityTypes]
+// long running operation.
+message ImportEntityTypesMetadata {}
+
 // The request message for
 // [EntityTypes.ListEntityTypes][google.cloud.dialogflow.cx.v3.EntityTypes.ListEntityTypes].
 message ListEntityTypesRequest {