google-cloud-dialogflow-v2 1.15.0 → 1.16.1

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

@@ -29,6 +29,18 @@ module Google
         # @!attribute [rw] confirmation_requirement
         #   @return [::Google::Cloud::Dialogflow::V2::Tool::ConfirmationRequirement]
         #     Optional. Indicates whether the app requires human confirmation.
+        # @!attribute [rw] proactive_enabled
+        #   @return [::Boolean]
+        #     Optional. Only applicable for CompanionAgent.
+        #     Indicates whether the ces app is enabled in proactive mode.
+        #     At least one of `proactive_enabled` or `reactive_enabled` should be
+        #     true; otherwise, the ces app will be ignored.
+        # @!attribute [rw] reactive_enabled
+        #   @return [::Boolean]
+        #     Optional. Only applicable for CompanionAgent.
+        #     Indicates whether the ces app is enabled in reactive mode.
+        #     At least one of `proactive_enabled` or `reactive_enabled` should be
+        #     true; otherwise, the ces app will be ignored.
         class CesAppSpec
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -1112,6 +1112,12 @@ module Google
 
             # The answer is from intent matching.
             INTENT = 3
+
+            # The answer is from Playbook.
+            PLAYBOOK = 4
+
+            # The answer is from event.
+            EVENT = 5
           end
         end
 

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

@@ -79,6 +79,9 @@ module Google
         #     languages.
         #     This should be a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
         #     language tag. Example: "en-US".
+        # @!attribute [rw] sip_config
+        #   @return [::Google::Cloud::Dialogflow::V2::SipConfig]
+        #     Optional. Configuration for SIP connections.
         # @!attribute [rw] time_zone
         #   @return [::String]
         #     The time zone of this conversational profile from the
@@ -295,6 +298,20 @@ module Google
           #   @return [::Google::Cloud::Dialogflow::V2::RaiSettings]
           #     Optional. Settings for Responsible AI checks.
           #     Supported features:  KNOWLEDGE_ASSIST
+          # @!attribute [rw] suggestion_trigger_event
+          #   @return [::Google::Cloud::Dialogflow::V2::TriggerEvent]
+          #     Optional. The trigger event for suggestion.
+          #     If unspecified, it will be `CUSTOMER_MESSAGE`.
+          #     Supported features: KNOWLEDGE_ASSIST
+          #     For KNOWLEDGE_ASSIST, these four trigger events are supported:
+          #     1. TRIGGER_EVENT_UNSPECIFIED
+          #     2. END_OF_UTTERANCE
+          #     3. CUSTOMER_MESSAGE
+          #     4. AGENT_MESSAGE
+          # @!attribute [rw] disable_query_search_context
+          #   @return [::Boolean]
+          #     Optional. If true, disable appending available search context to the
+          #     search query. Supported features: KNOWLEDGE_ASSIST
           # @!attribute [rw] suggestion_trigger_settings
           #   @return [::Google::Cloud::Dialogflow::V2::HumanAgentAssistantConfig::SuggestionTriggerSettings]
           #     Settings of suggestion trigger.
@@ -749,6 +766,39 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Defines the SIP configuration.
+        # @!attribute [rw] create_conversation_on_the_fly
+        #   @return [::Boolean]
+        #     Asks Dialogflow Telephony to create the conversation provided in the SIP
+        #     header on the fly when the call comes in.
+        # @!attribute [rw] inactive_start
+        #   @return [::Boolean]
+        #     Starts the conversation with inactive SDP directives
+        # @!attribute [rw] max_audio_recording_duration
+        #   @return [::Google::Protobuf::Duration]
+        #     Max duration for audio recording.
+        #     Overrides the default value of 15 min.
+        #     Max value is 8 hours.
+        # @!attribute [rw] allow_virtual_agent_interaction
+        #   @return [::Boolean]
+        #     Allows interactions with a Dialogflow virtual agent even if the call is
+        #     connected for SIPREC purposes.
+        # @!attribute [rw] keep_conversation_running
+        #   @return [::Boolean]
+        #     Keeps the conversation running even if the call is disconnected.
+        # @!attribute [rw] copy_inbound_call_leg_headers
+        #   @return [::Array<::String>]
+        #     List of inbound call leg headers to be copied to outbound call legs created
+        #     later.
+        # @!attribute [rw] ignore_reinvite_media_direction
+        #   @return [::Boolean]
+        #     Ignores any media direction in the reINVITE SDP offer. Reuse the previous
+        #     media direction.
+        class SipConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The type of Human Agent Assistant API suggestion to perform, and the maximum
         # number of results to return for that type. Multiple `Feature` objects can
         # be specified in the `features` list.

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

@@ -50,9 +50,9 @@ module Google
         #        Dialogflow adds the obfuscated user id with the participant.
         #
         #     2. If you set this field in
