google-cloud-dialogflow-v2 1.7.0 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/dialogflow/v2/answer_record_pb.rb +1 -1
  3. data/lib/google/cloud/dialogflow/v2/answer_records/client.rb +12 -2
  4. data/lib/google/cloud/dialogflow/v2/answer_records/rest/client.rb +12 -2
  5. data/lib/google/cloud/dialogflow/v2/conversation_pb.rb +11 -1
  6. data/lib/google/cloud/dialogflow/v2/conversation_profile_pb.rb +1 -1
  7. data/lib/google/cloud/dialogflow/v2/conversation_services_pb.rb +7 -0
  8. data/lib/google/cloud/dialogflow/v2/conversations/client.rb +212 -1
  9. data/lib/google/cloud/dialogflow/v2/conversations/rest/client.rb +198 -1
  10. data/lib/google/cloud/dialogflow/v2/conversations/rest/service_stub.rb +132 -0
  11. data/lib/google/cloud/dialogflow/v2/document_pb.rb +1 -1
  12. data/lib/google/cloud/dialogflow/v2/encryption_spec_pb.rb +1 -1
  13. data/lib/google/cloud/dialogflow/v2/generator_pb.rb +3 -1
  14. data/lib/google/cloud/dialogflow/v2/knowledge_base_pb.rb +1 -1
  15. data/lib/google/cloud/dialogflow/v2/participant_pb.rb +6 -1
  16. data/lib/google/cloud/dialogflow/v2/participants/client.rb +9 -5
  17. data/lib/google/cloud/dialogflow/v2/participants/rest/client.rb +9 -5
  18. data/lib/google/cloud/dialogflow/v2/rest.rb +1 -1
  19. data/lib/google/cloud/dialogflow/v2/session_pb.rb +1 -1
  20. data/lib/google/cloud/dialogflow/v2/version.rb +1 -1
  21. data/lib/google/cloud/dialogflow/v2.rb +1 -1
  22. data/proto_docs/google/api/client.rb +14 -0
  23. data/proto_docs/google/cloud/dialogflow/v2/answer_record.rb +13 -4
  24. data/proto_docs/google/cloud/dialogflow/v2/audio_config.rb +3 -1
  25. data/proto_docs/google/cloud/dialogflow/v2/conversation.rb +227 -2
  26. data/proto_docs/google/cloud/dialogflow/v2/conversation_model.rb +3 -3
  27. data/proto_docs/google/cloud/dialogflow/v2/conversation_profile.rb +3 -0
  28. data/proto_docs/google/cloud/dialogflow/v2/generator.rb +53 -0
  29. data/proto_docs/google/cloud/dialogflow/v2/participant.rb +79 -14
  30. metadata +3 -3
@@ -67,10 +67,128 @@ module Google
67
67
  # {::Google::Cloud::Dialogflow::V2::Conversation::ConversationStage::VIRTUAL_AGENT_STAGE ConversationStage.VIRTUAL_AGENT_STAGE}
68
68
  # stage and directly goes to
69
69
  # {::Google::Cloud::Dialogflow::V2::Conversation::ConversationStage::HUMAN_ASSIST_STAGE ConversationStage.HUMAN_ASSIST_STAGE}.
70
+ # @!attribute [r] telephony_connection_info
71
+ # @return [::Google::Cloud::Dialogflow::V2::Conversation::TelephonyConnectionInfo]
72
+ # Output only. The telephony connection information.
73
+ # @!attribute [r] ingested_context_references
74
+ # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Dialogflow::V2::Conversation::ContextReference}]
75
+ # Output only. The context reference updates provided by external systems.
70
76
  class Conversation
71
77
  include ::Google::Protobuf::MessageExts
72
78
  extend ::Google::Protobuf::MessageExts::ClassMethods
73
79
 
