google-cloud-dialogflow 0.4.0 → 0.5.0

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

@@ -48,7 +48,7 @@ module Google
         # You can create an agent using both Dialogflow Standard Edition and
         # Dialogflow Enterprise Edition. For details, see
         # [Dialogflow
-        # Editions](https://cloud.google.com/dialogflow-enterprise/docs/editions).
+        # Editions](https://cloud.google.com/dialogflow/docs/editions).
         #
         # You can save your agent for backup or versioning by exporting the agent by
         # using the {Google::Cloud::Dialogflow::V2::Agents::ExportAgent ExportAgent} method. You can import a saved
@@ -56,13 +56,13 @@ module Google
         #
         # Dialogflow provides several
         # [prebuilt
-        # agents](https://cloud.google.com/dialogflow-enterprise/docs/agents-prebuilt)
+        # agents](https://cloud.google.com/dialogflow/docs/agents-prebuilt)
         # for common conversation scenarios such as determining a date and time,
         # converting currency, and so on.
         #
         # For more information about agents, see the
         # [Dialogflow
-        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/agents-overview).
+        # documentation](https://cloud.google.com/dialogflow/docs/agents-overview).
         #
         # @!attribute [r] agents_stub
         #   @return [Google::Cloud::Dialogflow::V2::Agents::Stub]
@@ -144,6 +144,10 @@ module Google
           #   The default timeout, in seconds, for calls made through this client.
           # @param metadata [Hash]
           #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param service_address [String]
+          #   Override for the service hostname, or `nil` to leave as the default.
+          # @param service_port [Integer]
+          #   Override for the service port, or `nil` to leave as the default.
           # @param exception_transformer [Proc]
           #   An optional proc that intercepts any exceptions raised during an API call to inject
           #   custom error handling.
@@ -153,6 +157,8 @@ module Google
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
               metadata: nil,
+              service_address: nil,
+              service_port: nil,
               exception_transformer: nil,
               lib_name: nil,
               lib_version: ""
@@ -170,7 +176,10 @@ module Google
               client_config: client_config,
               timeout: timeout,
               lib_name: lib_name,
+              service_address: service_address,
+              service_port: service_port,
               lib_version: lib_version,
+              metadata: metadata,
             )
 
             if credentials.is_a?(String) || credentials.is_a?(Hash)
@@ -216,8 +225,8 @@ module Google
             end
 
             # Allow overriding the service path/port in subclasses.
-            service_path = self.class::SERVICE_ADDRESS
-            port = self.class::DEFAULT_SERVICE_PORT
+            service_path = service_address || self.class::SERVICE_ADDRESS
+            port = service_port || self.class::DEFAULT_SERVICE_PORT
             interceptors = self.class::GRPC_INTERCEPTORS
             @agents_stub = Google::Gax::Grpc.create_stub(
               service_path,
@@ -230,6 +239,22 @@ module Google
               &Google::Cloud::Dialogflow::V2::Agents::Stub.method(:new)
             )
 
