feat: added support for locking an agent for changes

Google APIs · copybara-github · commit daffb064bf5d · 2022-03-28T14:00:46.000-07:00
feat: added data format specification for export agent

PiperOrigin-RevId: 437848093
diff --git a/google/cloud/dialogflow/cx/v3beta1/agent.proto b/google/cloud/dialogflow/cx/v3beta1/agent.proto
@@ -249,6 +249,10 @@ message Agent {
   // requests.
   bool enable_spell_correction = 20;
 
+  // Indiciates whether the agent is locked for changes. If the agent is locked,
+  // modifications to the agent will be rejected except for [RestoreAgent][].
+  bool locked = 27;
+
   // 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;
@@ -335,6 +339,15 @@ message DeleteAgentRequest {
 
 // The request message for [Agents.ExportAgent][google.cloud.dialogflow.cx.v3beta1.Agents.ExportAgent].
 message ExportAgentRequest {
+  // Data format of the exported agent.
+  enum DataFormat {
+    // Unspecified format.
+    DATA_FORMAT_UNSPECIFIED = 0;
+
+    // Agent content will be exported as raw bytes.
+    BLOB = 1;
+  }
+
   // Required. The name of the agent to export.
   // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>`.
   string name = 1 [
@@ -356,6 +369,9 @@ message ExportAgentRequest {
   // control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
   string agent_uri = 2 [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. The data format of the exported agent. If not specified, `BLOB` is assumed.
+  DataFormat data_format = 3 [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. Environment name. If not set, draft environment is assumed.
   // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
   // ID>/environments/<Environment ID>`.
diff --git a/google/cloud/dialogflow/cx/v3beta1/session.proto b/google/cloud/dialogflow/cx/v3beta1/session.proto
@@ -198,26 +198,27 @@ message DetectIntentResponse {
 //
 // Multiple request messages should be sent in order:
 //
-// 1. The first message must contain
-// [session][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.session],
-// [query_input][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.query_input] plus optionally
-// [query_params][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.query_params]. If the client
-// wants to receive an audio response, it should also contain
-// [output_audio_config][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.output_audio_config].
+// 1.  The first message must contain
+//     [session][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.session],
+//     [query_input][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.query_input] plus optionally
+//     [query_params][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.query_params]. If the client
+//     wants to receive an audio response, it should also contain
+//     [output_audio_config][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.output_audio_config].
 //
 // 2.  If [query_input][google.cloud.dialogflow.cx.v3beta1.StreamingDetectIntentRequest.query_input] was set to
-// [query_input.audio.config][google.cloud.dialogflow.cx.v3beta1.AudioInput.config], all subsequent messages
-// must contain [query_input.audio.audio][google.cloud.dialogflow.cx.v3beta1.AudioInput.audio] to continue with
-// Speech recognition.
-// If you decide to rather detect an intent from text
-// input after you already started Speech recognition, please send a message
-// with [query_input.text][google.cloud.dialogflow.cx.v3beta1.QueryInput.text].
+//     [query_input.audio.config][google.cloud.dialogflow.cx.v3beta1.AudioInput.config], all subsequent messages
+//     must contain [query_input.audio.audio][google.cloud.dialogflow.cx.v3beta1.AudioInput.audio] to continue with
+//     Speech recognition.
+//     If you decide to rather detect an intent from text
+//     input after you already started Speech recognition, please send a message
+//     with [query_input.text][google.cloud.dialogflow.cx.v3beta1.QueryInput.text].
 //
-// However, note that:
-// * Dialogflow will bill you for the audio duration so far.
-// * Dialogflow discards all Speech recognition results in favor of the input
-// text.
-// * Dialogflow will use the language code from the first message.
+//     However, note that:
+//
+//     * Dialogflow will bill you for the audio duration so far.
+//     * Dialogflow discards all Speech recognition results in favor of the
+//       input text.
+//     * Dialogflow will use the language code from the first message.
 //
 // After you sent all input, you must half-close or abort the request stream.
 message StreamingDetectIntentRequest {
