google-cloud-dialogflow-v2 0.11.3 → 0.13.0

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

@@ -187,6 +187,27 @@ module Google
             #
             # @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::Versions::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::ListVersionsRequest.new
+            #
+            #   # Call the list_versions method.
+            #   result = client.list_versions request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Dialogflow::V2::Version.
+            #     p response
+            #   end
+            #
             def list_versions request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -204,9 +225,11 @@ module Google
                 gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -261,6 +284,21 @@ module Google
             #
             # @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::Versions::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::GetVersionRequest.new
+            #
+            #   # Call the get_version method.
+            #   result = client.get_version request
+            #
+            #   # The returned object is of type Google::Cloud::Dialogflow::V2::Version.
+            #   p result
+            #
             def get_version request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -278,9 +316,11 @@ module Google
                 gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -337,6 +377,21 @@ module Google
             #
             # @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::Versions::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::CreateVersionRequest.new
+            #
+            #   # Call the create_version method.
+            #   result = client.create_version request
+            #
+            #   # The returned object is of type Google::Cloud::Dialogflow::V2::Version.
+            #   p result
+            #
             def create_version request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -354,9 +409,11 @@ module Google
                 gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -416,6 +473,21 @@ module Google
             #
             # @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::Versions::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::UpdateVersionRequest.new
+            #
+            #   # Call the update_version method.
+            #   result = client.update_version request
+            #
+            #   # The returned object is of type Google::Cloud::Dialogflow::V2::Version.
+            #   p result
+            #
             def update_version request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -433,9 +505,11 @@ module Google
                 gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "version.name" => request.version.name
-              }
+              header_params = {}
+              if request.version&.name
+                header_params["version.name"] = request.version.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -489,6 +563,21 @@ module Google
             #
             # @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::Versions::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dialogflow::V2::DeleteVersionRequest.new
+            #
+            #   # Call the delete_version method.
+            #   result = client.delete_version request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_version request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -506,9 +595,11 @@ module Google
                 gapic_version: ::Google::Cloud::Dialogflow::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 

data/proto_docs/google/api/resource.rb

@@ -33,11 +33,7 @@ module Google
     #       // For Kubernetes resources, the format is {api group}/{kind}.
     #       option (google.api.resource) = {
     #         type: "pubsub.googleapis.com/Topic"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
+    #         pattern: "projects/{project}/topics/{topic}"
     #       };
     #     }
     #
@@ -45,10 +41,7 @@ module Google
     #
     #     resources:
     #     - type: "pubsub.googleapis.com/Topic"
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
+    #       pattern: "projects/{project}/topics/{topic}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
     #     message LogEntry {
     #       option (google.api.resource) = {
     #         type: "logging.googleapis.com/LogEntry"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #         }
+    #         pattern: "projects/{project}/logs/{log}"
+    #         pattern: "folders/{folder}/logs/{log}"
+    #         pattern: "organizations/{organization}/logs/{log}"
+    #         pattern: "billingAccounts/{billing_account}/logs/{log}"
     #       };
     #     }
     #
@@ -85,48 +62,10 @@ module Google
     #
     #     resources:
     #     - type: 'logging.googleapis.com/LogEntry'
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         - pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         - pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #
-    # For flexible resources, the resource name doesn't contain parent names, but
-    # the resource itself has parents for policy evaluation.
-    #
-    # Example:
-    #
-    #     message Shelf {
-    #       option (google.api.resource) = {
-    #         type: "library.googleapis.com/Shelf"
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #         }
-    #       };
-    #     }
-    #
-    # The ResourceDescriptor Yaml config will look like:
-    #
-    #     resources:
-    #     - type: 'library.googleapis.com/Shelf'
-    #       name_descriptor:
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #       pattern: "projects/{project}/logs/{log}"
+    #       pattern: "folders/{folder}/logs/{log}"
+    #       pattern: "organizations/{organization}/logs/{log}"
+    #       pattern: "billingAccounts/{billing_account}/logs/{log}"
     # @!attribute [rw] type
     #   @return [::String]
     #     The resource type. It must be in the format of

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