+            @set_agent = Google::Gax.create_api_call(
+              @agents_stub.method(:set_agent),
+              defaults["set_agent"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'agent.parent' => request.agent.parent}
+              end
+            )
+            @delete_agent = Google::Gax.create_api_call(
+              @agents_stub.method(:delete_agent),
+              defaults["delete_agent"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
+            )
             @get_agent = Google::Gax.create_api_call(
               @agents_stub.method(:get_agent),
               defaults["get_agent"],
@@ -282,6 +307,77 @@ module Google
 
           # Service calls
 
+          # Creates/updates the specified agent.
+          #
+          # @param agent [Google::Cloud::Dialogflow::V2::Agent | Hash]
+          #   Required. The agent to update.
+          #   A hash of the same form as `Google::Cloud::Dialogflow::V2::Agent`
+          #   can also be provided.
+          # @param update_mask [Google::Protobuf::FieldMask | Hash]
+          #   Optional. The mask to control which fields get updated.
+          #   A hash of the same form as `Google::Protobuf::FieldMask`
+          #   can also be provided.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Dialogflow::V2::Agent]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Dialogflow::V2::Agent]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/dialogflow"
+          #
+          #   agents_client = Google::Cloud::Dialogflow::Agents.new(version: :v2)
+          #
+          #   # TODO: Initialize `agent`:
+          #   agent = {}
+          #   response = agents_client.set_agent(agent)
+
+          def set_agent \
+              agent,
+              update_mask: nil,
+              options: nil,
+              &block
+            req = {
+              agent: agent,
+              update_mask: update_mask
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::Dialogflow::V2::SetAgentRequest)
+            @set_agent.call(req, options, &block)
+          end
+
+          # Deletes the specified agent.
+          #
+          # @param parent [String]
+          #   Required. The project that the agent to delete is associated with.
+          #   Format: `projects/<Project ID>`.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result []
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/dialogflow"
+          #
+          #   agents_client = Google::Cloud::Dialogflow::Agents.new(version: :v2)
+          #   formatted_parent = Google::Cloud::Dialogflow::V2::AgentsClient.project_path("[PROJECT]")
+          #   agents_client.delete_agent(formatted_parent)
+
+          def delete_agent \
+              parent,
+              options: nil,
+              &block
+            req = {
+              parent: parent
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::Dialogflow::V2::DeleteAgentRequest)
+            @delete_agent.call(req, options, &block)
+            nil
+          end
+
           # Retrieves the specified agent.
           #
           # @param parent [String]

data/lib/google/cloud/dialogflow/v2/agents_client_config.json

@@ -20,6 +20,16 @@
         }
       },
       "methods": {
+        "SetAgent": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "DeleteAgent": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
         "GetAgent": {
           "timeout_millis": 60000,
           "retry_codes_name": "idempotent",

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

@@ -4,6 +4,7 @@
 
 require 'google/protobuf'
 
+require 'google/protobuf/duration_pb'
 require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.dialogflow.v2.InputAudioConfig" do

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

@@ -8,6 +8,7 @@ require 'google/api/annotations_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/struct_pb'
+require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.dialogflow.v2.Context" do
     optional :name, :string, 1

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

@@ -43,7 +43,7 @@ module Google
           #
           # For more information about contexts, see the
           # [Dialogflow
-          # documentation](https://cloud.google.com/dialogflow-enterprise/docs/contexts-overview).
+          # documentation](https://cloud.google.com/dialogflow/docs/contexts-overview).
           class Service
 
             include GRPC::GenericService

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

@@ -50,7 +50,7 @@ module Google
         #
         # For more information about contexts, see the
         # [Dialogflow
-        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/contexts-overview).
+        # documentation](https://cloud.google.com/dialogflow/docs/contexts-overview).
         #
         # @!attribute [r] contexts_stub
         #   @return [Google::Cloud::Dialogflow::V2::Contexts::Stub]
@@ -148,6 +148,10 @@ module Google
           #   The default timeout, in seconds, for calls made through this client.
           # @param metadata [Hash]
           #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param service_address [String]
+          #   Override for the service hostname, or `nil` to leave as the default.
+          # @param service_port [Integer]
+          #   Override for the service port, or `nil` to leave as the default.
           # @param exception_transformer [Proc]
           #   An optional proc that intercepts any exceptions raised during an API call to inject
           #   custom error handling.
@@ -157,6 +161,8 @@ module Google
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
               metadata: nil,
+              service_address: nil,
+              service_port: nil,
               exception_transformer: nil,
               lib_name: nil,
               lib_version: ""
@@ -211,8 +217,8 @@ module Google
             end
 
             # Allow overriding the service path/port in subclasses.
-            service_path = self.class::SERVICE_ADDRESS
-            port = self.class::DEFAULT_SERVICE_PORT
+            service_path = service_address || self.class::SERVICE_ADDRESS
+            port = service_port || self.class::DEFAULT_SERVICE_PORT
             interceptors = self.class::GRPC_INTERCEPTORS
             @contexts_stub = Google::Gax::Grpc.create_stub(
               service_path,

data/lib/google/cloud/dialogflow/v2/doc/google/cloud/dialogflow/v2/agent.rb

@@ -29,7 +29,7 @@ module Google
         #   @return [String]
         #     Required. The default language of the agent as a language tag. See
         #     [Language
-        #     Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     Support](https://cloud.google.com/dialogflow/docs/reference/language)
         #     for a list of the currently supported language codes. This field cannot be
         #     set by the `Update` method.
         # @!attribute [rw] supported_language_codes
@@ -50,7 +50,7 @@ module Google
         #     Optional. The URI of the agent's avatar.
         #     Avatars are used throughout the Dialogflow console and in the self-hosted
         #     [Web
-        #     Demo](https://cloud.google.com/dialogflow-enterprise/docs/integrations/web-demo)
+        #     Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo)
         #     integration.
         # @!attribute [rw] enable_logging
         #   @return [true, false]
@@ -67,7 +67,31 @@ module Google
         #     are no fallback intents defined, no intent will be triggered. The score
         #     values range from 0.0 (completely uncertain) to 1.0 (completely certain).
         #     If set to 0.0, the default of 0.3 is used.
+        # @!attribute [rw] api_version
+        #   @return [Google::Cloud::Dialogflow::V2::Agent::ApiVersion]
+        #     Optional. API version displayed in Dialogflow console. If not specified,
+        #     V2 API is assumed. Clients are free to query different service endpoints
+        #     for different API versions. However, bots connectors and webhook calls will
+        #     follow the specified API version.
+        # @!attribute [rw] tier
+        #   @return [Google::Cloud::Dialogflow::V2::Agent::Tier]
+        #     Optional. The agent tier. If not specified, TIER_STANDARD is assumed.
         class Agent
+          # API version for the agent.
+          module ApiVersion
+            # Not specified.
+            API_VERSION_UNSPECIFIED = 0
+
+            # Legacy V1 API.
+            API_VERSION_V1 = 1
+
+            # V2 API.
+            API_VERSION_V2 = 2
+
+            # V2beta1 API.
+            API_VERSION_V2_BETA_1 = 3
+          end
+
           # Match mode determines how intents are detected from user queries.
           module MatchMode
             # Not specified.
@@ -81,6 +105,21 @@ module Google
             # especially the ones using @sys.any or very large developer entities.
             MATCH_MODE_ML_ONLY = 2
           end
+
+          # Represents the agent tier.
+          module Tier
+            # Not specified. This value should never be used.
+            TIER_UNSPECIFIED = 0
+
+            # Standard tier.
+            TIER_STANDARD = 1
+
+            # Enterprise tier (Essentials).
+            TIER_ENTERPRISE = 2
+
+            # Enterprise tier (Plus).
+            TIER_ENTERPRISE_PLUS = 3
+          end
         end
 
         # The request message for {Google::Cloud::Dialogflow::V2::Agents::GetAgent Agents::GetAgent}.
@@ -90,6 +129,22 @@ module Google
         #     Format: `projects/<Project ID>`.
         class GetAgentRequest; end
 
+        # The request message for {Google::Cloud::Dialogflow::V2::Agents::SetAgent Agents::SetAgent}.
+        # @!attribute [rw] agent
+        #   @return [Google::Cloud::Dialogflow::V2::Agent]
+        #     Required. The agent to update.
+        # @!attribute [rw] update_mask
+        #   @return [Google::Protobuf::FieldMask]
+        #     Optional. The mask to control which fields get updated.
+        class SetAgentRequest; end
+
+        # The request message for {Google::Cloud::Dialogflow::V2::Agents::DeleteAgent Agents::DeleteAgent}.
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Required. The project that the agent to delete is associated with.
+        #     Format: `projects/<Project ID>`.
+        class DeleteAgentRequest; end
+
         # The request message for {Google::Cloud::Dialogflow::V2::Agents::SearchAgents Agents::SearchAgents}.
         # @!attribute [rw] parent
         #   @return [String]

data/lib/google/cloud/dialogflow/v2/doc/google/cloud/dialogflow/v2/audio_config.rb

@@ -32,15 +32,15 @@ module Google
         #   @return [String]
         #     Required. The language of the supplied audio. Dialogflow does not do
         #     translations. See [Language
-        #     Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     Support](https://cloud.google.com/dialogflow/docs/reference/language)
         #     for a list of the currently supported language codes. Note that queries in
         #     the same session do not necessarily need to specify the same language.
         # @!attribute [rw] phrase_hints
         #   @return [Array<String>]
-        #     Optional. The collection of phrase hints which are used to boost accuracy
-        #     of speech recognition.
-        #     Refer to
-        #     [Cloud Speech API
+        #     Optional. A list of strings containing words and phrases that the speech
+        #     recognizer should recognize with higher likelihood.
+        #
+        #     See [the Cloud Speech
         #     documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints)
         #     for more details.
         # @!attribute [rw] model_variant
@@ -194,7 +194,7 @@ module Google
           # model][InputAudioConfig.model] that the caller is eligible for.
           #
           # Please see the [Dialogflow
-          # docs](https://cloud.google.com/dialogflow-enterprise/docs/data-logging) for
+          # docs](https://cloud.google.com/dialogflow/docs/data-logging) for
           # how to make your project eligible for enhanced models.
           USE_BEST_AVAILABLE = 1
 
@@ -216,7 +216,7 @@ module Google
           #
           # * If the API caller isn't eligible for enhanced models, Dialogflow returns
           #   an error. Please see the [Dialogflow
-          #   docs](https://cloud.google.com/dialogflow-enterprise/docs/data-logging)
+          #   docs](https://cloud.google.com/dialogflow/docs/data-logging)
           #   for how to make your project eligible.
           USE_ENHANCED = 3
         end

data/lib/google/cloud/dialogflow/v2/doc/google/cloud/dialogflow/v2/context.rb

@@ -35,7 +35,7 @@ module Google
         #   @return [Google::Protobuf::Struct]
         #     Optional. The collection of parameters associated with this context.
         #     Refer to [this
-        #     doc](https://cloud.google.com/dialogflow-enterprise/docs/intents-actions-parameters)
+        #     doc](https://cloud.google.com/dialogflow/docs/intents-actions-parameters)
         #     for syntax.
         class Context; end
 

data/lib/google/cloud/dialogflow/v2/doc/google/cloud/dialogflow/v2/entity_type.rb

@@ -104,7 +104,7 @@ module Google
         #     Optional. The language to list entity synonyms for. If not specified,
         #     the agent's default language is used.
         #     [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         # @!attribute [rw] page_size
@@ -137,7 +137,7 @@ module Google
         #     Optional. The language to retrieve entity synonyms for. If not specified,
         #     the agent's default language is used.
         #     [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         class GetEntityTypeRequest; end
@@ -155,7 +155,7 @@ module Google
         #     Optional. The language of entity synonyms defined in `entity_type`. If not
         #     specified, the agent's default language is used.
         #     [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         class CreateEntityTypeRequest; end
@@ -169,7 +169,7 @@ module Google
         #     Optional. The language of entity synonyms defined in `entity_type`. If not
         #     specified, the agent's default language is used.
         #     [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         # @!attribute [rw] update_mask
@@ -203,7 +203,7 @@ module Google
         #     Optional. The language of entity synonyms defined in `entity_types`. If not
         #     specified, the agent's default language is used.
         #     [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         # @!attribute [rw] update_mask
@@ -241,7 +241,7 @@ module Google
         #     Optional. The language of entity synonyms defined in `entities`. If not
         #     specified, the agent's default language is used.
         #     [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         class BatchCreateEntitiesRequest; end
@@ -259,7 +259,7 @@ module Google
         #     Optional. The language of entity synonyms defined in `entities`. If not
         #     specified, the agent's default language is used.
         #     [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         # @!attribute [rw] update_mask
@@ -282,7 +282,7 @@ module Google
         #     Optional. The language of entity synonyms defined in `entities`. If not
         #     specified, the agent's default language is used.
         #     [Many
-        #     languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language)
+        #     languages](https://cloud.google.com/dialogflow/docs/reference/language)
         #     are supported. Note: languages must be enabled in the agent before they can
         #     be used.
         class BatchDeleteEntitiesRequest; end