google-cloud-dialogflow-v2 0.30.0 → 0.32.0

data/lib/google/cloud/dialogflow/v2/versions/rest/service_stub.rb

@@ -30,16 +30,28 @@ module Google
             # including transcoding, making the REST call, and deserialing the response.
             #
             class ServiceStub
-              def initialize endpoint:, credentials:
+              def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
                 # These require statements are intentionally placed here to initialize
                 # the REST modules only when it's required.
                 require "gapic/rest"
 
-                @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
+                @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
+                                                             endpoint_template: endpoint_template,
+                                                             universe_domain: universe_domain,
+                                                             credentials: credentials,
                                                              numeric_enums: true,
                                                              raise_faraday_errors: false
               end
 
+              ##
+              # The effective universe domain
+              #
+              # @return [String]
+              #
+              def universe_domain
+                @client_stub.universe_domain
+              end
+
               ##
               # Baseline implementation for the list_versions REST call
               #

data/proto_docs/google/api/client.rb

@@ -21,6 +21,7 @@ module Google
   module Api
     # Required information for every language.
     # @!attribute [rw] reference_docs_uri
+    #   @deprecated This field is deprecated and may be removed in the next major version update.
     #   @return [::String]
     #     Link to automatically generated reference documentation.  Example:
     #     https://cloud.google.com/nodejs/docs/reference/asset/latest
@@ -304,6 +305,19 @@ module Google
     #                seconds: 360 # 6 minutes
     #              total_poll_timeout:
     #                 seconds: 54000 # 90 minutes
+    # @!attribute [rw] auto_populated_fields
+    #   @return [::Array<::String>]
+    #     List of top-level fields of the request message, that should be
+    #     automatically populated by the client libraries based on their
+    #     (google.api.field_info).format. Currently supported format: UUID4.
+    #
+    #     Example of a YAML configuration:
+    #
+    #      publishing:
+    #        method_settings:
+    #          - selector: google.example.v1.ExampleService.CreateExample
+    #            auto_populated_fields:
+    #            - request_id
     class MethodSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/dialogflow/v2/agent.rb

@@ -68,6 +68,7 @@ module Google
         #   @return [::Boolean]
         #     Optional. Determines whether this agent should log conversation queries.
         # @!attribute [rw] match_mode
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Google::Cloud::Dialogflow::V2::Agent::MatchMode]
         #     Optional. Determines how intents are detected from user queries.
         # @!attribute [rw] classification_threshold

data/proto_docs/google/cloud/dialogflow/v2/answer_record.rb

@@ -75,6 +75,7 @@ module Google
         #     chronological order. Format: `projects/<Project ID>/locations/<Location
         #     ID>`.
         # @!attribute [rw] filter
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::String]
         #     Optional. Filters to restrict results to specific answer records.
         #

data/proto_docs/google/cloud/dialogflow/v2/audio_config.rb

@@ -108,6 +108,7 @@ module Google
         #     offsets. If false or unspecified, Speech doesn't return any word-level
         #     information.
         # @!attribute [rw] phrase_hints
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Array<::String>]
         #     A list of strings containing words and phrases that the speech
         #     recognizer should recognize with higher likelihood.
@@ -128,23 +129,9 @@ module Google
         #     for more details.
         # @!attribute [rw] model
         #   @return [::String]
-        #     Which Speech model to select for the given request. Select the
-        #     model best suited to your domain to get best results. If a model is not
-        #     explicitly specified, then we auto-select a model based on the parameters
-        #     in the InputAudioConfig.
-        #     If enhanced speech model is enabled for the agent and an enhanced
-        #     version of the specified model for the language does not exist, then the
-        #     speech is recognized using the standard version of the specified model.
-        #     Refer to
-        #     [Cloud Speech API
-        #     documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model)
-        #     for more details.
-        #     If you specify a model, the following models typically have the best
-        #     performance:
-        #
-        #     - phone_call (best for Agent Assist and telephony)
-        #     - latest_short (best for Dialogflow non-telephony)
-        #     - command_and_search (best for very short utterances and commands)
+        #     Optional. Which Speech model to select for the given request.
+        #     For more information, see
+        #     [Speech models](https://cloud.google.com/dialogflow/es/docs/speech-models).
         # @!attribute [rw] model_variant
         #   @return [::Google::Cloud::Dialogflow::V2::SpeechModelVariant]
         #     Which variant of the [Speech