80
+ # The information about phone calls connected via phone gateway to the
81
+ # conversation.
82
+ # @!attribute [r] dialed_number
83
+ # @return [::String]
84
+ # Output only. The number dialed to connect this call in E.164 format.
85
+ # @!attribute [rw] sdp
86
+ # @return [::String]
87
+ # Optional. SDP of the call. It's initially the SDP answer to the endpoint,
88
+ # but maybe later updated for the purpose of making the link active, etc.
89
+ # @!attribute [r] sip_headers
90
+ # @return [::Array<::Google::Cloud::Dialogflow::V2::Conversation::TelephonyConnectionInfo::SipHeader>]
91
+ # Output only. The SIP headers from the initial SIP INVITE.
92
+ # @!attribute [r] extra_mime_contents
93
+ # @return [::Array<::Google::Cloud::Dialogflow::V2::Conversation::TelephonyConnectionInfo::MimeContent>]
94
+ # Output only. The mime content from the initial SIP INVITE.
95
+ class TelephonyConnectionInfo
96
+ include ::Google::Protobuf::MessageExts
97
+ extend ::Google::Protobuf::MessageExts::ClassMethods
98
+
99
+ # The SIP headers from the initial SIP INVITE.
100
+ # @!attribute [rw] name
101
+ # @return [::String]
102
+ # Optional. The name of the header.
103
+ # @!attribute [rw] value
104
+ # @return [::String]
105
+ # Optional. The value of the header.
106
+ class SipHeader
107
+ include ::Google::Protobuf::MessageExts
108
+ extend ::Google::Protobuf::MessageExts::ClassMethods
109
+ end
110
+
111
+ # The mime content from the initial SIP INVITE.
112
+ # @!attribute [rw] mime_type
113
+ # @return [::String]
114
+ # Optional. The mime type of the content.
115
+ # @!attribute [rw] content
116
+ # @return [::String]
117
+ # Optional. The content payload.
118
+ class MimeContent
119
+ include ::Google::Protobuf::MessageExts
120
+ extend ::Google::Protobuf::MessageExts::ClassMethods
121
+ end
122
+ end
123
+
124
+ # Represents a section of ingested context information.
125
+ # @!attribute [rw] context_contents
126
+ # @return [::Array<::Google::Cloud::Dialogflow::V2::Conversation::ContextReference::ContextContent>]
127
+ # Required. The list of content updates for a context reference.
128
+ # @!attribute [rw] update_mode
129
+ # @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference::UpdateMode]
130
+ # Required. The mode in which context reference contents are updated.
131
+ # @!attribute [rw] language_code
132
+ # @return [::String]
133
+ # Optional. The language of the information ingested, defaults to "en-US"
134
+ # if not set.
135
+ # @!attribute [r] create_time
136
+ # @return [::Google::Protobuf::Timestamp]
137
+ # Output only. The time the context reference was first created.
138
+ class ContextReference
139
+ include ::Google::Protobuf::MessageExts
140
+ extend ::Google::Protobuf::MessageExts::ClassMethods
141
+
142
+ # Contents ingested.
143
+ # @!attribute [rw] content
144
+ # @return [::String]
145
+ # Required. The information ingested in a single request.
146
+ # @!attribute [rw] content_format
147
+ # @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference::ContextContent::ContentFormat]
148
+ # Required. The format of the ingested string.
149
+ # @!attribute [r] ingestion_time
150
+ # @return [::Google::Protobuf::Timestamp]
151
+ # Output only. The time when this information was incorporated into the
152
+ # relevant context reference.
153
+ class ContextContent
154
+ include ::Google::Protobuf::MessageExts
155
+ extend ::Google::Protobuf::MessageExts::ClassMethods
156
+
157
+ # Represents the format of the ingested string.
158
+ module ContentFormat
159
+ # Unspecified content format.
160
+ CONTENT_FORMAT_UNSPECIFIED = 0
161
+
162
+ # Content was provided in JSON format.
163
+ JSON = 1
164
+
165
+ # Content was provided as plain text.
166
+ PLAIN_TEXT = 2
167
+ end
168
+ end
169
+
170
+ # Represents the mode in which context reference contents are updated.
171
+ module UpdateMode
172
+ # Unspecified update mode.
173
+ UPDATE_MODE_UNSPECIFIED = 0
174
+
175
+ # Context content updates are applied in append mode.
176
+ APPEND = 1
177
+
178
+ # Context content updates are applied in overwrite mode.
179
+ OVERWRITE = 2
180
+ end
181
+ end
182
+
183
+ # @!attribute [rw] key
184
+ # @return [::String]
185
+ # @!attribute [rw] value
186
+ # @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference]
187
+ class IngestedContextReferencesEntry
188
+ include ::Google::Protobuf::MessageExts
189
+ extend ::Google::Protobuf::MessageExts::ClassMethods
190
+ end
191
+
74
192
  # Enumeration of the completion status of the conversation.
75
193
  module LifecycleState
76
194
  # Unknown.
@@ -85,7 +203,7 @@ module Google
85
203
 
86
204
  # Enumeration of the different conversation stages a conversation can be in.
87
205
  # Reference:
