feat: add agentDesktopSource field to the Participant object

Google APIs · copybara-github · commit 91e4279d3677 · 2025-11-10T08:43:29.000-08:00
docs: Update evaluator version from output only to optional.
docs: Add further clarification for when the event Type CONVERSATION_FINISHED is fired

PiperOrigin-RevId: 830460349
diff --git a/google/cloud/dialogflow/v2beta1/conversation_event.proto b/google/cloud/dialogflow/v2beta1/conversation_event.proto
@@ -43,6 +43,8 @@ message ConversationEvent {
 
     // An existing conversation has closed. This is fired when a telephone call
     // is terminated, or a conversation is closed via the API.
+    // The event is fired for every CompleteConversation call, even if the
+    // conversation is already closed.
     CONVERSATION_FINISHED = 2;
 
     // An existing conversation has received notification from Dialogflow that
diff --git a/google/cloud/dialogflow/v2beta1/generator_evaluation.proto b/google/cloud/dialogflow/v2beta1/generator_evaluation.proto
@@ -543,9 +543,9 @@ message GeneratorEvaluationConfig {
     string completeness_evaluation_version = 4
         [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
-    // Output only. Version for summarization evaluation.
+    // Optional. Version for summarization evaluation.
     optional string evaluator_version = 5
-        [(google.api.field_behavior) = OUTPUT_ONLY];
+        [(google.api.field_behavior) = OPTIONAL];
   }
 
   // Required. The config/source of input data.
diff --git a/google/cloud/dialogflow/v2beta1/participant.proto b/google/cloud/dialogflow/v2beta1/participant.proto
@@ -277,6 +277,29 @@ message Participant {
     END_USER = 3;
   }
 
+  // Enumeration of the Agent Desktop Source when using prebuilt Agent
+  // Assist integration modules.
+  enum AgentDesktopSource {
+    // Agent Desktop Source is not specified.
+    AGENT_DESKTOP_SOURCE_UNSPECIFIED = 0;
+
+    // Agent Desktop Source is Live Person.
+    LIVE_PERSON = 1;
+
+    // Agent Desktop Source is Genesys Cloud.
+    GENESYS_CLOUD = 2;
+
+    // Agent Desktop Source is Twilio.
+    TWILIO = 3;
+
+    // Agent Desktop Source is Salesforce.
+    SALESFORCE = 4;
+
+    // UI Modules are in use but the desktop is either not currently released or
+    // setting this field to the applicable desktop.
+    OTHER = 8;
+  }
+
   // Optional. The unique identifier of this participant.
   // Format: `projects/<Project ID>/locations/<Location
   // ID>/conversations/<Conversation ID>/participants/<Participant ID>`.
@@ -341,6 +364,19 @@ message Participant {
   // ```
   map<string, string> documents_metadata_filters = 8
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. For tracking the utilization of prebuilt Agent Assist integration
+  // modules. This field is only inscope for Integration type that include UI
+  // Modules, Backend Modules, and Agent Desktop connector, it is out of scope
+  // for CCaaS and Direct Integration.
+  // For each human agent, prebuilt UI Modules needs to trigger the
+  // UpdateParticipant API to update this field. Both
+  // [CreateParticipantRequest][google.cloud.dialogflow.v2beta1.CreateParticipantRequest.participant]
+  // and
+  // [UpdateParticipantRequest][google.cloud.dialogflow.v2beta1.UpdateParticipantRequest.participant]
+  // will be supported.
+  AgentDesktopSource agent_desktop_source = 10
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Represents a message posted into a conversation.
