feat: added GitIntegrationSettings to the Agent

Google APIs · copybara-github · commit 5cfc6d1605a5 · 2023-07-10T12:20:27.000-07:00
PiperOrigin-RevId: 546946304
diff --git a/google/cloud/dialogflow/cx/v3/agent.proto b/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.
diff --git a/google/cloud/dialogflow/cx/v3/test_case.proto b/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) = {
diff --git a/google/cloud/dialogflow/cx/v3/webhook.proto b/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];
   }

Original file line number	Diff line number	Diff line change
`@@ -192,7 +192,8 @@ service TestCases {`
`192`	`192`	`};`
`193`	`193`	`}`
`194`	`194`
`195`		`- // Fetches a list of results for a given test case.`
	`195`	`+ // Fetches the list of run results for the given test case. A maximum of 100`
	`196`	`+ // results are kept for each test case.`
`196`	`197`	`rpc ListTestCaseResults(ListTestCaseResultsRequest)`
`197`	`198`	`returns (ListTestCaseResultsResponse) {`
`198`	`199`	`option (google.api.http) = {`