88
- # https://cloud.google.com/dialogflow/priv/docs/contact-center/basics#stages
206
+ # https://cloud.google.com/agent-assist/docs/basics#conversation_stages
89
207
  module ConversationStage
90
208
  # Unknown. Should never be used after a conversation is successfully
91
209
  # created.
@@ -241,6 +359,9 @@ module Google
241
359
 
242
360
  # Represents a phone number for telephony integration. It allows for connecting
243
361
  # a particular conversation over telephony.
362
+ # @!attribute [r] country_code
363
+ # @return [::Integer]
364
+ # Output only. Desired country code for the phone number.
244
365
  # @!attribute [r] phone_number
245
366
  # @return [::String]
246
367
  # Output only. The phone number to connect to this conversation.
@@ -249,6 +370,50 @@ module Google
249
370
  extend ::Google::Protobuf::MessageExts::ClassMethods
250
371
  end
251
372
 
373
+ # The request message for [ConversationsService.IngestContextReferences][].
374
+ # @!attribute [rw] conversation
375
+ # @return [::String]
376
+ # Required. Resource identifier of the conversation to ingest context
377
+ # information for. Format: `projects/<Project ID>/locations/<Location
378
+ # ID>/conversations/<Conversation ID>`.
379
+ # @!attribute [rw] context_references
380
+ # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Dialogflow::V2::Conversation::ContextReference}]
381
+ # Required. The context references to ingest. The key is the name of the
382
+ # context reference and the value contains the contents of the context
383
+ # reference. The key is used to incorporate ingested context references to
384
+ # enhance the generator.
385
+ class IngestContextReferencesRequest
386
+ include ::Google::Protobuf::MessageExts
387
+ extend ::Google::Protobuf::MessageExts::ClassMethods
388
+
389
+ # @!attribute [rw] key
390
+ # @return [::String]
391
+ # @!attribute [rw] value
392
+ # @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference]
393
+ class ContextReferencesEntry
394
+ include ::Google::Protobuf::MessageExts
395
+ extend ::Google::Protobuf::MessageExts::ClassMethods
396
+ end
397
+ end
398
+
399
+ # The response message for [ConversationsService.IngestContextReferences][].
400
+ # @!attribute [rw] ingested_context_references
401
+ # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Dialogflow::V2::Conversation::ContextReference}]
402
+ # All context references ingested.
403
+ class IngestContextReferencesResponse
404
+ include ::Google::Protobuf::MessageExts
405
+ extend ::Google::Protobuf::MessageExts::ClassMethods
406
+
407
+ # @!attribute [rw] key
408
+ # @return [::String]
409
+ # @!attribute [rw] value
410
+ # @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference]
411
+ class IngestedContextReferencesEntry
412
+ include ::Google::Protobuf::MessageExts
413
+ extend ::Google::Protobuf::MessageExts::ClassMethods
414
+ end
415
+ end
416
+
252
417
  # The request message for
253
418
  # {::Google::Cloud::Dialogflow::V2::Conversations::Client#suggest_conversation_summary Conversations.SuggestConversationSummary}.
254
419
  # @!attribute [rw] conversation
@@ -447,6 +612,12 @@ module Google
447
612
  # `projects/<Project ID>/locations/<Location ID>/generators/<Generator ID>`
448
613
  #
449
614
  # Note: The following fields are mutually exclusive: `generator_name`, `generator`. If a field in that set is populated, all other fields in the set will automatically be cleared.
615
+ # @!attribute [rw] context_references
616
+ # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Dialogflow::V2::Conversation::ContextReference}]
617
+ # Optional. A section of ingested context information. The key is the name of
618
+ # the context reference and the value contains the contents of the context
619
+ # reference. The key is used to incorporate ingested context references to
620
+ # enhance the generator.
450
621
  # @!attribute [rw] conversation_context
451
622
  # @return [::Google::Cloud::Dialogflow::V2::ConversationContext]
452
623
  # Optional. Context of the conversation, including transcripts.
@@ -457,6 +628,15 @@ module Google
457
628
  class GenerateStatelessSuggestionRequest
458
629
  include ::Google::Protobuf::MessageExts
459
630
  extend ::Google::Protobuf::MessageExts::ClassMethods
631
+
632
+ # @!attribute [rw] key
633
+ # @return [::String]
634
+ # @!attribute [rw] value
635
+ # @return [::Google::Cloud::Dialogflow::V2::Conversation::ContextReference]
636
+ class ContextReferencesEntry
637
+ include ::Google::Protobuf::MessageExts
638
+ extend ::Google::Protobuf::MessageExts::ClassMethods
639
+ end
460
640
  end
