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.
@@ -367,6 +367,37 @@ message Conversation {
367367 [(google.api.field_behavior ) = OUTPUT_ONLY ];
368368 }
369369
370+ // Represents the context of a generator.
371+ message GeneratorContext {
372+ // The available generator types.
373+ enum GeneratorType {
374+ // Unspecified generator type.
375+ GENERATOR_TYPE_UNSPECIFIED = 0 ;
376+
377+ // Free form generator type.
378+ FREE_FORM = 1 ;
379+
380+ // Agent coaching generator type.
381+ AGENT_COACHING = 2 ;
382+
383+ // Summarization generator type.
384+ SUMMARIZATION = 3 ;
385+
386+ // Translation generator type.
387+ TRANSLATION = 4 ;
388+
389+ // Agent feedback generator type.
390+ AGENT_FEEDBACK = 5 ;
391+
392+ // Customer message generation generator type.
393+ CUSTOMER_MESSAGE_GENERATION = 6 ;
394+ }
395+
396+ // Output only. The type of the generator.
397+ GeneratorType generator_type = 1
398+ [(google.api.field_behavior ) = OUTPUT_ONLY ];
399+ }
400+
370401 // Output only. Identifier. The unique identifier of this conversation.
371402 // Format: `projects/<Project ID>/locations/<Location
372403 // ID>/conversations/<Conversation ID>`.
@@ -426,9 +457,22 @@ message Conversation {
426457 TelephonyConnectionInfo telephony_connection_info = 10
427458 [(google.api.field_behavior ) = OUTPUT_ONLY ];
428459
460+ // Optional. Output only. The initial conversation profile to be used to
461+ // configure this conversation, which is a copy of the conversation profile
462+ // config read at conversation creation time.
463+ ConversationProfile initial_conversation_profile = 15 [
464+ (google.api.field_behavior ) = OPTIONAL ,
465+ (google.api.field_behavior ) = OUTPUT_ONLY
466+ ];
467+
429468 // Output only. The context reference updates provided by external systems.
430469 map <string , ContextReference > ingested_context_references = 17
431470 [(google.api.field_behavior ) = OUTPUT_ONLY ];
471+
472+ // Output only. A map with generator name as key and generator context as
473+ // value.
474+ map <string , GeneratorContext > initial_generator_contexts = 18
475+ [(google.api.field_behavior ) = OUTPUT_ONLY ];
432476}
433477
434478// The request message for
@@ -651,6 +695,15 @@ message SuggestConversationSummaryRequest {
651695message SuggestConversationSummaryResponse {
652696 // Generated summary for a conversation.
653697 message Summary {
698+ // A component of the generated summary.
699+ message SummarySection {
700+ // Output only. Name of the section.
701+ string section = 1 [(google.api.field_behavior ) = OUTPUT_ONLY ];
702+
703+ // Output only. Summary text for the section.
704+ string summary = 2 [(google.api.field_behavior ) = OUTPUT_ONLY ];
705+ }
706+
654707 // The summary content that is concatenated into one string.
655708 string text = 1 ;
656709
@@ -659,6 +712,10 @@ message SuggestConversationSummaryResponse {
659712 // specific format for the key or value.
660713 map <string , string > text_sections = 4 ;
661714
715+ // Same as text_sections, but in an order that is consistent with the order
716+ // of the sections in the generator.
717+ repeated SummarySection sorted_text_sections = 6 ;
718+
662719 // The name of the answer record. Format:
663720 // "projects/<Project ID>/answerRecords/<Answer Record ID>"
664721 string answer_record = 3 [(google.api.resource_reference ) = {
@@ -1117,6 +1174,36 @@ message SearchKnowledgeRequest {
11171174 bool exact_search = 14 [(google.api.field_behavior ) = OPTIONAL ];
11181175}
11191176
1177+ // Debug information related to SearchKnowledge feature.
1178+ message SearchKnowledgeDebugInfo {
1179+ // Configured behaviors for SearchKnowledge.
1180+ message SearchKnowledgeBehavior {
1181+ // Whether data store agent rewriter was turned on for the request.
1182+ bool answer_generation_rewriter_on = 1 ;
1183+
1184+ // Whether end_user_metadata is included in the data store agent call.
1185+ bool end_user_metadata_included = 2 ;
1186+
1187+ // This field indicates whether third party connectors are enabled for the
1188+ // project. Note that this field only indicates if the project is
1189+ // allowlisted for connectors.
1190+ bool third_party_connector_allowed = 4 ;
1191+ }
1192+
1193+ // Response reason from datastore which indicates data serving status or
1194+ // answer quality degradation.
1195+ DatastoreResponseReason datastore_response_reason = 1 ;
1196+
1197+ // Configured behaviors for SearchKnowledge.
1198+ SearchKnowledgeBehavior search_knowledge_behavior = 2 ;
1199+
1200+ // Information about parameters ingested for search knowledge.
1201+ IngestedContextReferenceDebugInfo ingested_context_reference_debug_info = 3 ;
1202+
1203+ // The latency of the service.
1204+ ServiceLatency service_latency = 4 ;
1205+ }
1206+
11201207// The response message for
11211208// [Conversations.SearchKnowledge][google.cloud.dialogflow.v2.Conversations.SearchKnowledge].
11221209message SearchKnowledgeResponse {
@@ -1126,6 +1213,9 @@ message SearchKnowledgeResponse {
11261213
11271214 // The rewritten query used to search knowledge.
11281215 string rewritten_query = 3 ;
1216+
1217+ // Debug info for SearchKnowledge.
1218+ SearchKnowledgeDebugInfo search_knowledge_debug_info = 4 ;
11291219}
11301220
11311221// Represents a SearchKnowledge answer.
0 commit comments