google-cloud-dialogflow-v2 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c86303c78008f5bef3bdb05cb9214795febe9436b9fb21a6d2076d0e442e0c23
-  data.tar.gz: 91f7a758f57bc62416f8fadfbf5b9917f3ca5fd2c811a66a056a2a341f69b24d
+  metadata.gz: 0f9bd8a2a3f32c3ae56627408a739f0e8c29f9973d723af1a982127291c7f12b
+  data.tar.gz: a71c4834e3b7a9cb9919963644688ce42dd185f43e3905c1ca3aec67ec96fec1
 SHA512:
-  metadata.gz: 29aaac78018fbb70e182d7ef1de6a1e12735a97d80f4e482b677fa66f3a6716219630dc91f1cbcff27b15e25ed59efbed930aa454571f1b0bb4776ec1d044597
-  data.tar.gz: 8aa2712581dc4af4affa5d1ad9786726907c6369bed35b396e15efe50c0feef36f7c9617468fed24dfccabfee505f28eb1e14a011cca9f4670acde6c4632a658
+  metadata.gz: 33d0b96ddd47aecd6c5941f33317c8dadcade2098c513bd3e910ecaa78c1ee74b5d4df06f46ea9d29fe97c8138510020388d1f86b21b7d8c814e637511e9dc7e
+  data.tar.gz: bbafb336587819afd529cf2e2fc673289ab6a15e7a190634a2a629283f666fd92b50887f5baf0b175f6203259d7cb2364c3b9bfa8729a67b3112851e7fe2b9f7

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

@@ -36,6 +36,10 @@ module Google
             # Retrieves the specified agent.
             rpc :GetAgent, ::Google::Cloud::Dialogflow::V2::GetAgentRequest, ::Google::Cloud::Dialogflow::V2::Agent
             # Creates/updates 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).
             rpc :SetAgent, ::Google::Cloud::Dialogflow::V2::SetAgentRequest, ::Google::Cloud::Dialogflow::V2::Agent
             # Deletes the specified agent.
             rpc :DeleteAgent, ::Google::Cloud::Dialogflow::V2::DeleteAgentRequest, ::Google::Protobuf::Empty
@@ -49,11 +53,12 @@ module Google
             rpc :SearchAgents, ::Google::Cloud::Dialogflow::V2::SearchAgentsRequest, ::Google::Cloud::Dialogflow::V2::SearchAgentsResponse
             # Trains 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).
             rpc :TrainAgent, ::Google::Cloud::Dialogflow::V2::TrainAgentRequest, ::Google::Longrunning::Operation
             # Exports the specified agent to a ZIP file.
-            #
-            # Operation <response: [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]>
             rpc :ExportAgent, ::Google::Cloud::Dialogflow::V2::ExportAgentRequest, ::Google::Longrunning::Operation
             # Imports the specified agent from a ZIP file.
             #
@@ -65,9 +70,12 @@ module Google
             # call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it returns in order to train
             # explicitly.
             #
-            # Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
             # An operation which tracks when importing is complete. It only tracks
             # when the draft agent is updated not when it is done training.
+            #
+            # 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 :ImportAgent, ::Google::Cloud::Dialogflow::V2::ImportAgentRequest, ::Google::Longrunning::Operation
             # Restores the specified agent from a ZIP file.
             #
@@ -78,9 +86,12 @@ module Google
             # completed yet. Please call [TrainAgent][google.cloud.dialogflow.v2.Agents.TrainAgent] and wait for the operation it
             # returns in order to train explicitly.
             #
-            # Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
             # An operation which tracks when restoring is complete. It only tracks
             # when the draft agent is updated not when it is done training.
+            #
+            # 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 :RestoreAgent, ::Google::Cloud::Dialogflow::V2::RestoreAgentRequest, ::Google::Longrunning::Operation
             # Gets agent validation result. Agent validation is performed during
             # training time and is updated automatically when training is completed.

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

@@ -240,6 +240,10 @@ module Google
             ##
             # Creates/updates 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 set_agent(request, options = nil)
             #   Pass arguments to `set_agent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::SetAgentRequest} or an equivalent Hash.