461
641
 
462
642
  # The response message for
@@ -540,9 +720,18 @@ module Google
540
720
  # @!attribute [rw] boost_specs
541
721
  # @return [::Array<::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::BoostSpecs>]
542
722
  # Optional. Boost specifications for data stores.
723
+ #
724
+ # Maps from datastore name to their boost configuration. Do not specify
725
+ # more than one BoostSpecs for each datastore name. If multiple BoostSpecs
726
+ # are provided for the same datastore name, the behavior is undefined.
543
727
  # @!attribute [rw] filter_specs
544
728
  # @return [::Array<::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::FilterSpecs>]
545
729
  # Optional. Filter specification for data store queries.
730
+ #
731
+ # TMaps from datastore name to the filter expression for that datastore. Do
732
+ # not specify more than one FilterSpecs for each datastore name. If
733
+ # multiple FilterSpecs are provided for the same datastore name, the
734
+ # behavior is undefined.
546
735
  class SearchConfig
547
736
  include ::Google::Protobuf::MessageExts
548
737
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -568,7 +757,7 @@ module Google
568
757
  # @!attribute [rw] condition_boost_specs
569
758
  # @return [::Array<::Google::Cloud::Dialogflow::V2::SearchKnowledgeRequest::SearchConfig::BoostSpecs::BoostSpec::ConditionBoostSpec>]
570
759
  # Optional. Condition boost specifications. If a document matches
571
- # multiple conditions in the specifictions, boost scores from these
760
+ # multiple conditions in the specifications, boost scores from these
572
761
  # specifications are all applied and combined in a non-linear way.
573
762
  # Maximum number of specifications is 20.
574
763
  class BoostSpec
@@ -646,6 +835,18 @@ module Google
646
835
  # The control points used to define the curve. The curve defined
647
836
  # through these control points can only be monotonically increasing
648
837
  # or decreasing(constant values are acceptable).
838
+ # @!attribute [rw] attribute_value
839
+ # @return [::String]
840
+ # Optional. Can be one of:
841
+ # 1. The numerical field value.
842
+ # 2. The duration spec for freshness:
843
+ # The value must be formatted as an XSD `dayTimeDuration` value
844
+ # (a restricted subset of an ISO 8601 duration value). The
845
+ # pattern for this is: `[nD][T[nH][nM][nS]]`.
846
+ # @!attribute [rw] boost_amount
847
+ # @return [::Float]
848
+ # Optional. The value between -1 to 1 by which to boost the score
849
+ # if the attribute_value evaluates to the value specified above.
649
850
  class ControlPoint
650
851
  include ::Google::Protobuf::MessageExts
651
852
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -790,6 +991,30 @@ module Google
790
991
  INTENT = 3
791
992
  end
792
993
  end
994
+
995
+ # The request message for
996
+ # {::Google::Cloud::Dialogflow::V2::Conversations::Client#generate_suggestions Conversations.GenerateSuggestions}.
997
+ # @!attribute [rw] conversation
998
+ # @return [::String]
999
+ # Required. The conversation for which the suggestions are generated. Format:
1000
+ # `projects/<Project ID>/locations/<Location
1001
+ # ID>/conversations/<Conversation ID>`.
1002
+ #
1003
+ # The conversation must be created with a conversation profile which has
1004
+ # generators configured in it to be able to get suggestions.
1005
+ # @!attribute [rw] latest_message
1006
+ # @return [::String]
1007
+ # Optional. The name of the latest conversation message for which the request
1008
+ # is triggered. Format: `projects/<Project ID>/locations/<Location
1009
+ # ID>/conversations/<Conversation ID>/messages/<Message ID>`.
1010
+ # @!attribute [rw] trigger_events
1011
+ # @return [::Array<::Google::Cloud::Dialogflow::V2::TriggerEvent>]
1012
+ # Optional. A list of trigger events. Only generators configured in the
1013
+ # conversation_profile whose trigger_event is listed here will be triggered.
1014
+ class GenerateSuggestionsRequest
1015
+ include ::Google::Protobuf::MessageExts
1016
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1017
+ end
793
1018
  end
794
1019
  end
795
1020
  end
@@ -134,7 +134,7 @@ module Google
134
134
  # @!attribute [r] raw_human_eval_template_csv
135
135
  # @return [::String]
136
136
  # Output only. Human eval template in csv format.
