google-cloud-dialogflow-v2 0.19.0 → 0.21.0

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

@@ -28,7 +28,8 @@ module Google
           ##
           # Client for the Conversations service.
           #
-          # Service for managing {::Google::Cloud::Dialogflow::V2::Conversation Conversations}.
+          # Service for managing
+          # {::Google::Cloud::Dialogflow::V2::Conversation Conversations}.
           #
           class Client
             include Paths
@@ -177,11 +178,14 @@ module Google
             # For Assist Stage, there's no dialogflow agent responding to user queries.
             # But we will provide suggestions which are generated from conversation.
             #
-            # If {::Google::Cloud::Dialogflow::V2::Conversation#conversation_profile Conversation.conversation_profile} is configured for a dialogflow
-            # agent, conversation will start from `Automated Agent Stage`, otherwise, it
-            # will start from `Assist Stage`. And during `Automated Agent Stage`, once an
-            # {::Google::Cloud::Dialogflow::V2::Intent Intent} with {::Google::Cloud::Dialogflow::V2::Intent#live_agent_handoff Intent.live_agent_handoff} is triggered, conversation
-            # will transfer to Assist Stage.
+            # If
+            # {::Google::Cloud::Dialogflow::V2::Conversation#conversation_profile Conversation.conversation_profile}
+            # is configured for a dialogflow agent, conversation will start from
+            # `Automated Agent Stage`, otherwise, it will start from `Assist Stage`. And
+            # during `Automated Agent Stage`, once an
+            # {::Google::Cloud::Dialogflow::V2::Intent Intent} with
+            # {::Google::Cloud::Dialogflow::V2::Intent#live_agent_handoff Intent.live_agent_handoff}
+            # is triggered, conversation will transfer to Assist Stage.
             #
             # @overload create_conversation(request, options = nil)
             #   Pass arguments to `create_conversation` via a request object, either of type
@@ -204,8 +208,8 @@ module Google
             #   @param conversation [::Google::Cloud::Dialogflow::V2::Conversation, ::Hash]
             #     Required. The conversation to create.
             #   @param conversation_id [::String]
-            #     Optional. Identifier of the conversation. Generally it's auto generated by Google.
-            #     Only set it if you cannot wait for the response to return a
+            #     Optional. Identifier of the conversation. Generally it's auto generated by
+            #     Google. Only set it if you cannot wait for the response to return a
             #     auto-generated one to you.
             #
             #     The conversation ID must be compliant with the regression fomula
@@ -682,6 +686,106 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Suggests summary for a conversation based on specific historical messages.
+            # The range of the messages to be used for summary can be specified in the
+            # request.
+            #
+            # @overload suggest_conversation_summary(request, options = nil)
+            #   Pass arguments to `suggest_conversation_summary` via a request object, either of type
+            #   {::Google::Cloud::Dialogflow::V2::SuggestConversationSummaryRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Dialogflow::V2::SuggestConversationSummaryRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload suggest_conversation_summary(conversation: nil, latest_message: nil, context_size: nil)
+            #   Pass arguments to `suggest_conversation_summary` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param conversation [::String]
+            #     Required. The conversation to fetch suggestion for.
+            #     Format: `projects/<Project ID>/locations/<Location
+            #     ID>/conversations/<Conversation ID>`.
+            #   @param latest_message [::String]
+            #     The name of the latest conversation message used as context for
+            #     compiling suggestion. If empty, the latest message of the conversation will
+            #     be used.
+            #
+            #     Format: `projects/<Project ID>/locations/<Location
+            #     ID>/conversations/<Conversation ID>/messages/<Message ID>`.
+            #   @param context_size [::Integer]
+            #     Max number of messages prior to and including
+            #     [latest_message] to use as context when compiling the
+            #     suggestion. By default 500 and at most 1000.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Dialogflow::V2::SuggestConversationSummaryResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Dialogflow::V2::SuggestConversationSummaryResponse]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/dialogflow/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dialogflow::V2::Conversations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::SuggestConversationSummaryRequest.new
+            #
+            #   # Call the suggest_conversation_summary method.
+            #   result = client.suggest_conversation_summary request
+            #
+            #   # The returned object is of type Google::Cloud::Dialogflow::V2::SuggestConversationSummaryResponse.
+            #   p result
+            #
+            def suggest_conversation_summary request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Dialogflow::V2::SuggestConversationSummaryRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.suggest_conversation_summary.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.conversation
+                header_params["conversation"] = request.conversation
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.suggest_conversation_summary.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.suggest_conversation_summary.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @conversations_stub.call_rpc :suggest_conversation_summary, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the Conversations API.
             #
