google-cloud-dialogflow-v2 0.6.4 → 0.10.0

data/lib/google/cloud/dialogflow/v2/fulfillments/credentials.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "googleauth"
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        module Fulfillments
+          # Credentials for the Fulfillments API.
+          class Credentials < ::Google::Auth::Credentials
+            self.scope = [
+              "https://www.googleapis.com/auth/cloud-platform",
+              "https://www.googleapis.com/auth/dialogflow"
+            ]
+            self.env_vars = [
+              "DIALOGFLOW_CREDENTIALS",
+              "DIALOGFLOW_KEYFILE",
+              "GOOGLE_CLOUD_CREDENTIALS",
+              "GOOGLE_CLOUD_KEYFILE",
+              "GCLOUD_KEYFILE",
+              "DIALOGFLOW_CREDENTIALS_JSON",
+              "DIALOGFLOW_KEYFILE_JSON",
+              "GOOGLE_CLOUD_CREDENTIALS_JSON",
+              "GOOGLE_CLOUD_KEYFILE_JSON",
+              "GCLOUD_KEYFILE_JSON"
+            ]
+            self.paths = [
+              "~/.config/google_cloud/application_default_credentials.json"
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/dialogflow/v2/fulfillments/paths.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        module Fulfillments
+          # Path helper methods for the Fulfillments API.
+          module Paths
+            ##
+            # Create a fully-qualified Fulfillment resource string.
+            #
+            # @overload fulfillment_path(project:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/agent/fulfillment`
+            #
+            #   @param project [String]
+            #
+            # @overload fulfillment_path(project:, location:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/agent/fulfillment`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #
+            # @return [::String]
+            def fulfillment_path **args
+              resources = {
+                "project" => (proc do |project:|
+                  "projects/#{project}/agent/fulfillment"
+                end),
+                "location:project" => (proc do |project:, location:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/agent/fulfillment"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/dialogflow/v2/gcs_pb.rb

@@ -0,0 +1,20 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dialogflow/v2/gcs.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/dialogflow/v2/gcs.proto", :syntax => :proto3) do
+  end
+end
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+      end
+    end
+  end
+end

data/lib/google/cloud/dialogflow/v2/human_agent_assistant_event_pb.rb

@@ -0,0 +1,26 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dialogflow/v2/human_agent_assistant_event.proto
+
+require 'google/protobuf'
+
+require 'google/cloud/dialogflow/v2/participant_pb'
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/dialogflow/v2/human_agent_assistant_event.proto", :syntax => :proto3) do
+    add_message "google.cloud.dialogflow.v2.HumanAgentAssistantEvent" do
+      optional :conversation, :string, 1
+      optional :participant, :string, 3
+      repeated :suggestion_results, :message, 5, "google.cloud.dialogflow.v2.SuggestionResult"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        HumanAgentAssistantEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.dialogflow.v2.HumanAgentAssistantEvent").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/dialogflow/v2/intent_pb.rb

@@ -23,6 +23,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :priority, :int32, 3
       optional :is_fallback, :bool, 4
       optional :ml_disabled, :bool, 19
+      optional :live_agent_handoff, :bool, 20
+      optional :end_interaction, :bool, 21
       repeated :input_context_names, :string, 7
       repeated :events, :string, 8
       repeated :training_phrases, :message, 9, "google.cloud.dialogflow.v2.Intent.TrainingPhrase"

data/lib/google/cloud/dialogflow/v2/intent_services_pb.rb

@@ -24,64 +24,51 @@ module Google
     module Dialogflow
       module V2
         module Intents
-          # An intent represents a mapping between input from a user and an action to
-          # be taken by your application. When you pass user input to the
-          # [DetectIntent][google.cloud.dialogflow.v2.Sessions.DetectIntent] (or
-          # [StreamingDetectIntent][google.cloud.dialogflow.v2.Sessions.StreamingDetectIntent]) method, the
-          # Dialogflow API analyzes the input and searches
-          # for a matching intent. If no match is found, the Dialogflow API returns a
-          # fallback intent (`is_fallback` = true).
-          #
-          # You can provide additional information for the Dialogflow API to use to
-          # match user input to an intent by adding the following to your intent.
-          #
-          # *   **Contexts** - provide additional context for intent analysis. For
-          #     example, if an intent is related to an object in your application that
-          #     plays music, you can provide a context to determine when to match the
-          #     intent if the user input is "turn it off". You can include a context
-          #     that matches the intent when there is previous user input of
-          #     "play music", and not when there is previous user input of
-          #     "turn on the light".
-          #
-          # *   **Events** - allow for matching an intent by using an event name
-          #     instead of user input. Your application can provide an event name and
-          #     related parameters to the Dialogflow API to match an intent. For
-          #     example, when your application starts, you can send a welcome event
-          #     with a user name parameter to the Dialogflow API to match an intent with
-          #     a personalized welcome message for the user.
-          #
-          # *   **Training phrases** - provide examples of user input to train the
-          #     Dialogflow API agent to better match intents.
-          #
-          # For more information about intents, see the
-          # [Dialogflow
-          # documentation](https://cloud.google.com/dialogflow/docs/intents-overview).
+          # Service for managing [Intents][google.cloud.dialogflow.v2.Intent].
           class Service
 
-            include GRPC::GenericService
+            include ::GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode
             self.service_name = 'google.cloud.dialogflow.v2.Intents'
 
             # Returns the list of all intents in the specified agent.
-            rpc :ListIntents, ListIntentsRequest, ListIntentsResponse
+            rpc :ListIntents, ::Google::Cloud::Dialogflow::V2::ListIntentsRequest, ::Google::Cloud::Dialogflow::V2::ListIntentsResponse
             # Retrieves the specified intent.
-            rpc :GetIntent, GetIntentRequest, Intent
+            rpc :GetIntent, ::Google::Cloud::Dialogflow::V2::GetIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # Creates an intent in the specified agent.
-            rpc :CreateIntent, CreateIntentRequest, Intent
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            rpc :CreateIntent, ::Google::Cloud::Dialogflow::V2::CreateIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # Updates the specified intent.
-            rpc :UpdateIntent, UpdateIntentRequest, Intent
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            rpc :UpdateIntent, ::Google::Cloud::Dialogflow::V2::UpdateIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # Deletes the specified intent and its direct or indirect followup intents.
-            rpc :DeleteIntent, DeleteIntentRequest, Google::Protobuf::Empty
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            rpc :DeleteIntent, ::Google::Cloud::Dialogflow::V2::DeleteIntentRequest, ::Google::Protobuf::Empty
             # Updates/Creates multiple intents in the specified agent.
             #
-            # Operation <response: [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>
-            rpc :BatchUpdateIntents, BatchUpdateIntentsRequest, Google::Longrunning::Operation
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            rpc :BatchUpdateIntents, ::Google::Cloud::Dialogflow::V2::BatchUpdateIntentsRequest, ::Google::Longrunning::Operation
             # Deletes intents in the specified agent.
             #
-            # Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
-            rpc :BatchDeleteIntents, BatchDeleteIntentsRequest, Google::Longrunning::Operation
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            rpc :BatchDeleteIntents, ::Google::Cloud::Dialogflow::V2::BatchDeleteIntentsRequest, ::Google::Longrunning::Operation
           end
 
           Stub = Service.rpc_stub_class

data/lib/google/cloud/dialogflow/v2/intents.rb

@@ -32,38 +32,7 @@ module Google
     module Dialogflow
       module V2
         ##
-        # An intent represents a mapping between input from a user and an action to
-        # be taken by your application. When you pass user input to the
-        # {::Google::Cloud::Dialogflow::V2::Sessions::Client#detect_intent DetectIntent} (or
-        # {::Google::Cloud::Dialogflow::V2::Sessions::Client#streaming_detect_intent StreamingDetectIntent}) method, the
-        # Dialogflow API analyzes the input and searches
-        # for a matching intent. If no match is found, the Dialogflow API returns a
-        # fallback intent (`is_fallback` = true).
-        #
-        # You can provide additional information for the Dialogflow API to use to
-        # match user input to an intent by adding the following to your intent.
-        #
-        # *   **Contexts** - provide additional context for intent analysis. For
-        #     example, if an intent is related to an object in your application that
-        #     plays music, you can provide a context to determine when to match the
-        #     intent if the user input is "turn it off". You can include a context
-        #     that matches the intent when there is previous user input of
-        #     "play music", and not when there is previous user input of
-        #     "turn on the light".
-        #
-        # *   **Events** - allow for matching an intent by using an event name
-        #     instead of user input. Your application can provide an event name and
-        #     related parameters to the Dialogflow API to match an intent. For
-        #     example, when your application starts, you can send a welcome event
-        #     with a user name parameter to the Dialogflow API to match an intent with
-        #     a personalized welcome message for the user.
-        #
-        # *   **Training phrases** - provide examples of user input to train the
-        #     Dialogflow API agent to better match intents.
-        #
-        # For more information about intents, see the
-        # [Dialogflow
-        # documentation](https://cloud.google.com/dialogflow/docs/intents-overview).
+        # Service for managing {::Google::Cloud::Dialogflow::V2::Intent Intents}.
         #
         # To load this service and instantiate a client:
         #

data/lib/google/cloud/dialogflow/v2/intents/client.rb

@@ -27,38 +27,7 @@ module Google
           ##
           # Client for the Intents service.
           #
-          # An intent represents a mapping between input from a user and an action to
-          # be taken by your application. When you pass user input to the
-          # {::Google::Cloud::Dialogflow::V2::Sessions::Client#detect_intent DetectIntent} (or
-          # {::Google::Cloud::Dialogflow::V2::Sessions::Client#streaming_detect_intent StreamingDetectIntent}) method, the
-          # Dialogflow API analyzes the input and searches
-          # for a matching intent. If no match is found, the Dialogflow API returns a
-          # fallback intent (`is_fallback` = true).
-          #
-          # You can provide additional information for the Dialogflow API to use to
-          # match user input to an intent by adding the following to your intent.
-          #
-          # *   **Contexts** - provide additional context for intent analysis. For
-          #     example, if an intent is related to an object in your application that
-          #     plays music, you can provide a context to determine when to match the
-          #     intent if the user input is "turn it off". You can include a context
-          #     that matches the intent when there is previous user input of
-          #     "play music", and not when there is previous user input of
-          #     "turn on the light".
-          #
-          # *   **Events** - allow for matching an intent by using an event name
-          #     instead of user input. Your application can provide an event name and
-          #     related parameters to the Dialogflow API to match an intent. For
-          #     example, when your application starts, you can send a welcome event
-          #     with a user name parameter to the Dialogflow API to match an intent with
-          #     a personalized welcome message for the user.
-          #
-          # *   **Training phrases** - provide examples of user input to train the
-          #     Dialogflow API agent to better match intents.
-          #
-          # For more information about intents, see the
-          # [Dialogflow
-          # documentation](https://cloud.google.com/dialogflow/docs/intents-overview).
+          # Service for managing {::Google::Cloud::Dialogflow::V2::Intent Intents}.
           #
           class Client
             include Paths
@@ -91,7 +60,7 @@ module Google
                 parent_config = while namespace.any?
                                   parent_name = namespace.join "::"
                                   parent_const = const_get parent_name
-                                  break parent_const.configure if parent_const&.respond_to? :configure
+                                  break parent_const.configure if parent_const.respond_to? :configure
                                   namespace.pop
                                 end
                 default_config = Client::Configuration.new parent_config
@@ -99,9 +68,9 @@ module Google
                 default_config.timeout = 60.0
                 default_config.retry_policy = {
                   initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE"]
+                max_delay: 60.0,
+                multiplier: 1.3,
+                retry_codes: [14]
                 }
 
                 default_config
@@ -165,7 +134,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              credentials ||= Credentials.default scope: @config.scope
+              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # but only if the default endpoint does not have a region prefix.
+              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                       @config.endpoint == Client.configure.endpoint &&
+                                       !@config.endpoint.split(".").first.include?("-")
+              credentials ||= Credentials.default scope: @config.scope,
+                                                  enable_self_signed_jwt: enable_self_signed_jwt
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
@@ -215,7 +190,15 @@ module Google
             #
             #   @param parent [::String]
             #     Required. The agent to list all intents from.
-            #     Format: `projects/<Project ID>/agent`.
+            #     Format: `projects/<Project ID>/agent` or `projects/<Project
+            #     ID>/locations/<Location ID>/agent`.
+            #
+            #     Alternatively, you can specify the environment to list intents for.
+            #     Format: `projects/<Project ID>/agent/environments/<Environment ID>`
+            #     or `projects/<Project ID>/locations/<Location
+            #     ID>/agent/environments/<Environment ID>`.
+            #     Note: training phrases of the intents will not be returned for non-draft
+            #     environment.
             #   @param language_code [::String]
             #     Optional. The language used to access language-specific data.
             #     If not specified, the agent's default language is used.
@@ -354,6 +337,10 @@ module Google
             ##
             # Creates an intent in the specified agent.
             #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            #
             # @overload create_intent(request, options = nil)
             #   Pass arguments to `create_intent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::CreateIntentRequest} or an equivalent Hash.
@@ -431,6 +418,10 @@ module Google
             ##
             # Updates the specified intent.
             #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            #
             # @overload update_intent(request, options = nil)
             #   Pass arguments to `update_intent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::UpdateIntentRequest} or an equivalent Hash.
@@ -507,6 +498,10 @@ module Google
             ##
             # Deletes the specified intent and its direct or indirect followup intents.
             #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+            #
             # @overload delete_intent(request, options = nil)
             #   Pass arguments to `delete_intent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::DeleteIntentRequest} or an equivalent Hash.
@@ -575,7 +570,10 @@ module Google
             ##
             # Updates/Creates multiple intents in the specified agent.
             #
-            # Operation <response: {::Google::Cloud::Dialogflow::V2::BatchUpdateIntentsResponse BatchUpdateIntentsResponse}>
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             #
             # @overload batch_update_intents(request, options = nil)
             #   Pass arguments to `batch_update_intents` via a request object, either of type
@@ -661,7 +659,10 @@ module Google
             ##
             # Deletes intents in the specified agent.
             #
-            # Operation <response: {::Google::Protobuf::Empty google.protobuf.Empty}>
+            #
+            # Note: You should always train an agent prior to sending it queries. See the
+            # [training
+            # documentation](https://cloud.google.com/dialogflow/es/docs/training).
             #
             # @overload batch_delete_intents(request, options = nil)
             #   Pass arguments to `batch_delete_intents` via a request object, either of type
@@ -816,14 +817,14 @@ module Google
 
               config_attr :endpoint,      "dialogflow.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
               config_attr :scope,         nil, ::String, ::Array, nil
               config_attr :lib_name,      nil, ::String, nil
               config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
               config_attr :interceptors,  nil, ::Array, nil
               config_attr :timeout,       nil, ::Numeric, nil
               config_attr :metadata,      nil, ::Hash, nil
@@ -844,7 +845,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -856,7 +857,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:
@@ -905,19 +906,19 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
-                  list_intents_config = parent_rpcs&.list_intents if parent_rpcs&.respond_to? :list_intents
+                  list_intents_config = parent_rpcs.list_intents if parent_rpcs.respond_to? :list_intents
                   @list_intents = ::Gapic::Config::Method.new list_intents_config
-                  get_intent_config = parent_rpcs&.get_intent if parent_rpcs&.respond_to? :get_intent
+                  get_intent_config = parent_rpcs.get_intent if parent_rpcs.respond_to? :get_intent
                   @get_intent = ::Gapic::Config::Method.new get_intent_config
-                  create_intent_config = parent_rpcs&.create_intent if parent_rpcs&.respond_to? :create_intent
+                  create_intent_config = parent_rpcs.create_intent if parent_rpcs.respond_to? :create_intent
                   @create_intent = ::Gapic::Config::Method.new create_intent_config
-                  update_intent_config = parent_rpcs&.update_intent if parent_rpcs&.respond_to? :update_intent
+                  update_intent_config = parent_rpcs.update_intent if parent_rpcs.respond_to? :update_intent
                   @update_intent = ::Gapic::Config::Method.new update_intent_config
-                  delete_intent_config = parent_rpcs&.delete_intent if parent_rpcs&.respond_to? :delete_intent
+                  delete_intent_config = parent_rpcs.delete_intent if parent_rpcs.respond_to? :delete_intent
                   @delete_intent = ::Gapic::Config::Method.new delete_intent_config
-                  batch_update_intents_config = parent_rpcs&.batch_update_intents if parent_rpcs&.respond_to? :batch_update_intents
+                  batch_update_intents_config = parent_rpcs.batch_update_intents if parent_rpcs.respond_to? :batch_update_intents
                   @batch_update_intents = ::Gapic::Config::Method.new batch_update_intents_config
-                  batch_delete_intents_config = parent_rpcs&.batch_delete_intents if parent_rpcs&.respond_to? :batch_delete_intents
+                  batch_delete_intents_config = parent_rpcs.batch_delete_intents if parent_rpcs.respond_to? :batch_delete_intents
                   @batch_delete_intents = ::Gapic::Config::Method.new batch_delete_intents_config
 
                   yield self if block_given?