-        #        {::Google::Cloud::Dialogflow::V2::AnalyzeContentRequest#participant AnalyzeContent}
-        #        or
-        #        {::Google::Cloud::Dialogflow::V2::StreamingAnalyzeContentRequest#participant StreamingAnalyzeContent},
+        #        [AnalyzeContent][google.cloud.dialogflow.v2.AnalyzeContentRequest.obfuscated_external_user_id]
+        #        or [StreamingAnalyzeContent]
+        #        [google.cloud.dialogflow.v2.StreamingAnalyzeContentRequest.obfuscated_external_user_id],
         #        Dialogflow will update
         #        {::Google::Cloud::Dialogflow::V2::Participant#obfuscated_external_user_id Participant.obfuscated_external_user_id}.
         #
@@ -64,6 +64,11 @@ module Google
         #     example, Dialogflow determines whether a user in one conversation returned
         #     in a later conversation.
         #
+        #     Additionally, to link an escalated Virtual Agent conversation
+        #     with its corresponding Agent Assist conversation for analytics, this field
+        #     in Agent Assist conversations should be populated to indicate the user id
+        #     of the `END_USER` participant in the escalated conversation.
+        #
         #     Note:
         #
         #     * Please never pass raw user ids to Dialogflow. Always obfuscate your user
@@ -542,8 +547,11 @@ module Google
         #
         # 1.  If the input was set to streaming audio, the first one or more messages
         #     contain `recognition_result`. Each `recognition_result` represents a more
-        #     complete transcript of what the user said. The last `recognition_result`
-        #     has `is_final` set to `true`.
+        #     complete transcript of what the user said. When a user speaks multiple
+        #     sentences, the API will emit multiple messages where `is_final = true`.
+        #     Each time the system detects a distinct pause or completed thought, it
+        #     locks in that segment, marks it `is_final = true`, and then immediately
+        #     starts a new recognition cycle for the next sentence on the same stream.
         #
         # 2.  In virtual agent stage: if `enable_partial_automated_agent_reply` is
         #     true, the following N (currently 1 <= N <= 4) messages
@@ -1237,6 +1245,11 @@ module Google
         #     to compile the suggestion. It may be smaller than the
         #     {::Google::Cloud::Dialogflow::V2::SuggestKnowledgeAssistRequest#context_size SuggestKnowledgeAssistRequest.context_size}
         #     field in the request if there are fewer messages in the conversation.
+        # @!attribute [rw] additional_suggested_query_results
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::KnowledgeAssistAnswer::AdditionalSuggestedQueryResult>]
+        #     Optional. The list of additional suggested queries based on the context.
+        #     This is used for the cases when we want to generate multiple queries
+        #     for a single request.
         class SuggestKnowledgeAssistResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1344,6 +1357,12 @@ module Google
         # @!attribute [rw] service_latency
         #   @return [::Google::Cloud::Dialogflow::V2::ServiceLatency]
         #     The latency of the service.
+        # @!attribute [rw] query_generation_debug_info
+        #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeAssistDebugInfo::QueryGenerationDebugInfo]
+        #     Token usage metadata for query generation.
+        # @!attribute [rw] ces_debug_info
+        #   @return [::Google::Protobuf::Struct]
+        #     Debug information from CES runtime API.
         class KnowledgeAssistDebugInfo
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1412,6 +1431,21 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # Token usage metadata for query generation.
+          # @!attribute [rw] prompt_token_count
+          #   @return [::Integer]
+          #     The total number of tokens in the prompt.
+          # @!attribute [rw] candidates_token_count
+          #   @return [::Integer]
+          #     The total number of tokens in the generated candidates.
+          # @!attribute [rw] total_token_count
+          #   @return [::Integer]
+          #     The total number of tokens for the entire request.
+          class QueryGenerationDebugInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Reason for query generation failure.
           module QueryGenerationFailureReason
             # Default value.
@@ -1496,9 +1530,44 @@ module Google
           # @!attribute [rw] query_text
           #   @return [::String]
           #     Suggested query text.
+          # @!attribute [rw] search_contexts
+          #   @return [::Array<::Google::Cloud::Dialogflow::V2::KnowledgeAssistAnswer::SuggestedQuery::SearchContext>]
+          #     Optional. The search contexts for the query.
           class SuggestedQuery
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Search context is information useful for knowledge search that helps
+            # enrich the query.
+            # Example:
+            # search_context {
+            #   key: "application name"
+            #   value: "DesignApp"
+            # }
+            # @!attribute [rw] key
+            #   @return [::String]
+            #     Optional. The key of the search context, e.g. "application name".
+            # @!attribute [rw] value
+            #   @return [::String]
+            #     Optional. The value of the search context, e.g. "DesignApp".
+            class SearchContext
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+          end
+
+          # Represents a single suggested query result.
+          # @!attribute [r] suggested_query
+          #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeAssistAnswer::SuggestedQuery]
+          #     Output only. The suggested query based on the context.
+          # @!attribute [r] answer_record
+          #   @return [::String]
+          #     Output only. The name of the answer record.
+          #     Format: `projects/<Project ID>/locations/<Location
+          #     ID>/answerRecords/<Answer Record ID>`
+          class AdditionalSuggestedQueryResult
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
           # Represents an answer from Knowledge. Currently supports FAQ and Generative