@@ -842,6 +946,11 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :list_messages
+                ##
+                # RPC-specific configuration for `suggest_conversation_summary`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :suggest_conversation_summary
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -855,6 +964,8 @@ module Google
                   @complete_conversation = ::Gapic::Config::Method.new complete_conversation_config
                   list_messages_config = parent_rpcs.list_messages if parent_rpcs.respond_to? :list_messages
                   @list_messages = ::Gapic::Config::Method.new list_messages_config
+                  suggest_conversation_summary_config = parent_rpcs.suggest_conversation_summary if parent_rpcs.respond_to? :suggest_conversation_summary
+                  @suggest_conversation_summary = ::Gapic::Config::Method.new suggest_conversation_summary_config
 
                   yield self if block_given?
                 end

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

@@ -123,6 +123,51 @@ module Google
               "projects/#{project}/locations/#{location}"
             end
 
+            ##
+            # Create a fully-qualified Message resource string.
+            #
+            # @overload message_path(project:, conversation:, message:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/conversations/{conversation}/messages/{message}`
+            #
+            #   @param project [String]
+            #   @param conversation [String]
+            #   @param message [String]
+            #
+            # @overload message_path(project:, location:, conversation:, message:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/conversations/{conversation}/messages/{message}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param conversation [String]
+            #   @param message [String]
+            #
+            # @return [::String]
+            def message_path **args
+              resources = {
+                "conversation:message:project" => (proc do |project:, conversation:, message:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "conversation cannot contain /" if conversation.to_s.include? "/"
+
+                  "projects/#{project}/conversations/#{conversation}/messages/#{message}"
+                end),
+                "conversation:location:message:project" => (proc do |project:, location:, conversation:, message:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "conversation cannot contain /" if conversation.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/conversations/#{conversation}/messages/#{message}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
             ##
             # Create a fully-qualified Project resource string.
             #

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

@@ -31,9 +31,10 @@ module Google
     module Dialogflow
       module V2
         ##
-        # Service for managing {::Google::Cloud::Dialogflow::V2::Conversation Conversations}.
+        # Service for managing
+        # {::Google::Cloud::Dialogflow::V2::Conversation Conversations}.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dialogflow/v2/conversations"
         #     client = ::Google::Cloud::Dialogflow::V2::Conversations::Client.new

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

@@ -24,7 +24,8 @@ module Google
     module Dialogflow
       module V2
         module Documents
-          # Service for managing knowledge [Documents][google.cloud.dialogflow.v2.Document].
+          # Service for managing knowledge
+          # [Documents][google.cloud.dialogflow.v2.Document].
           class Service
 
             include ::GRPC::GenericService
@@ -43,7 +44,8 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
+            # - `metadata`:
+            # [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
             # - `response`: [Document][google.cloud.dialogflow.v2.Document]
             rpc :CreateDocument, ::Google::Cloud::Dialogflow::V2::CreateDocumentRequest, ::Google::Longrunning::Operation
             # Creates documents by importing data from external sources.
@@ -54,8 +56,10 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
-            # - `response`: [ImportDocumentsResponse][google.cloud.dialogflow.v2.ImportDocumentsResponse]
+            # - `metadata`:
+            # [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
+            # - `response`:
+            # [ImportDocumentsResponse][google.cloud.dialogflow.v2.ImportDocumentsResponse]
             rpc :ImportDocuments, ::Google::Cloud::Dialogflow::V2::ImportDocumentsRequest, ::Google::Longrunning::Operation
             # Deletes the specified document.
             #
@@ -63,7 +67,8 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
+            # - `metadata`:
+            # [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
             # - `response`: An [Empty
             #   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
             rpc :DeleteDocument, ::Google::Cloud::Dialogflow::V2::DeleteDocumentRequest, ::Google::Longrunning::Operation
@@ -73,7 +78,8 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
+            # - `metadata`:
+            # [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
             # - `response`: [Document][google.cloud.dialogflow.v2.Document]
             rpc :UpdateDocument, ::Google::Cloud::Dialogflow::V2::UpdateDocumentRequest, ::Google::Longrunning::Operation
             # Reloads the specified document from its specified source, content_uri or
@@ -85,7 +91,8 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
+            # - `metadata`:
+            # [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
             # - `response`: [Document][google.cloud.dialogflow.v2.Document]
             #
             # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
@@ -98,7 +105,8 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
+            # - `metadata`:
+            # [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
             # - `response`: [Document][google.cloud.dialogflow.v2.Document]
             rpc :ExportDocument, ::Google::Cloud::Dialogflow::V2::ExportDocumentRequest, ::Google::Longrunning::Operation
           end

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

@@ -28,7 +28,8 @@ module Google
           ##
           # Client for the Documents service.
           #
-          # Service for managing knowledge {::Google::Cloud::Dialogflow::V2::Document Documents}.
+          # Service for managing knowledge
+          # {::Google::Cloud::Dialogflow::V2::Document Documents}.
           #
           class Client
             include Paths
@@ -391,7 +392,8 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
+            # - `metadata`:
+            # {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
             # - `response`: {::Google::Cloud::Dialogflow::V2::Document Document}
             #
             # @overload create_document(request, options = nil)
@@ -497,8 +499,10 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
-            # - `response`: {::Google::Cloud::Dialogflow::V2::ImportDocumentsResponse ImportDocumentsResponse}
+            # - `metadata`:
+            # {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
+            # - `response`:
+            # {::Google::Cloud::Dialogflow::V2::ImportDocumentsResponse ImportDocumentsResponse}
             #
             # @overload import_documents(request, options = nil)
             #   Pass arguments to `import_documents` via a request object, either of type
@@ -611,7 +615,8 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
+            # - `metadata`:
+            # {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
             # - `response`: An [Empty
             #   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
             #
@@ -714,7 +719,8 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
+            # - `metadata`:
+            # {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
             # - `response`: {::Google::Cloud::Dialogflow::V2::Document Document}
             #
             # @overload update_document(request, options = nil)
@@ -821,7 +827,8 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
+            # - `metadata`:
+            # {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
             # - `response`: {::Google::Cloud::Dialogflow::V2::Document Document}
             #
             # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
@@ -847,8 +854,8 @@ module Google
             #     Format: `projects/<Project ID>/locations/<Location
             #     ID>/knowledgeBases/<Knowledge Base ID>/documents/<Document ID>`
             #   @param content_uri [::String]
-            #     Optional. The path of gcs source file for reloading document content. For now,
-            #     only gcs uri is supported.
+            #     Optional. The path of gcs source file for reloading document content. For
+            #     now, only gcs uri is supported.
             #
             #     For documents stored in Google Cloud Storage, these URIs must have
             #     the form `gs://<bucket-name>/<object-name>`.
@@ -856,8 +863,8 @@ module Google
             #     Optional. Whether to import custom metadata from Google Cloud Storage.
             #     Only valid when the document source is Google Cloud Storage URI.
             #   @param smart_messaging_partial_update [::Boolean]
-            #     Optional. When enabled, the reload request is to apply partial update to the smart
-            #     messaging allowlist.
+            #     Optional. When enabled, the reload request is to apply partial update to
+            #     the smart messaging allowlist.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -939,7 +946,8 @@ module Google
             # operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
             # The returned `Operation` type has the following method-specific fields:
             #
-            # - `metadata`: {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
+            # - `metadata`:
+            # {::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata KnowledgeOperationMetadata}
             # - `response`: {::Google::Cloud::Dialogflow::V2::Document Document}
             #
             # @overload export_document(request, options = nil)

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

@@ -32,9 +32,10 @@ module Google
     module Dialogflow
       module V2
         ##
-        # Service for managing knowledge {::Google::Cloud::Dialogflow::V2::Document Documents}.
+        # Service for managing knowledge
+        # {::Google::Cloud::Dialogflow::V2::Document Documents}.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dialogflow/v2/documents"
         #     client = ::Google::Cloud::Dialogflow::V2::Documents::Client.new

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

@@ -63,7 +63,8 @@ module Google
             #
             # - `metadata`: An empty [Struct
             #   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
-            # - `response`: [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]
+            # - `response`:
+            # [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse]
             #
             # Note: You should always train an agent prior to sending it queries. See the
             # [training

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

@@ -666,7 +666,8 @@ module Google
             #
             # - `metadata`: An empty [Struct
             #   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
-            # - `response`: {::Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesResponse BatchUpdateEntityTypesResponse}
+            # - `response`:
+            # {::Google::Cloud::Dialogflow::V2::BatchUpdateEntityTypesResponse BatchUpdateEntityTypesResponse}
             #
             # Note: You should always train an agent prior to sending it queries. See the
             # [training

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

@@ -34,7 +34,7 @@ module Google
         ##
         # Service for managing {::Google::Cloud::Dialogflow::V2::EntityType EntityTypes}.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dialogflow/v2/entity_types"
         #     client = ::Google::Cloud::Dialogflow::V2::EntityTypes::Client.new

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

@@ -188,8 +188,8 @@ module Google
             #     - `projects/<Project ID>/agent`
             #     - `projects/<Project ID>/locations/<Location ID>/agent`
             #   @param page_size [::Integer]
-            #     Optional. The maximum number of items to return in a single page. By default 100 and
-            #     at most 1000.
+            #     Optional. The maximum number of items to return in a single page. By
+            #     default 100 and at most 1000.
             #   @param page_token [::String]
             #     Optional. The next_page_token value returned from a previous list request.
             #
@@ -672,8 +672,8 @@ module Google
             #
             #     The environment ID for the default environment is `-`.
             #   @param page_size [::Integer]
-            #     Optional. The maximum number of items to return in a single page. By default 100 and
-            #     at most 1000.
+            #     Optional. The maximum number of items to return in a single page. By
+            #     default 100 and at most 1000.
             #   @param page_token [::String]
             #     Optional. The next_page_token value returned from a previous list request.
             #

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

@@ -33,7 +33,7 @@ module Google
         ##
         # Service for managing {::Google::Cloud::Dialogflow::V2::Environment Environments}.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dialogflow/v2/environments"
         #     client = ::Google::Cloud::Dialogflow::V2::Environments::Client.new

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

@@ -33,7 +33,7 @@ module Google
         ##
         # Service for managing {::Google::Cloud::Dialogflow::V2::Fulfillment Fulfillments}.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dialogflow/v2/fulfillments"
         #     client = ::Google::Cloud::Dialogflow::V2::Fulfillments::Client.new

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

@@ -63,7 +63,8 @@ module Google
             #
             # - `metadata`: An empty [Struct
             #   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
-            # - `response`: [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]
+            # - `response`:
+            # [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]
             #
             # Note: You should always train an agent prior to sending it queries. See the
             # [training

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

@@ -683,7 +683,8 @@ module Google
             #
             # - `metadata`: An empty [Struct
             #   message](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)
-            # - `response`: {::Google::Cloud::Dialogflow::V2::BatchUpdateIntentsResponse BatchUpdateIntentsResponse}
+            # - `response`:
+            # {::Google::Cloud::Dialogflow::V2::BatchUpdateIntentsResponse BatchUpdateIntentsResponse}
             #
             # Note: You should always train an agent prior to sending it queries. See the
             # [training

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

@@ -34,7 +34,7 @@ module Google
         ##
         # Service for managing {::Google::Cloud::Dialogflow::V2::Intent Intents}.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dialogflow/v2/intents"
         #     client = ::Google::Cloud::Dialogflow::V2::Intents::Client.new

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

@@ -24,7 +24,8 @@ module Google
     module Dialogflow
       module V2
         module KnowledgeBases
-          # Service for managing [KnowledgeBases][google.cloud.dialogflow.v2.KnowledgeBase].
+          # Service for managing
+          # [KnowledgeBases][google.cloud.dialogflow.v2.KnowledgeBase].
           class Service
 
             include ::GRPC::GenericService

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

@@ -28,7 +28,8 @@ module Google
           ##
           # Client for the KnowledgeBases service.
           #
-          # Service for managing {::Google::Cloud::Dialogflow::V2::KnowledgeBase KnowledgeBases}.
+          # Service for managing
+          # {::Google::Cloud::Dialogflow::V2::KnowledgeBase KnowledgeBases}.
           #
           class Client
             include Paths

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

@@ -31,9 +31,10 @@ module Google
     module Dialogflow
       module V2
         ##
-        # Service for managing {::Google::Cloud::Dialogflow::V2::KnowledgeBase KnowledgeBases}.
+        # Service for managing
+        # {::Google::Cloud::Dialogflow::V2::KnowledgeBase KnowledgeBases}.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dialogflow/v2/knowledge_bases"
         #     client = ::Google::Cloud::Dialogflow::V2::KnowledgeBases::Client.new

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

@@ -152,6 +152,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :detect_intent_response, :message, 1, "google.cloud.dialogflow.v2.DetectIntentResponse"
       optional :automated_agent_reply_type, :enum, 7, "google.cloud.dialogflow.v2.AutomatedAgentReply.AutomatedAgentReplyType"
       optional :allow_cancellation, :bool, 8
+      optional :cx_current_page, :string, 11
     end
     add_enum "google.cloud.dialogflow.v2.AutomatedAgentReply.AutomatedAgentReplyType" do
       value :AUTOMATED_AGENT_REPLY_TYPE_UNSPECIFIED, 0

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

@@ -772,8 +772,9 @@ module Google
             #     ID>/conversations/<Conversation ID>/messages/<Message ID>`.
             #   @param context_size [::Integer]
             #     Optional. Max number of messages prior to and including
-            #     {::Google::Cloud::Dialogflow::V2::SuggestArticlesRequest#latest_message latest_message} to use as context
-            #     when compiling the suggestion. By default 20 and at most 50.
+            #     {::Google::Cloud::Dialogflow::V2::SuggestArticlesRequest#latest_message latest_message}
+            #     to use as context when compiling the suggestion. By default 20 and at
+            #     most 50.
             #   @param assist_query_params [::Google::Cloud::Dialogflow::V2::AssistQueryParameters, ::Hash]
             #     Parameters for a human assist query.
             #

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

@@ -33,7 +33,7 @@ module Google
         ##
         # Service for managing {::Google::Cloud::Dialogflow::V2::Participant Participants}.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dialogflow/v2/participants"
         #     client = ::Google::Cloud::Dialogflow::V2::Participants::Client.new

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

@@ -24,7 +24,8 @@ module Google
     module Dialogflow
       module V2
         module SessionEntityTypes
-          # Service for managing [SessionEntityTypes][google.cloud.dialogflow.v2.SessionEntityType].
+          # Service for managing
+          # [SessionEntityTypes][google.cloud.dialogflow.v2.SessionEntityType].
           class Service
 
             include ::GRPC::GenericService

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

@@ -28,7 +28,8 @@ module Google
           ##
           # Client for the SessionEntityTypes service.
           #
-          # Service for managing {::Google::Cloud::Dialogflow::V2::SessionEntityType SessionEntityTypes}.
+          # Service for managing
+          # {::Google::Cloud::Dialogflow::V2::SessionEntityType SessionEntityTypes}.
           #
           class Client
             include Paths

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

@@ -31,9 +31,10 @@ module Google
     module Dialogflow
       module V2
         ##
-        # Service for managing {::Google::Cloud::Dialogflow::V2::SessionEntityType SessionEntityTypes}.
+        # Service for managing
+        # {::Google::Cloud::Dialogflow::V2::SessionEntityType SessionEntityTypes}.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/dialogflow/v2/session_entity_types"
         #     client = ::Google::Cloud::Dialogflow::V2::SessionEntityTypes::Client.new