@@ -454,7 +458,10 @@ module Google
             ##
             # Trains 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 train_agent(request, options = nil)
             #   Pass arguments to `train_agent` via a request object, either of type
@@ -524,8 +531,6 @@ module Google
             ##
             # Exports the specified agent to a ZIP file.
             #
-            # Operation <response: {::Google::Cloud::Dialogflow::V2::ExportAgentResponse ExportAgentResponse}>
-            #
             # @overload export_agent(request, options = nil)
             #   Pass arguments to `export_agent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::ExportAgentRequest} or an equivalent Hash.
@@ -607,10 +612,13 @@ module Google
             # call {::Google::Cloud::Dialogflow::V2::Agents::Client#train_agent TrainAgent} and wait for the operation it returns in order to train
             # explicitly.
             #
-            # Operation <response: {::Google::Protobuf::Empty google.protobuf.Empty}>
             # An operation which tracks when importing is complete. It only tracks
             # when the draft agent is updated not when it is done training.
             #
+            # 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 import_agent(request, options = nil)
             #   Pass arguments to `import_agent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::ImportAgentRequest} or an equivalent Hash.
@@ -691,10 +699,13 @@ module Google
             # completed yet. Please call {::Google::Cloud::Dialogflow::V2::Agents::Client#train_agent TrainAgent} and wait for the operation it
             # returns in order to train explicitly.
             #
-            # Operation <response: {::Google::Protobuf::Empty google.protobuf.Empty}>
             # An operation which tracks when restoring is complete. It only tracks
             # when the draft agent is updated not when it is done training.
             #
+            # 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 restore_agent(request, options = nil)
             #   Pass arguments to `restore_agent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::RestoreAgentRequest} or an equivalent Hash.

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

@@ -38,34 +38,55 @@ module Google
             # Retrieves the specified entity type.
             rpc :GetEntityType, ::Google::Cloud::Dialogflow::V2::GetEntityTypeRequest, ::Google::Cloud::Dialogflow::V2::EntityType
             # Creates an entity type 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).
             rpc :CreateEntityType, ::Google::Cloud::Dialogflow::V2::CreateEntityTypeRequest, ::Google::Cloud::Dialogflow::V2::EntityType
             # Updates the specified entity type.
+            #
+            # 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 :UpdateEntityType, ::Google::Cloud::Dialogflow::V2::UpdateEntityTypeRequest, ::Google::Cloud::Dialogflow::V2::EntityType
             # Deletes the specified entity type.
+            #
+            # 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 :DeleteEntityType, ::Google::Cloud::Dialogflow::V2::DeleteEntityTypeRequest, ::Google::Protobuf::Empty
             # Updates/Creates multiple entity types in the specified agent.
             #
-            # Operation <response: [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]>
+            #
+            # 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 :BatchUpdateEntityTypes, ::Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesRequest, ::Google::Longrunning::Operation
             # Deletes entity types 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).
             rpc :BatchDeleteEntityTypes, ::Google::Cloud::Dialogflow::V2::BatchDeleteEntityTypesRequest, ::Google::Longrunning::Operation
             # Creates multiple new entities in the specified entity type.
             #
-            # 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).
             rpc :BatchCreateEntities, ::Google::Cloud::Dialogflow::V2::BatchCreateEntitiesRequest, ::Google::Longrunning::Operation
             # Updates or creates multiple entities in the specified entity type. This
             # method does not affect entities in the entity type that aren't explicitly
             # specified in the request.
             #
-            #
-            # 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).
             rpc :BatchUpdateEntities, ::Google::Cloud::Dialogflow::V2::BatchUpdateEntitiesRequest, ::Google::Longrunning::Operation
             # Deletes entities in the specified entity type.
             #
-            #
-            # 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).
             rpc :BatchDeleteEntities, ::Google::Cloud::Dialogflow::V2::BatchDeleteEntitiesRequest, ::Google::Longrunning::Operation
           end
 

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