@@ -1510,12 +1579,22 @@ module Google
           #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeAssistAnswer::KnowledgeAnswer::FaqSource]
           #     Populated if the prediction came from FAQ.
           #
-          #     Note: The following fields are mutually exclusive: `faq_source`, `generative_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `faq_source`, `generative_source`, `playbook_source`, `event_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] generative_source
           #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeAssistAnswer::KnowledgeAnswer::GenerativeSource]
           #     Populated if the prediction was Generative.
           #
-          #     Note: The following fields are mutually exclusive: `generative_source`, `faq_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `generative_source`, `faq_source`, `playbook_source`, `event_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] playbook_source
+          #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeAssistAnswer::KnowledgeAnswer::GenerativeSource]
+          #     Populated if the prediction was from Playbook.
+          #
+          #     Note: The following fields are mutually exclusive: `playbook_source`, `faq_source`, `generative_source`, `event_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] event_source
+          #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeAssistAnswer::KnowledgeAnswer::EventSource]
+          #     Populated if the prediction was from an event.
+          #
+          #     Note: The following fields are mutually exclusive: `event_source`, `faq_source`, `generative_source`, `playbook_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class KnowledgeAnswer
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1556,6 +1635,18 @@ module Google
                 extend ::Google::Protobuf::MessageExts::ClassMethods
               end
             end
+
+            # Details about source of Event answer.
+            # @!attribute [rw] event
+            #   @return [::String]
+            #     Name of the triggered event.
+            # @!attribute [rw] snippets
+            #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeAssistAnswer::KnowledgeAnswer::GenerativeSource]
+            #     Sources used in event fulfillment.
+            class EventSource
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
         end
 

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

@@ -571,19 +571,22 @@ module Google
         # finalized transcript values received for the series of results.
         #
         # In the following example, single utterance is enabled. In the case where
-        # single utterance is not enabled, result 7 would not occur.
+        # single utterance is not enabled, result 8 would not occur.
         #
         # ```
-        # Num | transcript              | message_type            | is_final
-        # --- | ----------------------- | ----------------------- | --------
-        # 1   | "tube"                  | TRANSCRIPT              | false
-        # 2   | "to be a"               | TRANSCRIPT              | false
-        # 3   | "to be"                 | TRANSCRIPT              | false
-        # 4   | "to be or not to be"    | TRANSCRIPT              | true
-        # 5   | "that's"                | TRANSCRIPT              | false
-        # 6   | "that is                | TRANSCRIPT              | false
-        # 7   | unset                   | END_OF_SINGLE_UTTERANCE | unset
-        # 8   | " that is the question" | TRANSCRIPT              | true
+        # Num | transcript               | message_type            | is_final
+        # --- | ------------------------ | ----------------------- | --------
+        # 1   | "tube"                   | TRANSCRIPT              | false
+        # 2   | "to be a"                | TRANSCRIPT              | false
+        # 3   | "to be"                  | TRANSCRIPT              | false
+        # 4   | "to be or not to be"     | TRANSCRIPT              | true
+        # 5   | "that's"                 | TRANSCRIPT              | false
+        # 6   | "that is                 | TRANSCRIPT              | false
+        # 7   | " that is the question"  | TRANSCRIPT              | true
+        # 8   | unset                    | END_OF_SINGLE_UTTERANCE | unset
+        # 9   | ". Whether 'tis nobler"  | TRANSCRIPT              | true
+        # 10  | " in the mind"           | TRANSCRIPT              | false
+        # 11  | " in the mind to suffer" | TRANSCRIPT              | true
         # ```
         #
         # Concatenating the finalized transcripts with `is_final` set to true,

data/proto_docs/google/type/latlng.rb

@@ -21,9 +21,9 @@ module Google
   module Type
     # An object that represents a latitude/longitude pair. This is expressed as a
     # pair of doubles to represent degrees latitude and degrees longitude. Unless
-    # specified otherwise, this must conform to the
-    # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
-    # standard</a>. Values must be within normalized ranges.
+    # specified otherwise, this object must conform to the
+    # <a href="https://en.wikipedia.org/wiki/World_Geodetic_System#1984_version">
+    # WGS84 standard</a>. Values must be within normalized ranges.
     # @!attribute [rw] latitude
     #   @return [::Float]
     #     The latitude in degrees. It must be in the range [-90.0, +90.0].

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-dialogflow-v2
 version: !ruby/object:Gem::Version
-  version: 1.15.0
+  version: 1.16.1
 platform: ruby
 authors:
 - Google LLC
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement