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
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

syntax = "proto3";

package google.cloud.dialogflow.v2;

import "google/api/field_behavior.proto";
import "google/api/resource.proto";
import "google/cloud/dialogflow/v2/tool.proto";

option csharp_namespace = "Google.Cloud.Dialogflow.V2";
option go_package = "cloud.google.com/go/dialogflow/apiv2/dialogflowpb;dialogflowpb";
option java_multiple_files = true;
option java_outer_classname = "CesAppProto";
option java_package = "com.google.cloud.dialogflow.v2";
option objc_class_prefix = "DF";
option (google.api.resource_definition) = {
type: "ces.googleapis.com/App"
pattern: "projects/{project}/locations/{location}/apps/{app}"
};

// Spec of CES app that the generator can choose from.
message CesAppSpec {
// Optional. Format: `projects/<Project ID>/locations/<Location ID>/apps/<app
// ID>`.
string ces_app = 1 [
(google.api.field_behavior) = OPTIONAL,
(google.api.resource_reference) = { type: "ces.googleapis.com/App" }
];

// Optional. Indicates whether the app requires human confirmation.
Tool.ConfirmationRequirement confirmation_requirement = 2
[(google.api.field_behavior) = OPTIONAL];
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

syntax = "proto3";

package google.cloud.dialogflow.v2;

import "google/api/field_behavior.proto";
import "google/api/resource.proto";
import "google/cloud/dialogflow/v2/tool.proto";

option csharp_namespace = "Google.Cloud.Dialogflow.V2";
option go_package = "cloud.google.com/go/dialogflow/apiv2/dialogflowpb;dialogflowpb";
option java_multiple_files = true;
option java_outer_classname = "CesToolProto";
option java_package = "com.google.cloud.dialogflow.v2";
option objc_class_prefix = "DF";

// Spec of CES tool that the generator can choose from.
message CesToolSpec {
// Optional. Format: `projects/<Project ID>/locations/<Location ID>/apps/<app
// ID>/tools/<tool ID>`.
string ces_tool = 1 [
(google.api.field_behavior) = OPTIONAL,
(google.api.resource_reference) = { type: "ces.googleapis.com/Tool" }
];

// Optional. Indicates whether the tool requires human confirmation.
Tool.ConfirmationRequirement confirmation_requirement = 2
[(google.api.field_behavior) = OPTIONAL];
}
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -367,6 +367,37 @@ message Conversation {
[(google.api.field_behavior) = OUTPUT_ONLY];
}

// Represents the context of a generator.
message GeneratorContext {
// The available generator types.
enum GeneratorType {
// Unspecified generator type.
GENERATOR_TYPE_UNSPECIFIED = 0;

// Free form generator type.
FREE_FORM = 1;

// Agent coaching generator type.
AGENT_COACHING = 2;

// Summarization generator type.
SUMMARIZATION = 3;

// Translation generator type.
TRANSLATION = 4;

// Agent feedback generator type.
AGENT_FEEDBACK = 5;

// Customer message generation generator type.
CUSTOMER_MESSAGE_GENERATION = 6;
}

// Output only. The type of the generator.
GeneratorType generator_type = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
}

// Output only. Identifier. The unique identifier of this conversation.
// Format: `projects/<Project ID>/locations/<Location
// ID>/conversations/<Conversation ID>`.
Expand Down Expand Up @@ -426,9 +457,22 @@ message Conversation {
TelephonyConnectionInfo telephony_connection_info = 10
[(google.api.field_behavior) = OUTPUT_ONLY];

// Optional. Output only. The initial conversation profile to be used to
// configure this conversation, which is a copy of the conversation profile
// config read at conversation creation time.
ConversationProfile initial_conversation_profile = 15 [
(google.api.field_behavior) = OPTIONAL,
(google.api.field_behavior) = OUTPUT_ONLY
];

// Output only. The context reference updates provided by external systems.
map<string, ContextReference> ingested_context_references = 17
[(google.api.field_behavior) = OUTPUT_ONLY];

// Output only. A map with generator name as key and generator context as
// value.
map<string, GeneratorContext> initial_generator_contexts = 18
[(google.api.field_behavior) = OUTPUT_ONLY];
}

// The request message for
Expand Down Expand Up @@ -651,6 +695,15 @@ message SuggestConversationSummaryRequest {
message SuggestConversationSummaryResponse {
// Generated summary for a conversation.
message Summary {
// A component of the generated summary.
message SummarySection {
// Output only. Name of the section.
string section = 1 [(google.api.field_behavior) = OUTPUT_ONLY];

// Output only. Summary text for the section.
string summary = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
}

// The summary content that is concatenated into one string.
string text = 1;

Expand All @@ -659,6 +712,10 @@ message SuggestConversationSummaryResponse {
// specific format for the key or value.
map<string, string> text_sections = 4;

// Same as text_sections, but in an order that is consistent with the order
// of the sections in the generator.
repeated SummarySection sorted_text_sections = 6;

// The name of the answer record. Format:
// "projects/<Project ID>/answerRecords/<Answer Record ID>"
string answer_record = 3 [(google.api.resource_reference) = {
Expand Down Expand Up @@ -1117,6 +1174,36 @@ message SearchKnowledgeRequest {
bool exact_search = 14 [(google.api.field_behavior) = OPTIONAL];
}

// Debug information related to SearchKnowledge feature.
message SearchKnowledgeDebugInfo {
// Configured behaviors for SearchKnowledge.
message SearchKnowledgeBehavior {
// Whether data store agent rewriter was turned on for the request.
bool answer_generation_rewriter_on = 1;

// Whether end_user_metadata is included in the data store agent call.
bool end_user_metadata_included = 2;

// This field indicates whether third party connectors are enabled for the
// project. Note that this field only indicates if the project is
// allowlisted for connectors.
bool third_party_connector_allowed = 4;
}

// Response reason from datastore which indicates data serving status or
// answer quality degradation.
DatastoreResponseReason datastore_response_reason = 1;

// Configured behaviors for SearchKnowledge.
SearchKnowledgeBehavior search_knowledge_behavior = 2;

// Information about parameters ingested for search knowledge.
IngestedContextReferenceDebugInfo ingested_context_reference_debug_info = 3;

// The latency of the service.
ServiceLatency service_latency = 4;
}

// The response message for
// [Conversations.SearchKnowledge][google.cloud.dialogflow.v2.Conversations.SearchKnowledge].
message SearchKnowledgeResponse {
Expand All @@ -1126,6 +1213,9 @@ message SearchKnowledgeResponse {

// The rewritten query used to search knowledge.
string rewritten_query = 3;

// Debug info for SearchKnowledge.
SearchKnowledgeDebugInfo search_knowledge_debug_info = 4;
}

// Represents a SearchKnowledge answer.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -785,6 +785,31 @@ message HumanAgentAssistantConfig {
// If Pub/Sub notification is configured, result will be in
// [ConversationEvent.new_message_payload.SentimentAnalysisResult][google.cloud.dialogflow.v2.ConversationEvent.new_message_payload].
bool enable_sentiment_analysis = 3;

// Optional. Enables sentiment analysis for audio input and conversation
// messages. If unspecified, defaults to false. If this flag is set to true,
// other 'enable_sentiment_analysis' fields will be ignored.
//
// Sentiment analysis inspects user input and identifies the prevailing
// subjective opinion, especially to determine a user's attitude as
// positive, negative, or neutral.
// https://cloud.google.com/natural-language/docs/basics#sentiment_analysis
// For
// [Participants.StreamingAnalyzeContent][google.cloud.dialogflow.v2.Participants.StreamingAnalyzeContent]
// method, result will be in
// [StreamingAnalyzeContentResponse.message.SentimentAnalysisResult][google.cloud.dialogflow.v2.StreamingAnalyzeContentResponse.message].
// For
// [Participants.AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent]
// method, result will be in
// [AnalyzeContentResponse.message.SentimentAnalysisResult][google.cloud.dialogflow.v2.AnalyzeContentResponse.message]
// For
// [Conversations.ListMessages][google.cloud.dialogflow.v2.Conversations.ListMessages]
// method, result will be in
// [ListMessagesResponse.messages.SentimentAnalysisResult][google.cloud.dialogflow.v2.ListMessagesResponse.messages]
// If Pub/Sub notification is configured, result will be in
// [ConversationEvent.new_message_payload.SentimentAnalysisResult][google.cloud.dialogflow.v2.ConversationEvent.new_message_payload].
bool enable_sentiment_analysis_v3 = 5
[(google.api.field_behavior) = OPTIONAL];
}

// Pub/Sub topic on which to publish new agent assistant events.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand All @@ -21,7 +21,10 @@ import "google/api/client.proto";
import "google/api/field_behavior.proto";
import "google/api/resource.proto";
import "google/cloud/dialogflow/v2/agent_coaching_instruction.proto";
import "google/cloud/dialogflow/v2/ces_app.proto";
import "google/cloud/dialogflow/v2/ces_tool.proto";
import "google/cloud/dialogflow/v2/tool_call.proto";
import "google/cloud/dialogflow/v2/toolset.proto";
import "google/protobuf/empty.proto";
import "google/protobuf/field_mask.proto";
import "google/protobuf/timestamp.proto";
Expand Down Expand Up @@ -462,6 +465,18 @@ message Generator {
// AI Coach feature.
SuggestionDedupingConfig suggestion_deduping_config = 23
[(google.api.field_behavior) = OPTIONAL];

// Optional. List of CES toolset specs that the generator can choose from.
repeated ToolsetTool toolset_tools = 27
[(google.api.field_behavior) = OPTIONAL];

// Optional. List of CES tool specs that the generator can choose from.
repeated CesToolSpec ces_tool_specs = 28
[(google.api.field_behavior) = OPTIONAL];

// Optional. List of CES app specs that the generator can choose from.
repeated CesAppSpec ces_app_specs = 29
[(google.api.field_behavior) = OPTIONAL];
}

// Suggestion generated using free form generator.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Loading
Loading