@@ -276,13 +263,28 @@ module Google
         #     error.
         # @!attribute [rw] model
         #   @return [::String]
-        #     Which Speech model to select. Select the model best suited to your domain
-        #     to get best results. If a model is not explicitly specified, then a default
-        #     model is used.
+        #     Which Speech model to select. Select the
+        #     model best suited to your domain to get best results. If a model is not
+        #     explicitly specified, then Dialogflow auto-selects a model based on other
+        #     parameters in the SpeechToTextConfig and Agent settings.
+        #     If enhanced speech model is enabled for the agent and an enhanced
+        #     version of the specified model for the language does not exist, then the
+        #     speech is recognized using the standard version of the specified model.
         #     Refer to
         #     [Cloud Speech API
         #     documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model)
         #     for more details.
+        #     If you specify a model, the following models typically have the best
+        #     performance:
+        #
+        #     - phone_call (best for Agent Assist and telephony)
+        #     - latest_short (best for Dialogflow non-telephony)
+        #     - command_and_search
+        #
+        #     Leave this field unspecified to use
+        #     [Agent Speech
+        #     settings](https://cloud.google.com/dialogflow/cx/docs/concept/agent#settings-speech)
+        #     for model selection.
         # @!attribute [rw] use_timeout_based_endpointing
         #   @return [::Boolean]
         #     Use timeout based endpointing, interpreting endpointer sensitivy as

data/proto_docs/google/cloud/dialogflow/v2/conversation.rb

@@ -479,6 +479,9 @@ module Google
         #   @return [::Array<::Google::Cloud::Dialogflow::V2::SearchKnowledgeAnswer>]
         #     Most relevant snippets extracted from articles in the given knowledge base,
         #     ordered by confidence.
+        # @!attribute [rw] rewritten_query
+        #   @return [::String]
+        #     The rewritten query used to search knowledge.
         class SearchKnowledgeResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -524,11 +527,14 @@ module Google
             # The answer has a unspecified type.
             ANSWER_TYPE_UNSPECIFIED = 0
 
-            # The answer is from FAQ doucments.
+            # The answer is from FAQ documents.
             FAQ = 1
 
             # The answer is from generative model.
             GENERATIVE = 2
+
+            # The answer is from intent matching.
+            INTENT = 3
           end
         end
       end

data/proto_docs/google/cloud/dialogflow/v2/conversation_profile.rb

@@ -198,10 +198,10 @@ module Google
         #     is used.
         # @!attribute [rw] session_ttl
         #   @return [::Google::Protobuf::Duration]
-        #     Optional. Sets Dialogflow CX session life time.
+        #     Optional. Configure lifetime of the Dialogflow session.
         #     By default, a Dialogflow CX session remains active and its data is stored
-        #     for 30 minutes after the last request is sent for the session. This value
-        #     should be no longer than 1 day.
+        #     for 30 minutes after the last request is sent for the session.
+        #     This value should be no longer than 1 day.
         class AutomatedAgentConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -257,6 +257,10 @@ module Google
           #     can prevent those queries from being stored at answer records.
           #
           #     Supported features: KNOWLEDGE_SEARCH.
+          # @!attribute [rw] enable_conversation_augmented_query
+          #   @return [::Boolean]
+          #     Optional. Enable including conversation context during query answer
+          #     generation. Supported features: KNOWLEDGE_SEARCH.
           # @!attribute [rw] suggestion_trigger_settings
           #   @return [::Google::Cloud::Dialogflow::V2::HumanAgentAssistantConfig::SuggestionTriggerSettings]
           #     Settings of suggestion trigger.
@@ -340,6 +344,10 @@ module Google
           #   @return [::Google::Cloud::Dialogflow::V2::HumanAgentAssistantConfig::SuggestionQueryConfig::ContextFilterSettings]
           #     Determines how recent conversation context is filtered when generating
           #     suggestions. If unspecified, no messages will be dropped.
+          # @!attribute [rw] sections
+          #   @return [::Google::Cloud::Dialogflow::V2::HumanAgentAssistantConfig::SuggestionQueryConfig::Sections]
+          #     Optional. The customized sections chosen to return when requesting a
+          #     summary of a conversation.
           class SuggestionQueryConfig
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -417,6 +425,57 @@ module Google
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
+
+            # Custom sections to return when requesting a summary of a conversation.
+            # This is only supported when `baseline_model_version` == '2.0'.
+            #
+            # Supported features: CONVERSATION_SUMMARIZATION,
+            # CONVERSATION_SUMMARIZATION_VOICE.
+            # @!attribute [rw] section_types
+            #   @return [::Array<::Google::Cloud::Dialogflow::V2::HumanAgentAssistantConfig::SuggestionQueryConfig::Sections::SectionType>]
+            #     The selected sections chosen to return when requesting a summary of a
+            #     conversation. A duplicate selected section will be treated as a single
+            #     selected section. If section types are not provided, the default will
+            #     be \\{SITUATION, ACTION, RESULT}.
+            class Sections
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # Selectable sections to return when requesting a summary of a
+              # conversation.
+              module SectionType
+                # Undefined section type, does not return anything.
+                SECTION_TYPE_UNSPECIFIED = 0
+
+                # What the customer needs help with or has question about.
+                # Section name: "situation".
+                SITUATION = 1
+
+                # What the agent does to help the customer.
+                # Section name: "action".
+                ACTION = 2
+
+                # Result of the customer service. A single word describing the result
+                # of the conversation.
+                # Section name: "resolution".
+                RESOLUTION = 3
+
+                # Reason for cancellation if the customer requests for a cancellation.
+                # "N/A" otherwise.
+                # Section name: "reason_for_cancellation".
+                REASON_FOR_CANCELLATION = 4
+
+                # "Unsatisfied" or "Satisfied" depending on the customer's feelings at
+                # the end of the conversation.
+                # Section name: "customer_satisfaction".
+                CUSTOMER_SATISFACTION = 5
+
+                # Key entities extracted from the conversation, such as ticket number,
+                # order number, dollar amount, etc.
+                # Section names are prefixed by "entities/".
+                ENTITIES = 6
+              end
+            end
           end
 
           # Custom conversation models used in agent assist feature.

data/proto_docs/google/cloud/dialogflow/v2/fulfillment.rb

@@ -83,6 +83,7 @@ module Google
           #     Optional. The HTTP request headers to send together with fulfillment
           #     requests.
           # @!attribute [rw] is_cloud_function
+          #   @deprecated This field is deprecated and may be removed in the next major version update.
           #   @return [::Boolean]
           #     Optional. Indicates if generic web service is created through Cloud
           #     Functions integration. Defaults to false.

data/proto_docs/google/cloud/dialogflow/v2/session.rb

@@ -382,6 +382,7 @@ module Google
         #
         #     3. an event that specifies which intent to trigger.
         # @!attribute [rw] single_utterance
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Boolean]
         #     Please use
         #     {::Google::Cloud::Dialogflow::V2::InputAudioConfig#single_utterance InputAudioConfig.single_utterance}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-dialogflow-v2
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.32.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-03 00:00:00.000000000 Z
+date: 2024-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.20.0
+        version: 0.21.1
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.20.0
+        version: 0.21.1
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -50,7 +50,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: '0.7'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -60,7 +60,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: '0.7'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -427,7 +427,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.3
 signing_key: 
 specification_version: 4
 summary: Builds conversational interfaces (for example, chatbots, and voice-powered