@@ -126,13 +126,14 @@ module Google
             # Not specified. This value should never be used.
             TIER_UNSPECIFIED = 0
 
-            # Standard tier.
+            # Trial Edition, previously known as Standard Edition.
             TIER_STANDARD = 1
 
-            # Enterprise tier (Essentials).
+            # Essentials Edition, previously known as Enterprise Essential Edition.
             TIER_ENTERPRISE = 2
 
-            # Enterprise tier (Plus).
+            # Essentials Edition (same as TIER_ENTERPRISE), previously known as
+            # Enterprise Plus Edition.
             TIER_ENTERPRISE_PLUS = 3
           end
         end

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

@@ -241,10 +241,13 @@ module Google
         # Configures speech transcription for {::Google::Cloud::Dialogflow::V2::ConversationProfile ConversationProfile}.
         # @!attribute [rw] speech_model_variant
         #   @return [::Google::Cloud::Dialogflow::V2::SpeechModelVariant]
-        #     Optional. The speech model used in speech to text.
+        #     The speech model used in speech to text.
         #     `SPEECH_MODEL_VARIANT_UNSPECIFIED`, `USE_BEST_AVAILABLE` will be treated as
         #     `USE_ENHANCED`. It can be overridden in {::Google::Cloud::Dialogflow::V2::AnalyzeContentRequest AnalyzeContentRequest} and
         #     [StreamingAnalyzeContentRequest][google.cloud.dialogflow.v2.StreamingAnalyzeContentRequest] request.
+        #     If enhanced model variant is specified and an enhanced
+        #     version of the specified model for the language does not exist, then it
+        #     would emit an error.
         class SpeechToTextConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -63,9 +63,21 @@ module Google
         #     Settings for speech transcription.
         # @!attribute [rw] language_code
         #   @return [::String]
-        #     Language which represents the conversationProfile.
-        #     If unspecified, the default language code en-us applies. Users need to
-        #     create a ConversationProfile for each language they want to support.
+        #     Language code for the conversation profile. If not specified, the language
+        #     is en-US. Language at ConversationProfile should be set for all non en-US
+        #     languages.
+        #     This should be a [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
+        #     language tag. Example: "en-US".
+        # @!attribute [rw] time_zone
+        #   @return [::String]
+        #     The time zone of this conversational profile from the
+        #     [time zone database](https://www.iana.org/time-zones), e.g.,
+        #     America/New_York, Europe/Paris. Defaults to America/New_York.
+        # @!attribute [rw] security_settings
+        #   @return [::String]
+        #     Name of the CX SecuritySettings reference for the agent.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/securitySettings/<Security Settings ID>`.
         class ConversationProfile
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -162,11 +174,16 @@ module Google
         #     Number>@gcp-sa-dialogflow.iam.gserviceaccount.com` the `Dialogflow API
         #     Service Agent` role in this project.
         #
-        #     Format: `projects/<Project ID>/locations/<Location
+        #     - For ES agents, use format: `projects/<Project ID>/locations/<Location
         #     ID>/agent/environments/<Environment ID or '-'>`. If environment is not
         #     specified, the default `draft` environment is used. Refer to
         #     [DetectIntentRequest](/dialogflow/docs/reference/rpc/google.cloud.dialogflow.v2#google.cloud.dialogflow.v2.DetectIntentRequest)
         #     for more details.
+        #
+        #     - For CX agents, use format `projects/<Project ID>/locations/<Location
+        #     ID>/agents/<Agent ID>/environments/<Environment ID
+        #     or '-'>`. If environment is not specified, the default `draft` environment
+        #     is used.
         class AutomatedAgentConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -289,7 +306,7 @@ module Google
           #     If this field is not set, it defaults to 0.0, which means that all
           #     suggestions are returned.
           #
