Skip to content

Commit 7e8511a

Browse files
Google APIscopybara-github
Google APIs
authored and
copybara-github
committed
feat: updated v3beta1 dialogflow client libraries with dtmf_pattern and trace_blocks
PiperOrigin-RevId: 887053734
1 parent 83e03cd commit 7e8511a

4 files changed

Lines changed: 103 additions & 6 deletions

File tree

‎google/cloud/dialogflow/cx/v3beta1/dialogflow_v3beta1.yaml‎

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -79,13 +79,22 @@ documentation:
7979
- selector: google.cloud.location.Locations.ListLocations
8080
description: |-
8181
Lists information about the supported locations for this service.
82-
This method can be called in two ways:
8382
84-
* **List all public locations:** Use the path `GET /v1/locations`.
85-
* **List project-visible locations:** Use the path
86-
`GET /v1/projects/{project_id}/locations`. This may include public
87-
locations as well as private or other locations specifically visible
88-
to the project.
83+
This method lists locations based on the resource scope provided in
84+
the [ListLocationsRequest.name] field:
85+
86+
* **Global locations**: If `name` is empty, the method lists the
87+
public locations available to all projects. * **Project-specific
88+
locations**: If `name` follows the format
89+
`projects/{project}`, the method lists locations visible to that
90+
specific project. This includes public, private, or other
91+
project-specific locations enabled for the project.
92+
93+
For gRPC and client library implementations, the resource name is
94+
passed as the `name` field. For direct service calls, the resource
95+
name is
96+
incorporated into the request path based on the specific service
97+
implementation and version.
8998
9099
http:
91100
rules:

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

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

288291
// The request message for

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

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ import "google/cloud/dialogflow/cx/v3beta1/page.proto";
3131
import "google/cloud/dialogflow/cx/v3beta1/response_message.proto";
3232
import "google/cloud/dialogflow/cx/v3beta1/session_entity_type.proto";
3333
import "google/cloud/dialogflow/cx/v3beta1/tool_call.proto";
34+
import "google/cloud/dialogflow/cx/v3beta1/trace.proto";
3435
import "google/protobuf/duration.proto";
3536
import "google/protobuf/field_mask.proto";
3637
import "google/protobuf/struct.proto";
@@ -1167,6 +1168,13 @@ message QueryResult {
11671168
// Filled only when data stores are involved in serving the query.
11681169
DataStoreConnectionSignals data_store_connection_signals = 35
11691170
[(google.api.field_behavior) = OPTIONAL];
1171+
1172+
// Optional. Contains the sequence of trace blocks from the current
1173+
// conversation turn. Trace blocks are ordered chronologically and contain
1174+
// detailed traces of runtime behavior such as tool calls, LLM calls, flow and
1175+
// playbook invocations, agent utterances and user utterances.
1176+
repeated TraceBlock trace_blocks = 37
1177+
[(google.api.field_behavior) = OPTIONAL];
11701178
}
11711179

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

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

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,83 @@ option java_package = "com.google.cloud.dialogflow.cx.v3beta1";
3030
option objc_class_prefix = "DF";
3131
option ruby_package = "Google::Cloud::Dialogflow::CX::V3beta1";
3232

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

0 commit comments

Comments
 (0)