137
- # It tooks real-world conversations provided through input dataset, generates
137
+ # It takes real-world conversations provided through input dataset, generates
138
138
  # example suggestions for customer to verify quality of the model.
139
139
  # For Smart Reply, the generated csv file contains columns of
140
140
  # Context, (Suggestions,Q1,Q2)*3, Actual reply.
@@ -159,12 +159,12 @@ module Google
159
159
  # Required. Datasets used for evaluation.
160
160
  # @!attribute [rw] smart_reply_config
161
161
  # @return [::Google::Cloud::Dialogflow::V2::EvaluationConfig::SmartReplyConfig]
162
- # Configuration for smart reply model evalution.
162
+ # Configuration for smart reply model evaluation.
163
163
  #
164
164
  # Note: The following fields are mutually exclusive: `smart_reply_config`, `smart_compose_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
165
165
  # @!attribute [rw] smart_compose_config
166
166
  # @return [::Google::Cloud::Dialogflow::V2::EvaluationConfig::SmartComposeConfig]
167
- # Configuration for smart compose model evalution.
167
+ # Configuration for smart compose model evaluation.
168
168
  #
169
169
  # Note: The following fields are mutually exclusive: `smart_compose_config`, `smart_reply_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
170
170
  class EvaluationConfig
@@ -717,6 +717,9 @@ module Google
717
717
  # Run smart reply model for chat.
718
718
  SMART_REPLY = 3
719
719
 
720
+ # Run conversation summarization model for chat.
721
+ CONVERSATION_SUMMARIZATION = 8
722
+
720
723
  # Run knowledge search with text input from agent or text generated query.
721
724
  KNOWLEDGE_SEARCH = 14
722
725
 
@@ -278,6 +278,14 @@ module Google
278
278
 
279
279
  # Customer defined sections.
280
280
  CUSTOMER_DEFINED = 7
281
+
282
+ # Concise version of the situation section. This type is only available if
283
+ # type SITUATION is not selected.
284
+ SITUATION_CONCISE = 9
285
+
286
+ # Concise version of the action section. This type is only available if
287
+ # type ACTION is not selected.
288
+ ACTION_CONCISE = 10
281
289
  end
282
290
  end
283
291
 
@@ -303,6 +311,15 @@ module Google
303
311
  extend ::Google::Protobuf::MessageExts::ClassMethods
304
312
  end
305
313
 
314
+ # Free form generator context that customer can configure.
315
+ # @!attribute [rw] text
316
+ # @return [::String]
317
+ # Optional. Free form text input to LLM.
318
+ class FreeFormContext
319
+ include ::Google::Protobuf::MessageExts
320
+ extend ::Google::Protobuf::MessageExts::ClassMethods
321
+ end
322
+
306
323
  # LLM generator.
307
324
  # @!attribute [r] name
308
325
  # @return [::String]
@@ -311,9 +328,16 @@ module Google
311
328
  # @!attribute [rw] description
312
329
  # @return [::String]
313
330
  # Optional. Human readable description of the generator.
331
+ # @!attribute [rw] free_form_context
332
+ # @return [::Google::Cloud::Dialogflow::V2::FreeFormContext]
333
+ # Input of free from generator to LLM.
334
+ #
335
+ # Note: The following fields are mutually exclusive: `free_form_context`, `summarization_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
314
336
  # @!attribute [rw] summarization_context
315
337
  # @return [::Google::Cloud::Dialogflow::V2::SummarizationContext]
316
338
  # Input of prebuilt Summarization feature.
339
+ #
340
+ # Note: The following fields are mutually exclusive: `summarization_context`, `free_form_context`. If a field in that set is populated, all other fields in the set will automatically be cleared.
317
341
  # @!attribute [rw] inference_parameter
318
342
  # @return [::Google::Cloud::Dialogflow::V2::InferenceParameter]
319
343
  # Optional. Inference parameters for this generator.
@@ -321,6 +345,13 @@ module Google
321
345
  # @return [::Google::Cloud::Dialogflow::V2::TriggerEvent]
322
346
  # Optional. The trigger event of the generator. It defines when the generator
323
347
  # is triggered in a conversation.
348
+ # @!attribute [rw] published_model
349
+ # @return [::String]
350
+ # Optional. The published Large Language Model name.
351
+ # * To use the latest model version, specify the model name without version
352
+ # number. Example: `text-bison`
353
+ # * To use a stable model version, specify the version number as well.
354
+ # Example: `text-bison@002`.
324
355
  # @!attribute [r] create_time
325
356
  # @return [::Google::Protobuf::Timestamp]
326
357
  # Output only. Creation time of this generator.
@@ -332,6 +363,15 @@ module Google
332
363
  extend ::Google::Protobuf::MessageExts::ClassMethods
333
364
  end
334
365
 
366
+ # Suggestion generated using free form generator.
367
+ # @!attribute [rw] response
368
+ # @return [::String]
369
+ # Required. Free form suggestion.
370
+ class FreeFormSuggestion
371
+ include ::Google::Protobuf::MessageExts
372
+ extend ::Google::Protobuf::MessageExts::ClassMethods
373
+ end
374
+
335
375
  # Suggested summary of the conversation.
336
376
  # @!attribute [rw] summary_sections
337
377
  # @return [::Array<::Google::Cloud::Dialogflow::V2::SummarySuggestion::SummarySection>]
@@ -354,9 +394,16 @@ module Google
354
394
  end
355
395
 
356
396
  # Suggestion generated using a Generator.
397
+ # @!attribute [rw] free_form_suggestion
398
+ # @return [::Google::Cloud::Dialogflow::V2::FreeFormSuggestion]
399
+ # Optional. Free form suggestion.
400
+ #
401
+ # Note: The following fields are mutually exclusive: `free_form_suggestion`, `summary_suggestion`. If a field in that set is populated, all other fields in the set will automatically be cleared.
357
402
  # @!attribute [rw] summary_suggestion
358
403
  # @return [::Google::Cloud::Dialogflow::V2::SummarySuggestion]
359
404
  # Optional. Suggested summary.
405
+ #
406
+ # Note: The following fields are mutually exclusive: `summary_suggestion`, `free_form_suggestion`. If a field in that set is populated, all other fields in the set will automatically be cleared.
360
407
  class GeneratorSuggestion
361
408
  include ::Google::Protobuf::MessageExts
362
409
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -374,6 +421,12 @@ module Google
374
421
  # Conversations.GenerateStatelessSuggestion and
375
422
  # Conversations.GenerateSuggestions.
376
423
  MANUAL_CALL = 2
424
+
425
+ # Triggers after each customer message only.
426
+ CUSTOMER_MESSAGE = 3
427
+
428
+ # Triggers after each agent message only.
429
+ AGENT_MESSAGE = 4
377
430
  end
378
431
  end
379
432
  end
@@ -145,7 +145,8 @@ module Google
145
145
  # Output only. The time when the message was created in Contact Center AI.
146
146
  # @!attribute [rw] send_time
147
147
  # @return [::Google::Protobuf::Timestamp]
148
- # Optional. The time when the message was sent.
148
+ # Optional. The time when the message was sent. For voice messages, this is
149
+ # the time when an utterance started.
149
150
  # @!attribute [r] message_annotation
150
151
  # @return [::Google::Cloud::Dialogflow::V2::MessageAnnotation]
151
152
  # Output only. The annotation for the message.
@@ -242,17 +243,22 @@ module Google
242
243
  # @return [::Google::Cloud::Dialogflow::V2::TextInput]
243
244
  # The natural language text to be processed.
244
245
  #
245
- # Note: The following fields are mutually exclusive: `text_input`, `event_input`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
246
+ # Note: The following fields are mutually exclusive: `text_input`, `audio_input`, `event_input`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
247
+ # @!attribute [rw] audio_input
248
+ # @return [::Google::Cloud::Dialogflow::V2::AudioInput]
249
+ # The natural language speech audio to be processed.
250
+ #
251
+ # Note: The following fields are mutually exclusive: `audio_input`, `text_input`, `event_input`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
246
252
  # @!attribute [rw] event_input
247
253
  # @return [::Google::Cloud::Dialogflow::V2::EventInput]
248
254
  # An input event to send to Dialogflow.
249
255
  #
250
- # Note: The following fields are mutually exclusive: `event_input`, `text_input`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
256
+ # Note: The following fields are mutually exclusive: `event_input`, `text_input`, `audio_input`, `suggestion_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
251
257
  # @!attribute [rw] suggestion_input
252
258
  # @return [::Google::Cloud::Dialogflow::V2::SuggestionInput]
253
259
  # An input representing the selection of a suggestion.
254
260
  #
255
- # Note: The following fields are mutually exclusive: `suggestion_input`, `text_input`, `event_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
261
+ # Note: The following fields are mutually exclusive: `suggestion_input`, `text_input`, `audio_input`, `event_input`. If a field in that set is populated, all other fields in the set will automatically be cleared.
256
262
  # @!attribute [rw] reply_audio_config