-          #     Supported features: ARTICLE_SUGGESTION.
+          #     Supported features: ARTICLE_SUGGESTION, FAQ, SMART_REPLY, SMART_COMPOSE.
           # @!attribute [rw] context_filter_settings
           #   @return [::Google::Cloud::Dialogflow::V2::HumanAgentAssistantConfig::SuggestionQueryConfig::ContextFilterSettings]
           #     Determines how recent conversation context is filtered when generating
@@ -471,13 +488,13 @@ module Google
 
           # Format of cloud pub/sub message.
           module MessageFormat
-            # If it is unspeified, PROTO will be used.
+            # If it is unspecified, PROTO will be used.
             MESSAGE_FORMAT_UNSPECIFIED = 0
 
-            # Pubsub message will be serialized proto.
+            # Pub/Sub message will be serialized proto.
             PROTO = 1
 
-            # Pubsub message will be json.
+            # Pub/Sub message will be json.
             JSON = 2
           end
         end
@@ -514,6 +531,9 @@ module Google
 
             # Run FAQ model.
             FAQ = 2
+
+            # Run smart reply model.
+            SMART_REPLY = 3
           end
         end
       end

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

@@ -163,6 +163,29 @@ module Google
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The next_page_token value returned from a previous list request.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     The filter expression used to filter documents returned by the list method.
+        #     The expression has the following syntax:
+        #
+        #       <field> <operator> <value> [AND <field> <operator> <value>] ...
+        #
+        #     The following fields and operators are supported:
+        #
+        #     * knowledge_types with has(:) operator
+        #     * display_name with has(:) operator
+        #     * state with equals(=) operator
+        #
+        #     Examples:
+        #
+        #     * "knowledge_types:FAQ" matches documents with FAQ knowledge type.
+        #     * "display_name:customer" matches documents whose display name contains
+        #       "customer".
+        #     * "state=ACTIVE" matches documents with ACTIVE state.
+        #     * "knowledge_types:FAQ AND state=ACTIVE" matches all active FAQ documents.
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
         class ListDocumentsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -233,11 +256,41 @@ module Google
         #
         #     For documents stored in Google Cloud Storage, these URIs must have
         #     the form `gs://<bucket-name>/<object-name>`.
