feat: updated v3 dialogflow client libraries with dtmf_pattern and trace_blocks

Google APIs · copybara-github · commit 59d5f2b46924 · 2026-03-24T15:32:07.000-07:00
PiperOrigin-RevId: 888886398
diff --git a/google/cloud/dialogflow/cx/v3/dialogflow_v3.yaml b/google/cloud/dialogflow/cx/v3/dialogflow_v3.yaml
@@ -75,7 +75,24 @@ documentation:
     description: Gets information about a location.
 
   - selector: google.cloud.location.Locations.ListLocations
-    description: Lists information about the supported locations for this service.
+    description: |-
+      Lists information about the supported locations for this service.
+
+      This method lists locations based on the resource scope provided in
+      the [ListLocationsRequest.name] field:
+
+      * **Global locations**: If `name` is empty, the method lists the
+      public locations available to all projects. * **Project-specific
+      locations**: If `name` follows the format
+      `projects/{project}`, the method lists locations visible to that
+      specific project. This includes public, private, or other
+      project-specific locations enabled for the project.
+
+      For gRPC and client library implementations, the resource name is
+      passed as the `name` field. For direct service calls, the resource
+      name is
+      incorporated into the request path based on the specific service
+      implementation and version.
 
 http:
   rules:
diff --git a/google/cloud/dialogflow/cx/v3/intent.proto b/google/cloud/dialogflow/cx/v3/intent.proto
@@ -281,6 +281,9 @@ message Intent {
   // Human readable description for better understanding an intent like its
   // scope, content, result etc. Maximum character limit: 140 characters.
   string description = 8;
+
+  // Optional. Matching DTMF pattern for the intent.
+  string dtmf_pattern = 16 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The request message for
diff --git a/google/cloud/dialogflow/cx/v3/session.proto b/google/cloud/dialogflow/cx/v3/session.proto
@@ -30,6 +30,7 @@ import "google/cloud/dialogflow/cx/v3/page.proto";
 import "google/cloud/dialogflow/cx/v3/response_message.proto";
 import "google/cloud/dialogflow/cx/v3/session_entity_type.proto";
 import "google/cloud/dialogflow/cx/v3/tool_call.proto";
+import "google/cloud/dialogflow/cx/v3/trace.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/struct.proto";
@@ -1134,6 +1135,13 @@ message QueryResult {
   // Filled only when data stores are involved in serving the query.
   DataStoreConnectionSignals data_store_connection_signals = 35
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Contains the sequence of trace blocks from the current
+  // conversation turn. Trace blocks are ordered chronologically and contain
+  // detailed traces of runtime behavior such as tool calls, LLM calls, flow and
+  // playbook invocations, agent utterances and user utterances.
+  repeated TraceBlock trace_blocks = 37
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Represents the natural language text to be processed.
diff --git a/google/cloud/dialogflow/cx/v3/trace.proto b/google/cloud/dialogflow/cx/v3/trace.proto
@@ -19,6 +19,7 @@ package google.cloud.dialogflow.cx.v3;
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3";
 option go_package = "cloud.google.com/go/dialogflow/cx/apiv3/cxpb;cxpb";
@@ -28,6 +29,83 @@ option java_package = "com.google.cloud.dialogflow.cx.v3";
 option objc_class_prefix = "DF";
 option ruby_package = "Google::Cloud::Dialogflow::CX::V3";
 
+// The trace block tracks a sequence of actions taken by the agent in a flow or
+// a playbook.
+message TraceBlock {
+  // Metadata of the trace.
+  oneof trace_metadata {
+    // Metadata of the playbook trace.
+    PlaybookTraceMetadata playbook_trace_metadata = 1;
+
+    // Metadata of the flow trace.
+    FlowTraceMetadata flow_trace_metadata = 2;
+
+    // Metadata of the speech-to-text and speech-to-text processing.
+    SpeechProcessingMetadata speech_processing_metadata = 8;
+  }
+
+  // The actions performed by the agent and the user during this session.
+  repeated Action actions = 3;
+
+  // Output only. Timestamp of the start of the trace block.
+  google.protobuf.Timestamp start_time = 4
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Timestamp of the end of the trace block.
+  google.protobuf.Timestamp complete_time = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. A list of input parameters of the trace block.
+  google.protobuf.Struct input_parameters = 9
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A list of output parameters of the trace block.
+  google.protobuf.Struct output_parameters = 6
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Output only. The end state of the trace block.
+  OutputState end_state = 7 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Metadata of the speech-to-text and text-to-speech processing.
+message SpeechProcessingMetadata {
+  // Output only. The display name of the speech processing.
+  string display_name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Metadata of the playbook trace.
+message PlaybookTraceMetadata {
+  // 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 = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Metadata of the flow trace.
+message FlowTraceMetadata {
+  // 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 = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
 // Input of the playbook.
 message PlaybookInput {
   // Optional. Summary string of the preceding conversation for the child

Original file line number	Diff line number	Diff line change
`@@ -281,6 +281,9 @@ message Intent {`
`281`	`281`	`// Human readable description for better understanding an intent like its`
`282`	`282`	`// scope, content, result etc. Maximum character limit: 140 characters.`
`283`	`283`	`string description = 8;`
	`284`	`+`
	`285`	`+ // Optional. Matching DTMF pattern for the intent.`
	`286`	`+ string dtmf_pattern = 16 [(google.api.field_behavior) = OPTIONAL];`
`284`	`287`	`}`
`285`	`288`
`286`	`289`	`// The request message for`