257
263
  # @return [::Google::Cloud::Dialogflow::V2::OutputAudioConfig]
258
264
  # Speech synthesis configuration.
@@ -477,10 +483,10 @@ module Google
477
483
  # https://cloud.google.com/agent-assist/docs/extended-streaming
478
484
  # @!attribute [rw] enable_partial_automated_agent_reply
479
485
  # @return [::Boolean]
480
- # Enable partial virtual agent responses. If this flag is not enabled,
481
- # response stream still contains only one final response even if some
482
- # `Fulfillment`s in Dialogflow virtual agent have been configured to return
483
- # partial responses.
486
+ # Optional. Enable partial responses from Dialogflow CX agent. If this flag
487
+ # is not enabled, response stream still contains only one final response even
488
+ # if some `Fulfillment`s in Dialogflow CX agent have been configured to
489
+ # return partial responses.
484
490
  # @!attribute [rw] enable_debugging_info
485
491
  # @return [::Boolean]
486
492
  # If true, `StreamingAnalyzeContentResponse.debugging_info` will get
@@ -562,6 +568,9 @@ module Google
562
568
  # @return [::Google::Cloud::Dialogflow::V2::CloudConversationDebuggingInfo]
563
569
  # Debugging info that would get populated when
564
570
  # `StreamingAnalyzeContentRequest.enable_debugging_info` is set to true.
571
+ # @!attribute [rw] speech_model
572
+ # @return [::String]
573
+ # The name of the actual Cloud speech model used for speech recognition.
565
574
  class StreamingAnalyzeContentResponse
566
575
  include ::Google::Protobuf::MessageExts
567
576
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -672,6 +681,41 @@ module Google
672
681
  extend ::Google::Protobuf::MessageExts::ClassMethods
673
682
  end
674
683
 
684
+ # The response message for
685
+ # {::Google::Cloud::Dialogflow::V2::Conversations::Client#generate_suggestions Conversations.GenerateSuggestions}.
686
+ # @!attribute [rw] generator_suggestion_answers
687
+ # @return [::Array<::Google::Cloud::Dialogflow::V2::GenerateSuggestionsResponse::GeneratorSuggestionAnswer>]
688
+ # The answers generated for the conversation based on context.
689
+ # @!attribute [rw] latest_message
690
+ # @return [::String]
691
+ # The name of the latest conversation message used as context for
692
+ # compiling suggestion.
693
+ #
694
+ # Format: `projects/<Project ID>/locations/<Location
695
+ # ID>/conversations/<Conversation ID>/messages/<Message ID>`.
696
+ class GenerateSuggestionsResponse
697
+ include ::Google::Protobuf::MessageExts
698
+ extend ::Google::Protobuf::MessageExts::ClassMethods
699
+
700
+ # A GeneratorSuggestion answer.
701
+ # @!attribute [rw] generator_suggestion
702
+ # @return [::Google::Cloud::Dialogflow::V2::GeneratorSuggestion]
703
+ # Suggestion details.
704
+ # @!attribute [rw] source_generator
705
+ # @return [::String]
706
+ # The name of the generator used to generate this suggestion. Format:
707
+ # `projects/<Project ID>/locations/<Location ID>/generators/<Generator
708
+ # ID>`.
709
+ # @!attribute [rw] answer_record
710
+ # @return [::String]
711
+ # Answer record that uniquely identifies the suggestion. This can be used
712
+ # to provide suggestion feedback.
713
+ class GeneratorSuggestionAnswer
714
+ include ::Google::Protobuf::MessageExts
715
+ extend ::Google::Protobuf::MessageExts::ClassMethods
716
+ end
717
+ end
718
+
675
719
  # The request message for
676
720
  # {::Google::Cloud::Dialogflow::V2::Participants::Client#suggest_smart_replies Participants.SuggestSmartReplies}.
677
721
  # @!attribute [rw] parent
@@ -728,6 +772,21 @@ module Google
728
772
  extend ::Google::Protobuf::MessageExts::ClassMethods
729
773
  end
730
774
 
775
+ # Represents the natural language speech audio to be processed.
776
+ # @!attribute [rw] config
777
+ # @return [::Google::Cloud::Dialogflow::V2::InputAudioConfig]
778
+ # Required. Instructs the speech recognizer how to process the speech audio.
779
+ # @!attribute [rw] audio
780
+ # @return [::String]
781
+ # Required. The natural language speech audio to be processed.
782
+ # A single request can contain up to 2 minutes of speech audio data.
783
+ # The transcribed text cannot contain more than 256 bytes for virtual agent
784
+ # interactions.
785
+ class AudioInput
786
+ include ::Google::Protobuf::MessageExts
787
+ extend ::Google::Protobuf::MessageExts::ClassMethods
788
+ end
789
+
731
790
  # Represents the natural language speech audio to be played to the end user.