+        # @!attribute [rw] import_gcs_custom_metadata
+        #   @return [::Boolean]
+        #     Optional. Whether to import custom metadata from Google Cloud Storage.
+        #     Only valid when the document source is Google Cloud Storage URI.
+        # @!attribute [rw] smart_messaging_partial_update
+        #   @return [::Boolean]
+        #     Optional. When enabled, the reload request is to apply partial update to the smart
+        #     messaging allowlist.
         class ReloadDocumentRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for {::Google::Cloud::Dialogflow::V2::Documents::Client#export_document Documents.ExportDocument}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the document to export.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/knowledgeBases/<Knowledge Base ID>/documents/<Document ID>`.
+        # @!attribute [rw] gcs_destination
+        #   @return [::Google::Cloud::Dialogflow::V2::GcsDestination]
+        #     Cloud Storage file path to export the document.
+        # @!attribute [rw] export_full_content
+        #   @return [::Boolean]
+        #     When enabled, export the full content of the document including empirical
+        #     probability.
+        # @!attribute [rw] smart_messaging_partial_update
+        #   @return [::Boolean]
+        #     When enabled, export the smart messaging allowlist document for partial
+        #     update.
+        class ExportDocumentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Metadata in google::longrunning::Operation for Knowledge operations.
         # @!attribute [r] state
         #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata::State]

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

@@ -0,0 +1,39 @@
+# 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
+        # Google Cloud Storage location for the output.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     The Google Cloud Storage URIs for the output. A URI is of the
+        #     form:
+        #       gs://bucket/object-prefix-or-name
+        #     Whether a prefix or name is used depends on the use case. The requesting
+        #     user must have "write-permission" to the bucket.
+        class GcsDestination
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

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

@@ -63,6 +63,34 @@ module Google
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The next_page_token value returned from a previous list request.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     The filter expression used to filter knowledge bases returned by the list
+        #     method. The expression has the following syntax:
+        #
+        #       <field> <operator> <value> [AND <field> <operator> <value>] ...
+        #
+        #     The following fields and operators are supported:
+        #
+        #     * display_name with has(:) operator
+        #     * language_code with equals(=) operator
+        #
+        #     Examples:
+        #
+        #     * 'language_code=en-us' matches knowledge bases with en-us language code.
+        #     * 'display_name:articles' matches knowledge bases whose display name
+        #       contains "articles".
+        #     * 'display_name:"Best Articles"' matches knowledge bases whose display
+        #       name contains "Best Articles".
+        #     * 'language_code=en-gb AND display_name=articles' matches all knowledge
+        #       bases whose display name contains "articles" and whose language code is
+        #       "en-gb".
+        #
+        #     Note: An empty filter string (i.e. "") is a no-op and will result in no
+        #     filtering.
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
         class ListKnowledgeBasesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -36,10 +36,37 @@ module Google
         #     Optional. Label applied to streams representing this participant in SIPREC
         #     XML metadata and SDP. This is used to assign transcriptions from that
         #     media stream to this participant. This field can be updated.
+        # @!attribute [rw] documents_metadata_filters
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Key-value filters on the metadata of documents returned by article
+        #     suggestion. If specified, article suggestion only returns suggested
+        #     documents that match all filters in their {::Google::Cloud::Dialogflow::V2::Document#metadata Document.metadata}. Multiple
+        #     values for a metadata key should be concatenated by comma. For example,
+        #     filters to match all documents that have 'US' or 'CA' in their market
+        #     metadata values and 'agent' in their user metadata values will be
+        #     ```
+        #     documents_metadata_filters {
+        #       key: "market"
+        #       value: "US,CA"
+        #     }
+        #     documents_metadata_filters {
+        #       key: "user"
+        #       value: "agent"
+        #     }
+        #     ```
         class Participant
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class DocumentsMetadataFiltersEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Enumeration of the roles a participant can play in a conversation.
           module Role
             # Participant role not set.
@@ -179,6 +206,9 @@ module Google
         # @!attribute [rw] query_params
         #   @return [::Google::Cloud::Dialogflow::V2::QueryParameters]
         #     Parameters for a Dialogflow virtual-agent query.
+        # @!attribute [rw] assist_query_params
+        #   @return [::Google::Cloud::Dialogflow::V2::AssistQueryParameters]
+        #     Parameters for a human assist query.
         # @!attribute [rw] request_id
         #   @return [::String]
         #     A unique identifier for this request. Restricted to 36 ASCII characters.
@@ -262,6 +292,9 @@ module Google
         #     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.
+        # @!attribute [rw] assist_query_params
+        #   @return [::Google::Cloud::Dialogflow::V2::AssistQueryParameters]
+        #     Parameters for a human assist query.
         class SuggestArticlesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -308,6 +341,9 @@ module Google
         #     Max number of messages prior to and including
         #     [latest_message] to use as context when compiling the
         #     suggestion. By default 20 and at most 50.
+        # @!attribute [rw] assist_query_params
+        #   @return [::Google::Cloud::Dialogflow::V2::AssistQueryParameters]
+        #     Parameters for a human assist query.
         class SuggestFaqAnswersRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -519,6 +555,39 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Represents the parameters of human assist query.
+        # @!attribute [rw] documents_metadata_filters
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Key-value filters on the metadata of documents returned by article
+        #     suggestion. If specified, article suggestion only returns suggested
+        #     documents that match all filters in their {::Google::Cloud::Dialogflow::V2::Document#metadata Document.metadata}. Multiple
+        #     values for a metadata key should be concatenated by comma. For example,
+        #     filters to match all documents that have 'US' or 'CA' in their market
+        #     metadata values and 'agent' in their user metadata values will be
+        #     ```
+        #     documents_metadata_filters {
+        #       key: "market"
+        #       value: "US,CA"
+        #     }
+        #     documents_metadata_filters {
+        #       key: "user"
+        #       value: "agent"
+        #     }
+        #     ```
+        class AssistQueryParameters
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class DocumentsMetadataFiltersEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
       end
     end
   end