@@ -325,6 +325,10 @@ module Google
             ##
             # Creates an entity type 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_entity_type(request, options = nil)
             #   Pass arguments to `create_entity_type` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::CreateEntityTypeRequest} or an equivalent Hash.
@@ -400,6 +404,10 @@ module Google
             ##
             # Updates the specified entity type.
             #
+            # 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_entity_type(request, options = nil)
             #   Pass arguments to `update_entity_type` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::UpdateEntityTypeRequest} or an equivalent Hash.
@@ -474,6 +482,10 @@ module Google
             ##
             # Deletes the specified entity type.
             #
+            # 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_entity_type(request, options = nil)
             #   Pass arguments to `delete_entity_type` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::DeleteEntityTypeRequest} or an equivalent Hash.
@@ -541,7 +553,10 @@ module Google
             ##
             # Updates/Creates multiple entity types in the specified agent.
             #
-            # Operation <response: {::Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesResponse BatchUpdateEntityTypesResponse}>
+            #
+            # 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_entity_types(request, options = nil)
             #   Pass arguments to `batch_update_entity_types` via a request object, either of type
@@ -626,7 +641,9 @@ module Google
             ##
             # Deletes entity types 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_entity_types(request, options = nil)
             #   Pass arguments to `batch_delete_entity_types` via a request object, either of type
@@ -699,7 +716,9 @@ module Google
             ##
             # Creates multiple new entities in the specified entity type.
             #
-            # 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_create_entities(request, options = nil)
             #   Pass arguments to `batch_create_entities` via a request object, either of type
@@ -779,8 +798,9 @@ module Google
             # method does not affect entities in the entity type that aren't explicitly
             # specified in the request.
             #
-            #
-            # 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_update_entities(request, options = nil)
             #   Pass arguments to `batch_update_entities` via a request object, either of type
@@ -860,8 +880,9 @@ module Google
             ##
             # Deletes entities in the specified entity type.
             #
-            #
-            # 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_entities(request, options = nil)
             #   Pass arguments to `batch_delete_entities` via a request object, either of type

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

@@ -137,6 +137,47 @@ module Google
               resource.call(**args)
             end
 
+            ##
+            # Create a fully-qualified Version resource string.
+            #
+            # @overload version_path(project:, version:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/agent/versions/{version}`
+            #
+            #   @param project [String]
+            #   @param version [String]
+            #
+            # @overload version_path(project:, location:, version:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/agent/versions/{version}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param version [String]
+            #
+            # @return [::String]
+            def version_path **args
+              resources = {
+                "project:version" => (proc do |project:, version:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+                  "projects/#{project}/agent/versions/#{version}"
+                end),
+                "location:project:version" => (proc do |project:, location:, version:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/agent/versions/#{version}"
+                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

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

@@ -38,18 +38,36 @@ module Google
             # Retrieves the specified intent.
             rpc :GetIntent, ::Google::Cloud::Dialogflow::V2::GetIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # 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).
             rpc :CreateIntent, ::Google::Cloud::Dialogflow::V2::CreateIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # 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).
             rpc :UpdateIntent, ::Google::Cloud::Dialogflow::V2::UpdateIntentRequest, ::Google::Cloud::Dialogflow::V2::Intent
             # 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).
             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]>
+            #
+            # 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]>
+            #
+            # 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
 

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

@@ -337,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.
@@ -414,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.
@@ -490,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.
@@ -558,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
@@ -644,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

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Dialogflow
       module V2
-        VERSION = "0.9.0"
+        VERSION = "0.10.0"
       end
     end
   end

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

@@ -52,7 +52,7 @@ module Google
         #     The maximum length is 500 characters. If exceeded, the request is rejected.
         # @!attribute [rw] agent_version
         #   @return [::String]
-        #     Optional. The agent version loaded into this environment.
+        #     Required. The agent version loaded into this environment.
         #     Supported formats:
         #     - `projects/<Project ID>/agent/versions/<Version ID>`
         #     - `projects/<Project ID>/locations/<Location ID>/agent/versions/<Version

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-dialogflow-v2
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-17 00:00:00.000000000 Z
+date: 2021-06-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common