Skip to content

Commit 59d5f2b

Browse files
Google APIscopybara-github
Google APIs
authored and
copybara-github
committed
feat: updated v3 dialogflow client libraries with dtmf_pattern and trace_blocks
PiperOrigin-RevId: 888886398
1 parent f2cee57 commit 59d5f2b

File tree

4 files changed

+107
-1
lines changed

4 files changed

+107
-1
lines changed

‎google/cloud/dialogflow/cx/v3/dialogflow_v3.yaml‎

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,24 @@ documentation:
7575
description: Gets information about a location.
7676

7777
- selector: google.cloud.location.Locations.ListLocations
78-
description: Lists information about the supported locations for this service.
78+
description: |-
79+
Lists information about the supported locations for this service.
80+
81+
This method lists locations based on the resource scope provided in
82+
the [ListLocationsRequest.name] field:
83+
84+
* **Global locations**: If `name` is empty, the method lists the
85+
public locations available to all projects. * **Project-specific
86+
locations**: If `name` follows the format
87+
`projects/{project}`, the method lists locations visible to that
88+
specific project. This includes public, private, or other
89+
project-specific locations enabled for the project.
90+
91+
For gRPC and client library implementations, the resource name is
92+
passed as the `name` field. For direct service calls, the resource
93+
name is
94+
incorporated into the request path based on the specific service
95+
implementation and version.
7996
8097
http:
8198
rules:

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -281,6 +281,9 @@ message Intent {
281281
// Human readable description for better understanding an intent like its
282282
// scope, content, result etc. Maximum character limit: 140 characters.
283283
string description = 8;
284+
285+
// Optional. Matching DTMF pattern for the intent.
286+
string dtmf_pattern = 16 [(google.api.field_behavior) = OPTIONAL];
284287
}
285288

286289
// The request message for

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

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,7 @@ import "google/cloud/dialogflow/cx/v3/page.proto";
3030
import "google/cloud/dialogflow/cx/v3/response_message.proto";
3131
import "google/cloud/dialogflow/cx/v3/session_entity_type.proto";
3232
import "google/cloud/dialogflow/cx/v3/tool_call.proto";
33+
import "google/cloud/dialogflow/cx/v3/trace.proto";
3334
import "google/protobuf/duration.proto";
3435
import "google/protobuf/field_mask.proto";
3536
import "google/protobuf/struct.proto";
@@ -1134,6 +1135,13 @@ message QueryResult {
11341135
// Filled only when data stores are involved in serving the query.
11351136
DataStoreConnectionSignals data_store_connection_signals = 35
11361137
[(google.api.field_behavior) = OPTIONAL];
1138+
1139+
// Optional. Contains the sequence of trace blocks from the current
1140+
// conversation turn. Trace blocks are ordered chronologically and contain
1141+
// detailed traces of runtime behavior such as tool calls, LLM calls, flow and
1142+
// playbook invocations, agent utterances and user utterances.
1143+
repeated TraceBlock trace_blocks = 37
1144+
[(google.api.field_behavior) = OPTIONAL];
11371145
}
11381146

11391147
// Represents the natural language text to be processed.

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

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ package google.cloud.dialogflow.cx.v3;
1919
import "google/api/field_behavior.proto";
2020
import "google/api/resource.proto";
2121
import "google/protobuf/struct.proto";
22+
import "google/protobuf/timestamp.proto";
2223

2324
option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3";
2425
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";
2829
option objc_class_prefix = "DF";
2930
option ruby_package = "Google::Cloud::Dialogflow::CX::V3";
3031

32+
// The trace block tracks a sequence of actions taken by the agent in a flow or
33+
// a playbook.
34+
message TraceBlock {
35+
// Metadata of the trace.
36+
oneof trace_metadata {
37+
// Metadata of the playbook trace.
38+
PlaybookTraceMetadata playbook_trace_metadata = 1;
39+
40+
// Metadata of the flow trace.
41+
FlowTraceMetadata flow_trace_metadata = 2;
42+
43+
// Metadata of the speech-to-text and speech-to-text processing.
44+
SpeechProcessingMetadata speech_processing_metadata = 8;
45+
}
46+
47+
// The actions performed by the agent and the user during this session.
48+
repeated Action actions = 3;
49+
50+
// Output only. Timestamp of the start of the trace block.
51+
google.protobuf.Timestamp start_time = 4
52+
[(google.api.field_behavior) = OUTPUT_ONLY];
53+
54+
// Output only. Timestamp of the end of the trace block.
55+
google.protobuf.Timestamp complete_time = 5
56+
[(google.api.field_behavior) = OUTPUT_ONLY];
57+
58+
// Optional. A list of input parameters of the trace block.
59+
google.protobuf.Struct input_parameters = 9
60+
[(google.api.field_behavior) = OPTIONAL];
61+
62+
// Optional. A list of output parameters of the trace block.
63+
google.protobuf.Struct output_parameters = 6
64+
[(google.api.field_behavior) = OPTIONAL];
65+
66+
// Optional. Output only. The end state of the trace block.
67+
OutputState end_state = 7 [
68+
(google.api.field_behavior) = OUTPUT_ONLY,
69+
(google.api.field_behavior) = OPTIONAL
70+
];
71+
}
72+
73+
// Metadata of the speech-to-text and text-to-speech processing.
74+
message SpeechProcessingMetadata {
75+
// Output only. The display name of the speech processing.
76+
string display_name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
77+
}
78+
79+
// Metadata of the playbook trace.
80+
message PlaybookTraceMetadata {
81+
// Required. The unique identifier of the playbook.
82+
// Format:
83+
// `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>`.
84+
string playbook = 1 [
85+
(google.api.field_behavior) = REQUIRED,
86+
(google.api.resource_reference) = {
87+
type: "dialogflow.googleapis.com/Playbook"
88+
}
89+
];
90+
91+
// Output only. The display name of the playbook.
92+
string display_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
93+
}
94+
95+
// Metadata of the flow trace.
96+
message FlowTraceMetadata {
97+
// Required. The unique identifier of the flow.
98+
// Format:
99+
// `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>`.
100+
string flow = 1 [
101+
(google.api.field_behavior) = REQUIRED,
102+
(google.api.resource_reference) = { type: "dialogflow.googleapis.com/Flow" }
103+
];
104+
105+
// Output only. The display name of the flow.
106+
string display_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
107+
}
108+
31109
// Input of the playbook.
32110
message PlaybookInput {
33111
// Optional. Summary string of the preceding conversation for the child

0 commit comments

Comments
 (0)