1- // Copyright 2025 Google LLC
1+ // Copyright 2026 Google LLC
22//
33// Licensed under the Apache License, Version 2.0 (the "License");
44// you may not use this file except in compliance with the License.
@@ -382,6 +382,37 @@ message Conversation {
382382 [(google.api.field_behavior ) = OUTPUT_ONLY ];
383383 }
384384
385+ // Represents the context of a generator.
386+ message GeneratorContext {
387+ // The available generator types.
388+ enum GeneratorType {
389+ // Unspecified generator type.
390+ GENERATOR_TYPE_UNSPECIFIED = 0 ;
391+
392+ // Free form generator type.
393+ FREE_FORM = 1 ;
394+
395+ // Agent coaching generator type.
396+ AGENT_COACHING = 2 ;
397+
398+ // Summarization generator type.
399+ SUMMARIZATION = 3 ;
400+
401+ // Translation generator type.
402+ TRANSLATION = 4 ;
403+
404+ // Agent feedback generator type.
405+ AGENT_FEEDBACK = 5 ;
406+
407+ // Customer message generation generator type.
408+ CUSTOMER_MESSAGE_GENERATION = 6 ;
409+ }
410+
411+ // Output only. The type of the generator.
412+ GeneratorType generator_type = 1
413+ [(google.api.field_behavior ) = OUTPUT_ONLY ];
414+ }
415+
385416 // Output only. Identifier. The unique identifier of this conversation.
386417 // Format: `projects/<Project ID>/locations/<Location
387418 // ID>/conversations/<Conversation ID>`.
@@ -441,9 +472,22 @@ message Conversation {
441472 TelephonyConnectionInfo telephony_connection_info = 10
442473 [(google.api.field_behavior ) = OUTPUT_ONLY ];
443474
475+ // Optional. Output only. The initial conversation profile to be used to
476+ // configure this conversation, which is a copy of the conversation profile
477+ // config read at conversation creation time.
478+ ConversationProfile initial_conversation_profile = 15 [
479+ (google.api.field_behavior ) = OPTIONAL ,
480+ (google.api.field_behavior ) = OUTPUT_ONLY
481+ ];
482+
444483 // Output only. The context reference updates provided by external systems.
445484 map <string , ContextReference > ingested_context_references = 17
446485 [(google.api.field_behavior ) = OUTPUT_ONLY ];
486+
487+ // Output only. A map with generator name as key and generator context as
488+ // value.
489+ map <string , GeneratorContext > initial_generator_contexts = 18
490+ [(google.api.field_behavior ) = OUTPUT_ONLY ];
447491}
448492
449493// Represents a phone number for telephony integration. It allows for connecting
@@ -711,6 +755,15 @@ message SuggestConversationSummaryRequest {
711755message SuggestConversationSummaryResponse {
712756 // Generated summary for a conversation.
713757 message Summary {
758+ // A component of the generated summary.
759+ message SummarySection {
760+ // Output only. Name of the section.
761+ string section = 1 [(google.api.field_behavior ) = OUTPUT_ONLY ];
762+
763+ // Output only. Summary text for the section.
764+ string summary = 2 [(google.api.field_behavior ) = OUTPUT_ONLY ];
765+ }
766+
714767 // The summary content that is concatenated into one string.
715768 string text = 1 ;
716769
@@ -719,6 +772,10 @@ message SuggestConversationSummaryResponse {
719772 // specific format for the key or value.
720773 map <string , string > text_sections = 4 ;
721774
775+ // Same as text_sections, but in an order that is consistent with the order
776+ // of the sections in the generator.
777+ repeated SummarySection sorted_text_sections = 6 ;
778+
722779 // The name of the answer record. Format:
723780 // "projects/<Project ID>/answerRecords/<Answer Record ID>"
724781 string answer_record = 3 [(google.api.resource_reference ) = {
@@ -1173,6 +1230,36 @@ message SearchKnowledgeRequest {
11731230 bool exact_search = 14 [(google.api.field_behavior ) = OPTIONAL ];
11741231}
11751232
1233+ // Debug information related to SearchKnowledge feature.
1234+ message SearchKnowledgeDebugInfo {
1235+ // Configured behaviors for SearchKnowledge.
1236+ message SearchKnowledgeBehavior {
1237+ // Whether data store agent rewriter was turned on for the request.
1238+ bool answer_generation_rewriter_on = 1 ;
1239+
1240+ // Whether end_user_metadata is included in the data store agent call.
1241+ bool end_user_metadata_included = 2 ;
1242+
1243+ // This field indicates whether third party connectors are enabled for the
1244+ // project. Note that this field only indicates if the project is
1245+ // allowlisted for connectors.
1246+ bool third_party_connector_allowed = 4 ;
1247+ }
1248+
1249+ // Response reason from datastore which indicates data serving status or
1250+ // answer quality degradation.
1251+ DatastoreResponseReason datastore_response_reason = 1 ;
1252+
1253+ // Configured behaviors for SearchKnowledge.
1254+ SearchKnowledgeBehavior search_knowledge_behavior = 2 ;
1255+
1256+ // Information about parameters ingested for search knowledge.
1257+ IngestedContextReferenceDebugInfo ingested_context_reference_debug_info = 3 ;
1258+
1259+ // The latency of the service.
1260+ ServiceLatency service_latency = 4 ;
1261+ }
1262+
11761263// The response message for
11771264// [Conversations.SearchKnowledge][google.cloud.dialogflow.v2beta1.Conversations.SearchKnowledge].
11781265message SearchKnowledgeResponse {
@@ -1182,6 +1269,9 @@ message SearchKnowledgeResponse {
11821269
11831270 // The rewritten query used to search knowledge.
11841271 string rewritten_query = 3 ;
1272+
1273+ // Debug info for SearchKnowledge.
1274+ SearchKnowledgeDebugInfo search_knowledge_debug_info = 4 ;
11851275}
11861276
11871277// Represents a SearchKnowledge answer.
0 commit comments