Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -283,6 +283,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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ import "google/cloud/dialogflow/cx/v3beta1/page.proto";
import "google/cloud/dialogflow/cx/v3beta1/response_message.proto";
import "google/cloud/dialogflow/cx/v3beta1/session_entity_type.proto";
import "google/cloud/dialogflow/cx/v3beta1/tool_call.proto";
import "google/cloud/dialogflow/cx/v3beta1/trace.proto";
import "google/protobuf/duration.proto";
import "google/protobuf/field_mask.proto";
import "google/protobuf/struct.proto";
Expand Down Expand Up @@ -1167,6 +1168,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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,83 @@ option java_package = "com.google.cloud.dialogflow.cx.v3beta1";
option objc_class_prefix = "DF";
option ruby_package = "Google::Cloud::Dialogflow::CX::V3beta1";

// 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];
}

// Action performed by end user or Dialogflow agent in the conversation.
message Action {
// Stores metadata of the intent match action.
Expand Down
Loading
Loading