feat: [dialogflow-cx] added GitIntegrationSettings to the Agent (#4404)

* feat: added GitIntegrationSettings to the Agent

PiperOrigin-RevId: 546355900

Source-Link: googleapis/googleapis@dc3d3a2

Source-Link: googleapis/googleapis-gen@2480a9f
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpYWxvZ2Zsb3ctY3gvLk93bEJvdC55YW1sIiwiaCI6IjI0ODBhOWY4YmZiYzc5ODdmNTgzZDcwZTE5OTU4NGE0NmI1MjEzM2YifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* feat: added GitIntegrationSettings to the Agent

PiperOrigin-RevId: 546946304

Source-Link: googleapis/googleapis@5cfc6d1

Source-Link: googleapis/googleapis-gen@734b6e5
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpYWxvZ2Zsb3ctY3gvLk93bEJvdC55YW1sIiwiaCI6IjczNGI2ZTUzZmRmOTc2YjMzZDFjYWIyYzdiNWJjZTA5OTllOTdmY2QifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* 🦉 Updates from OwlBot post-processor

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>
Co-authored-by: sofisl <[email protected]>

Author: gcf-owl-bot[bot]

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3/agent.proto

@@ -188,6 +188,34 @@ message Agent {
     pattern: "projects/{project}/locations/{location}/agents/{agent}"
   };
 
+  // Settings for connecting to Git repository for an agent.
+  message GitIntegrationSettings {
+    // Settings of integration with GitHub.
+    message GithubSettings {
+      // The unique repository display name for the GitHub repository.
+      string display_name = 1;
+
+      // The GitHub repository URI related to the agent.
+      string repository_uri = 2;
+
+      // The branch of GitHub repository tracked for this agent.
+      string tracking_branch = 3;
+
+      // The access token used to authenticate the access to the GitHub
+      // repository.
+      string access_token = 4;
+
+      // A list of branches configured to be used from Dialogflow.
+      repeated string branches = 5;
+    }
+
+    // The git settings to specific systems.
+    oneof git_settings {
+      // GitHub settings.
+      GithubSettings github_settings = 1;
+    }
+  }
+
   // The unique identifier of the agent.
   // Required for the
   // [Agents.UpdateAgent][google.cloud.dialogflow.cx.v3.Agents.UpdateAgent]
@@ -269,6 +297,9 @@ message Agent {
   // lower level overrides the settings exposed at the higher level.
   AdvancedSettings advanced_settings = 22;
 
+  // Git integration settings for this agent.
+  GitIntegrationSettings git_integration_settings = 30;
+
   // Settings on instructing the speech synthesizer on how to generate the
   // output audio content.
   TextToSpeechSettings text_to_speech_settings = 31;
@@ -374,6 +405,15 @@ message ExportAgentRequest {
     JSON_PACKAGE = 4;
   }
 
+  // Settings for exporting to a git branch.
+  message GitDestination {
+    // Tracking branch for the git push.
+    string tracking_branch = 1;
+
+    // Commit message for the git push.
+    string commit_message = 2;
+  }
+
   // Required. The name of the agent to export.
   // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>`.
   string name = 1 [
@@ -409,6 +449,9 @@ message ExportAgentRequest {
     }
   ];
 
+  // Optional. The Git branch to export the agent to.
+  GitDestination git_destination = 6 [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. Whether to include BigQuery Export setting.
   bool include_bigquery_export_settings = 7
       [(google.api.field_behavior) = OPTIONAL];
@@ -424,14 +467,27 @@ message ExportAgentResponse {
     // [ExportAgentRequest][google.cloud.dialogflow.cx.v3.ExportAgentRequest].
     string agent_uri = 1;
 
-    // Uncompressed raw byte content for agent.
+    // Uncompressed raw byte content for agent. This field is populated
+    // if none of `agent_uri` and `git_destination` are specified in
+    // [ExportAgentRequest][google.cloud.dialogflow.cx.v3.ExportAgentRequest].
     bytes agent_content = 2;
+
+    // Commit SHA of the git push. This field is populated if
+    // `git_destination` are specified in
+    // [ExportAgentRequest][google.cloud.dialogflow.cx.v3.ExportAgentRequest].
+    string commit_sha = 3;
   }
 }
 
 // The request message for
 // [Agents.RestoreAgent][google.cloud.dialogflow.cx.v3.Agents.RestoreAgent].
 message RestoreAgentRequest {
+  // Settings for restoring from a git branch
+  message GitSource {
+    // tracking branch for the git pull
+    string tracking_branch = 1;
+  }
+
   // Restore option.
   enum RestoreOption {
     // Unspecified. Treated as KEEP.
@@ -471,6 +527,9 @@ message RestoreAgentRequest {
 
     // Uncompressed raw byte content for agent.
     bytes agent_content = 3;
+
+    // Setting for restoring from a git branch
+    GitSource git_source = 6;
   }
 
   // Agent restore mode. If not specified, `KEEP` is assumed.

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3/test_case.proto

@@ -192,7 +192,8 @@ service TestCases {
     };
   }
 
-  // Fetches a list of results for a given test case.
+  // Fetches the list of run results for the given test case. A maximum of 100
+  // results are kept for each test case.
   rpc ListTestCaseResults(ListTestCaseResultsRequest)
       returns (ListTestCaseResultsResponse) {
     option (google.api.http) = {

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3/webhook.proto

@@ -182,8 +182,8 @@ message Webhook {
 
     // Optional. Maps the values extracted from specific fields of the flexible
     // webhook response into session parameters.
-    //  - Key: session parameter name
-    //  - Value: field path in the webhook response
+    // - Key: session parameter name
+    // - Value: field path in the webhook response
     map<string, string> parameter_mapping = 9
         [(google.api.field_behavior) = OPTIONAL];
   }

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/agent.proto

@@ -188,6 +188,34 @@ message Agent {
     pattern: "projects/{project}/locations/{location}/agents/{agent}"
   };
 
+  // Settings for connecting to Git repository for an agent.
+  message GitIntegrationSettings {
+    // Settings of integration with GitHub.
+    message GithubSettings {
+      // The unique repository display name for the GitHub repository.
+      string display_name = 1;
+
+      // The GitHub repository URI related to the agent.
+      string repository_uri = 2;
+
+      // The branch of the GitHub repository tracked for this agent.
+      string tracking_branch = 3;
+
+      // The access token used to authenticate the access to the GitHub
+      // repository.
+      string access_token = 4;
+
+      // A list of branches configured to be used from Dialogflow.
+      repeated string branches = 5;
+    }
+
+    // The git settings to specific systems.
+    oneof git_settings {
+      // GitHub settings.
+      GithubSettings github_settings = 1;
+    }
+  }
+
   // The unique identifier of the agent.
   // Required for the
   // [Agents.UpdateAgent][google.cloud.dialogflow.cx.v3beta1.Agents.UpdateAgent]
@@ -269,6 +297,9 @@ message Agent {
   // lower level overrides the settings exposed at the higher level.
   AdvancedSettings advanced_settings = 22;
 
+  // Git integration settings for this agent.
+  GitIntegrationSettings git_integration_settings = 30;
+
   // Settings on instructing the speech synthesizer on how to generate the
   // output audio content.
   TextToSpeechSettings text_to_speech_settings = 31;
@@ -374,6 +405,15 @@ message ExportAgentRequest {
     JSON_PACKAGE = 4;
   }
 
+  // Settings for exporting to a git branch.
+  message GitDestination {
+    // Tracking branch for the git push.
+    string tracking_branch = 1;
+
+    // Commit message for the git push.
+    string commit_message = 2;
+  }
+
   // Required. The name of the agent to export.
   // Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>`.
   string name = 1 [
@@ -409,6 +449,9 @@ message ExportAgentRequest {
     }
   ];
 
+  // Optional. The Git branch to export the agent to.
+  GitDestination git_destination = 6 [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. Whether to include BigQuery Export setting.
   bool include_bigquery_export_settings = 7
       [(google.api.field_behavior) = OPTIONAL];
@@ -424,14 +467,27 @@ message ExportAgentResponse {
     // [ExportAgentRequest][google.cloud.dialogflow.cx.v3beta1.ExportAgentRequest].
     string agent_uri = 1;
 
-    // Uncompressed raw byte content for agent.
+    // Uncompressed raw byte content for agent. This field is populated
+    // if none of `agent_uri` and `git_destination` are specified in
+    // [ExportAgentRequest][google.cloud.dialogflow.cx.v3beta1.ExportAgentRequest].
     bytes agent_content = 2;
+
+    // Commit SHA of the git push. This field is populated if
+    // `git_destination` is specified in
+    // [ExportAgentRequest][google.cloud.dialogflow.cx.v3beta1.ExportAgentRequest].
+    string commit_sha = 3;
   }
 }
 
 // The request message for
 // [Agents.RestoreAgent][google.cloud.dialogflow.cx.v3beta1.Agents.RestoreAgent].
 message RestoreAgentRequest {
+  // Settings for restoring from a git branch
+  message GitSource {
+    // tracking branch for the git pull
+    string tracking_branch = 1;
+  }
+
   // Restore option.
   enum RestoreOption {
     // Unspecified. Treated as KEEP.
@@ -471,6 +527,9 @@ message RestoreAgentRequest {
 
     // Uncompressed raw byte content for agent.
     bytes agent_content = 3;
+
+    // Setting for restoring from a git branch
+    GitSource git_source = 6;
   }
 
   // Agent restore mode. If not specified, `KEEP` is assumed.

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/test_case.proto

@@ -193,7 +193,8 @@ service TestCases {
     };
   }
 
-  // Fetches a list of results for a given test case.
+  // Fetches the list of run results for the given test case. A maximum of 100
+  // results are kept for each test case.
   rpc ListTestCaseResults(ListTestCaseResultsRequest)
       returns (ListTestCaseResultsResponse) {
     option (google.api.http) = {