732
791
  # @!attribute [rw] config
733
792
  # @return [::Google::Cloud::Dialogflow::V2::OutputAudioConfig]
@@ -929,27 +988,33 @@ module Google
929
988
  # @return [::Google::Rpc::Status]
930
989
  # Error status if the request failed.
931
990
  #
932
- # Note: The following fields are mutually exclusive: `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
991
+ # Note: The following fields are mutually exclusive: `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
933
992
  # @!attribute [rw] suggest_articles_response
934
993
  # @return [::Google::Cloud::Dialogflow::V2::SuggestArticlesResponse]
935
994
  # SuggestArticlesResponse if request is for ARTICLE_SUGGESTION.
936
995
  #
937
- # Note: The following fields are mutually exclusive: `suggest_articles_response`, `error`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
996
+ # Note: The following fields are mutually exclusive: `suggest_articles_response`, `error`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
938
997
  # @!attribute [rw] suggest_knowledge_assist_response
939
998
  # @return [::Google::Cloud::Dialogflow::V2::SuggestKnowledgeAssistResponse]
940
999
  # SuggestKnowledgeAssistResponse if request is for KNOWLEDGE_ASSIST.
941
1000
  #
942
- # Note: The following fields are mutually exclusive: `suggest_knowledge_assist_response`, `error`, `suggest_articles_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1001
+ # Note: The following fields are mutually exclusive: `suggest_knowledge_assist_response`, `error`, `suggest_articles_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
943
1002
  # @!attribute [rw] suggest_faq_answers_response
944
1003
  # @return [::Google::Cloud::Dialogflow::V2::SuggestFaqAnswersResponse]
945
1004
  # SuggestFaqAnswersResponse if request is for FAQ_ANSWER.
946
1005
  #
947
- # Note: The following fields are mutually exclusive: `suggest_faq_answers_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_smart_replies_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1006
+ # Note: The following fields are mutually exclusive: `suggest_faq_answers_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_smart_replies_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
948
1007
  # @!attribute [rw] suggest_smart_replies_response
949
1008
  # @return [::Google::Cloud::Dialogflow::V2::SuggestSmartRepliesResponse]
950
1009
  # SuggestSmartRepliesResponse if request is for SMART_REPLY.
951
1010
  #
952
- # Note: The following fields are mutually exclusive: `suggest_smart_replies_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1011
+ # Note: The following fields are mutually exclusive: `suggest_smart_replies_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `generate_suggestions_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1012
+ # @!attribute [rw] generate_suggestions_response
1013
+ # @return [::Google::Cloud::Dialogflow::V2::GenerateSuggestionsResponse]
1014
+ # Suggestions generated using generators triggered by customer or agent
1015
+ # messages.
1016
+ #
1017
+ # Note: The following fields are mutually exclusive: `generate_suggestions_response`, `error`, `suggest_articles_response`, `suggest_knowledge_assist_response`, `suggest_faq_answers_response`, `suggest_smart_replies_response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
953
1018
  class SuggestionResult
954
1019
  include ::Google::Protobuf::MessageExts
955
1020
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1079,7 +1144,7 @@ module Google
1079
1144
  # @!attribute [rw] previous_suggested_query
1080
1145
  # @return [::String]
1081
1146
  # Optional. The previously suggested query for the given conversation. This
1082
- # helps identify whether the next suggestion we generate is resonably
1147
+ # helps identify whether the next suggestion we generate is reasonably
1083
1148
  # different from the previous one. This is useful to avoid similar
1084
1149
  # suggestions within the conversation.
1085
1150
  class SuggestKnowledgeAssistRequest
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-dialogflow-v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.7.0
4
+ version: 1.9.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-01-29 00:00:00.000000000 Z
10
+ date: 2025-03-12 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: gapic-common
@@ -335,7 +335,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
335
335
  - !ruby/object:Gem::Version
336
336
  version: '0'
337
337
  requirements: []
338
- rubygems_version: 3.6.2
338
+ rubygems_version: 3.6.5
339
339
  specification_version: 4
340
340
  summary: Builds conversational interfaces (for example, chatbots, and voice-powered
341
341
  apps and devices).