googleapis
diff --git a/‎google/cloud/dialogflow/cx/v3beta1/BUILD.bazel‎
Lines changed: 5 additions & 2 deletions b/‎google/cloud/dialogflow/cx/v3beta1/BUILD.bazel‎
Lines changed: 5 additions & 2 deletions
diff --git a/‎google/cloud/dialogflow/cx/v3beta1/audio_config.proto‎
Lines changed: 3 additions & 0 deletions b/‎google/cloud/dialogflow/cx/v3beta1/audio_config.proto‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎google/cloud/dialogflow/cx/v3beta1/data_store_connection.proto‎
Lines changed: 4 additions & 0 deletions b/‎google/cloud/dialogflow/cx/v3beta1/data_store_connection.proto‎
Lines changed: 4 additions & 0 deletions
diff --git a/‎google/cloud/dialogflow/cx/v3beta1/dialogflow_grpc_service_config.json‎
Lines changed: 3 additions & 0 deletions b/‎google/cloud/dialogflow/cx/v3beta1/dialogflow_grpc_service_config.json‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎google/cloud/dialogflow/cx/v3beta1/environment.proto‎
Lines changed: 3 additions & 1 deletion b/‎google/cloud/dialogflow/cx/v3beta1/environment.proto‎
Lines changed: 3 additions & 1 deletion
diff --git a/‎google/cloud/dialogflow/cx/v3beta1/example.proto‎
Lines changed: 1 addition & 155 deletions b/‎google/cloud/dialogflow/cx/v3beta1/example.proto‎
Lines changed: 1 addition & 155 deletions
diff --git a/‎google/cloud/dialogflow/cx/v3beta1/flow.proto‎
Lines changed: 9 additions & 0 deletions b/‎google/cloud/dialogflow/cx/v3beta1/flow.proto‎
Lines changed: 9 additions & 0 deletions
diff --git a/‎google/cloud/dialogflow/cx/v3beta1/fulfillment.proto‎
Lines changed: 32 additions & 0 deletions b/‎google/cloud/dialogflow/cx/v3beta1/fulfillment.proto‎
Lines changed: 32 additions & 0 deletions
@@ -55,6 +55,7 @@ proto_library(
         "test_case.proto",
         "tool.proto",
         "tool_call.proto",
+        "trace.proto",
         "transition_route_group.proto",
         "validation_message.proto",
         "version.proto",
@@ -198,11 +199,12 @@ load(
     "@com_google_googleapis_imports//:imports.bzl",
     "go_gapic_assembly_pkg",
     "go_gapic_library",
-    "go_grpc_library",
+    "go_proto_library",
 )
 
-go_grpc_library(
+go_proto_library(
     name = "cx_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "cloud.google.com/go/dialogflow/cx/apiv3beta1/cxpb",
     protos = [":cx_proto"],
     deps = [
@@ -430,6 +432,7 @@ load(
 
 csharp_proto_library(
     name = "cx_csharp_proto",
+    extra_opts = [],
     deps = [":cx_proto"],
 )
 
 
@@ -42,6 +42,7 @@ enum AudioEncoding {
   AUDIO_ENCODING_UNSPECIFIED = 0;
 
   // Uncompressed 16-bit signed little-endian samples (Linear PCM).
+  // LINT: LEGACY_NAMES
   AUDIO_ENCODING_LINEAR_16 = 1;
 
   // [`FLAC`](https://xiph.org/flac/documentation.html) (Free Lossless Audio
@@ -310,12 +311,14 @@ enum OutputAudioEncoding {
 
   // Uncompressed 16-bit signed little-endian samples (Linear PCM).
   // Audio content returned as LINEAR16 also contains a WAV header.
+  // LINT: LEGACY_NAMES
   OUTPUT_AUDIO_ENCODING_LINEAR_16 = 1;
 
   // MP3 audio at 32kbps.
   OUTPUT_AUDIO_ENCODING_MP3 = 2;
 
   // MP3 audio at 64kbps.
+  // LINT: LEGACY_NAMES
   OUTPUT_AUDIO_ENCODING_MP3_64_KBPS = 4;
 
   // Opus encoded audio wrapped in an ogg container. The result will be a
 
@@ -17,6 +17,7 @@ syntax = "proto3";
 package google.cloud.dialogflow.cx.v3beta1;
 
 import "google/api/field_behavior.proto";
+import "google/protobuf/struct.proto";
 
 option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3Beta1";
 option go_package = "cloud.google.com/go/dialogflow/cx/apiv3beta1/cxpb;cxpb";
@@ -72,6 +73,9 @@ message DataStoreConnectionSignals {
 
     // Text included in the prompt.
     string text = 3;
+
+    // Metadata associated with the document.
+    google.protobuf.Struct metadata = 5;
   }
 
   // Diagnostic info related to the answer generation model call.
 
@@ -38,6 +38,9 @@
         {
           "service": "google.cloud.dialogflow.cx.v3beta1.Intents"
         },
+        {
+          "service": "google.cloud.dialogflow.cx.v3beta1.Integrations"
+        },
         {
           "service": "google.cloud.dialogflow.cx.v3beta1.Pages"
         },
 
@@ -200,11 +200,13 @@ message Environment {
 
   // Configuration for the version.
   message VersionConfig {
-    // Required. Both flow and playbook versions are supported.
+    // Required. Flow, playbook and tool versions are supported.
     // Format for flow version:
     // projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/versions/<VersionID>.
     // Format for playbook version:
     // projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>/versions/<VersionID>.
+    // Format for tool version:
+    // projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/tools/<ToolID>/versions/<VersionID>.
     string version = 1 [
       (google.api.field_behavior) = REQUIRED,
       (google.api.resource_reference) = {
 
@@ -20,9 +20,9 @@ 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/v3beta1/trace.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
-import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3Beta1";
@@ -235,157 +235,3 @@ message Example {
   // Note: example's language code is not currently used in dialogflow agents.
   string language_code = 13 [(google.api.field_behavior) = OPTIONAL];
 }
-
-// Input of the playbook.
-message PlaybookInput {
-  // Optional. Summary string of the preceding conversation for the child
-  // playbook invocation.
-  string preceding_conversation_summary = 1
-      [(google.api.field_behavior) = OPTIONAL];
-
-  // Optional. A list of input parameters for the action.
-  google.protobuf.Struct action_parameters = 3
-      [(google.api.field_behavior) = OPTIONAL];
-}
-
-// Output of the playbook.
-message PlaybookOutput {
-  // Optional. Summary string of the execution result of the child playbook.
-  string execution_summary = 1 [(google.api.field_behavior) = OPTIONAL];
-
-  // Optional. A Struct object of output parameters for the action.
-  google.protobuf.Struct action_parameters = 4
-      [(google.api.field_behavior) = OPTIONAL];
-}
-
-// Action performed by end user or Dialogflow agent in the conversation.
-message Action {
-  // Action details.
-  oneof action {
-    // Optional. Agent obtained a message from the customer.
-    UserUtterance user_utterance = 1 [(google.api.field_behavior) = OPTIONAL];
-
-    // Optional. Action performed by the agent as a message.
-    AgentUtterance agent_utterance = 2 [(google.api.field_behavior) = OPTIONAL];
-
-    // Optional. Action performed on behalf of the agent by calling a plugin
-    // tool.
-    ToolUse tool_use = 3 [(google.api.field_behavior) = OPTIONAL];
-
-    // Optional. Action performed on behalf of the agent by invoking a child
-    // playbook.
-    PlaybookInvocation playbook_invocation = 4
-        [(google.api.field_behavior) = OPTIONAL];
-
-    // Optional. Action performed on behalf of the agent by invoking a CX flow.
-    FlowInvocation flow_invocation = 5 [(google.api.field_behavior) = OPTIONAL];
-  }
-}
-
-// UserUtterance represents one message sent by the customer.
-message UserUtterance {
-  // Required. Message content in text.
-  string text = 1 [(google.api.field_behavior) = REQUIRED];
-}
-
-// AgentUtterance represents one message sent by the agent.
-message AgentUtterance {
-  // Required. Message content in text.
-  string text = 1 [(google.api.field_behavior) = REQUIRED];
-}
-
-// Stores metadata of the invocation of an action supported by a tool.
-message ToolUse {
-  // Required. The [tool][google.cloud.dialogflow.cx.v3beta1.Tool] that should
-  // be used. Format:
-  // `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/tools/<ToolID>`.
-  string tool = 1 [
-    (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "dialogflow.googleapis.com/Tool" }
-  ];
-
-  // Output only. The display name of the tool.
-  string display_name = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
-
-  // Optional. Name of the action to be called during the tool use.
-  string action = 2 [(google.api.field_behavior) = OPTIONAL];
-
-  // Optional. A list of input parameters for the action.
-  google.protobuf.Struct input_action_parameters = 5
-      [(google.api.field_behavior) = OPTIONAL];
-
-  // Optional. A list of output parameters generated by the action.
-  google.protobuf.Struct output_action_parameters = 6
-      [(google.api.field_behavior) = OPTIONAL];
-}
-
-// Stores metadata of the invocation of a child playbook.
-message PlaybookInvocation {
-  // Required. The unique identifier of the playbook.
-  // Format:
-  // `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>`.
-  string playbook = 1 [
-    (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = {
-      type: "dialogflow.googleapis.com/Playbook"
-    }
-  ];
-
-  // Output only. The display name of the playbook.
-  string display_name = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
-
-  // Optional. Input of the child playbook invocation.
-  PlaybookInput playbook_input = 2 [(google.api.field_behavior) = OPTIONAL];
-
-  // Optional. Output of the child playbook invocation.
-  PlaybookOutput playbook_output = 3 [(google.api.field_behavior) = OPTIONAL];
-
-  // Required. Playbook invocation's output state.
-  OutputState playbook_state = 4 [(google.api.field_behavior) = REQUIRED];
-}
-
-// Stores metadata of the invocation of a CX flow.
-message FlowInvocation {
-  // Required. The unique identifier of the flow.
-  // Format:
-  // `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>`.
-  string flow = 1 [
-    (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "dialogflow.googleapis.com/Flow" }
-  ];
-
-  // Output only. The display name of the flow.
-  string display_name = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
-
-  // Optional. A list of input parameters for the flow.
-  google.protobuf.Struct input_action_parameters = 5
-      [(google.api.field_behavior) = OPTIONAL];
-
-  // Optional. A list of output parameters generated by the flow invocation.
-  google.protobuf.Struct output_action_parameters = 6
-      [(google.api.field_behavior) = OPTIONAL];
-
-  // Required. Flow invocation's output state.
-  OutputState flow_state = 4 [(google.api.field_behavior) = REQUIRED];
-}
-
-// Output state.
-enum OutputState {
-  // Unspecified output.
-  OUTPUT_STATE_UNSPECIFIED = 0;
-
-  // Succeeded.
-  OUTPUT_STATE_OK = 1;
-
-  // Cancelled.
-  OUTPUT_STATE_CANCELLED = 2;
-
-  // Failed.
-  OUTPUT_STATE_FAILED = 3;
-
-  // Escalated.
-  OUTPUT_STATE_ESCALATED = 4;
-
-  // Pending.
-  OUTPUT_STATE_PENDING = 5;
-}
@@ -23,6 +23,7 @@ import "google/api/resource.proto";
 import "google/cloud/dialogflow/cx/v3beta1/advanced_settings.proto";
 import "google/cloud/dialogflow/cx/v3beta1/import_strategy.proto";
 import "google/cloud/dialogflow/cx/v3beta1/page.proto";
+import "google/cloud/dialogflow/cx/v3beta1/parameter_definition.proto";
 import "google/cloud/dialogflow/cx/v3beta1/validation_message.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
@@ -349,6 +350,14 @@ message Flow {
   KnowledgeConnectorSettings knowledge_connector_settings = 18
       [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. Defined structured input parameters for this flow.
+  repeated ParameterDefinition input_parameter_definitions = 26
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Defined structured output parameters for this flow.
+  repeated ParameterDefinition output_parameter_definitions = 27
+      [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. Multi-lingual agent settings for this flow.
   MultiLanguageSettings multi_language_settings = 28
       [(google.api.field_behavior) = OPTIONAL];
 
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.dialogflow.cx.v3beta1;
 
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/dialogflow/cx/v3beta1/advanced_settings.proto";
 import "google/cloud/dialogflow/cx/v3beta1/response_message.proto";
@@ -91,6 +92,34 @@ message Fulfillment {
     repeated Case cases = 1;
   }
 
+  // Generator settings used by the LLM to generate a text response.
+  message GeneratorSettings {
+    // Required. The generator to call.
+    // Format:
+    // `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/generators/<GeneratorID>`.
+    string generator = 1 [
+      (google.api.field_behavior) = REQUIRED,
+      (google.api.resource_reference) = {
+        type: "dialogflow.googleapis.com/Generator"
+      }
+    ];
+
+    // Map from [placeholder parameter][Generator.Parameter.id] in the
+    // [Generator][google.cloud.dialogflow.cx.v3beta1.Generator] to
+    // corresponding session parameters. By default, Dialogflow uses the session
+    // parameter with the same name to fill in the generator template. e.g. If
+    // there is a placeholder parameter `city` in the Generator, Dialogflow
+    // default to fill in the `$city` with
+    // `$session.params.city`. However, you may choose to fill `$city` with
+    // `$session.params.desination-city`.
+    // - Map key: [parameter ID][Genrator.Parameter.id]
+    // - Map value: session parameter name
+    map<string, string> input_parameters = 2;
+
+    // Required. Output parameter which should contain the generator response.
+    string output_parameter = 3 [(google.api.field_behavior) = REQUIRED];
+  }
+
   // The list of rich message responses to present to the user.
   repeated ResponseMessage messages = 1;
 
@@ -137,4 +166,7 @@ message Fulfillment {
   // fulfillment will be respected. This flag is only useful for fulfillments
   // associated with no-match event handlers.
   bool enable_generative_fallback = 12;
+
+  // A list of Generators to be called during this fulfillment.
+  repeated GeneratorSettings generators = 13;
 }
Original file line number	Diff line number	Diff line change
@@ -38,6 +38,9 @@
38	38	{
39	39	"service": "google.cloud.dialogflow.cx.v3beta1.Intents"
40	40	},
	41	+ {
	42	+ "service": "google.cloud.dialogflow.cx.v3beta1.Integrations"
	43	+ },
41	44	{
42	45	"service": "google.cloud.dialogflow.cx.v3beta1.Pages"
43	46	},