Skip to content

Commit 0e87dc7

Browse files
Google APIscopybara-github
Google APIs
authored and
copybara-github
committed
feat: added page in TestConfig
docs: clarified wording around Cloud Storage usage PiperOrigin-RevId: 433282831
1 parent 2522351 commit 0e87dc7

3 files changed

Lines changed: 54 additions & 1 deletion

File tree

‎google/cloud/dialogflow/cx/v3/agent.proto‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -348,6 +348,12 @@ message ExportAgentRequest {
348348
// export the agent to. The format of this URI must be
349349
// `gs://<bucket-name>/<object-name>`.
350350
// If left unspecified, the serialized agent is returned inline.
351+
//
352+
// Dialogflow performs a write operation for the Cloud Storage object
353+
// on the caller's behalf, so your request authentication must
354+
// have write permissions for the object. For more information, see
355+
// [Dialogflow access
356+
// control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
351357
string agent_uri = 2 [(google.api.field_behavior) = OPTIONAL];
352358

353359
// Optional. Environment name. If not set, draft environment is assumed.
@@ -405,6 +411,12 @@ message RestoreAgentRequest {
405411
// The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI
406412
// to restore agent from. The format of this URI must be
407413
// `gs://<bucket-name>/<object-name>`.
414+
//
415+
// Dialogflow performs a read operation for the Cloud Storage object
416+
// on the caller's behalf, so your request authentication must
417+
// have read permissions for the object. For more information, see
418+
// [Dialogflow access
419+
// control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
408420
string agent_uri = 2;
409421

410422
// Uncompressed raw byte content for agent.

‎google/cloud/dialogflow/cx/v3/flow.proto‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -559,6 +559,12 @@ message ImportFlowRequest {
559559
// The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI
560560
// to import flow from. The format of this URI must be
561561
// `gs://<bucket-name>/<object-name>`.
562+
//
563+
// Dialogflow performs a read operation for the Cloud Storage object
564+
// on the caller's behalf, so your request authentication must
565+
// have read permissions for the object. For more information, see
566+
// [Dialogflow access
567+
// control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
562568
string flow_uri = 2;
563569

564570
// Uncompressed raw byte content for flow.
@@ -595,6 +601,12 @@ message ExportFlowRequest {
595601
// export the flow to. The format of this URI must be
596602
// `gs://<bucket-name>/<object-name>`.
597603
// If left unspecified, the serialized flow is returned inline.
604+
//
605+
// Dialogflow performs a write operation for the Cloud Storage object
606+
// on the caller's behalf, so your request authentication must
607+
// have write permissions for the object. For more information, see
608+
// [Dialogflow access
609+
// control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
598610
string flow_uri = 2 [(google.api.field_behavior) = OPTIONAL];
599611

600612
// Optional. Whether to export flows referenced by the specified flow.

‎google/cloud/dialogflow/cx/v3/test_case.proto‎

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -270,12 +270,29 @@ message TestConfig {
270270
// Session parameters to be compared when calculating differences.
271271
repeated string tracking_parameters = 1;
272272

273-
// Flow name. If not set, default start flow is assumed.
273+
// Flow name to start the test case with.
274274
// Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
275275
// ID>/flows/<Flow ID>`.
276+
//
277+
// Only one of `flow` and `page` should be set to indicate the starting point
278+
// of the test case. If both are set, `page` takes precedence over `flow`. If
279+
// neither is set, the test case will start with start page on the default
280+
// start flow.
276281
string flow = 2 [(google.api.resource_reference) = {
277282
type: "dialogflow.googleapis.com/Flow"
278283
}];
284+
285+
// The [page][google.cloud.dialogflow.cx.v3.Page] to start the test case with.
286+
// Format: `projects/<Project ID>/locations/<Location ID>/agents/<Agent
287+
// ID>/flows/<Flow ID>/pages/<Page ID>`.
288+
//
289+
// Only one of `flow` and `page` should be set to indicate the starting point
290+
// of the test case. If both are set, `page` takes precedence over `flow`. If
291+
// neither is set, the test case will start with start page on the default
292+
// start flow.
293+
string page = 3 [(google.api.resource_reference) = {
294+
type: "dialogflow.googleapis.com/Page"
295+
}];
279296
}
280297

281298
// One interaction between a human and virtual agent. The human provides some
@@ -744,6 +761,12 @@ message ImportTestCasesRequest {
744761
// The [Google Cloud Storage](https://cloud.google.com/storage/docs/) URI
745762
// to import test cases from. The format of this URI must be
746763
// `gs://<bucket-name>/<object-name>`.
764+
//
765+
// Dialogflow performs a read operation for the Cloud Storage object
766+
// on the caller's behalf, so your request authentication must
767+
// have read permissions for the object. For more information, see
768+
// [Dialogflow access
769+
// control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
747770
string gcs_uri = 2;
748771

749772
// Uncompressed raw byte content for test cases.
@@ -806,6 +829,12 @@ message ExportTestCasesRequest {
806829
// export the test cases to. The format of this URI must be
807830
// `gs://<bucket-name>/<object-name>`. If unspecified, the serialized test
808831
// cases is returned inline.
832+
//
833+
// Dialogflow performs a write operation for the Cloud Storage object
834+
// on the caller's behalf, so your request authentication must
835+
// have write permissions for the object. For more information, see
836+
// [Dialogflow access
837+
// control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
809838
string gcs_uri = 2;
810839
}
811840

0 commit comments

Comments
 (0)