google-cloud-dialogflow-v2 0.6.4 → 0.7.0

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

@@ -48,7 +48,7 @@ module Google
             # @return [::String]
             def session_path **args
               resources = {
-                "project:session"                  => (proc do |project:, session:|
+                "project:session" => (proc do |project:, session:|
                   raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
 
                   "projects/#{project}/agent/sessions/#{session}"
@@ -93,7 +93,7 @@ module Google
             # @return [::String]
             def session_entity_type_path **args
               resources = {
-                "entity_type:project:session"                  => (proc do |project:, session:, entity_type:|
+                "entity_type:project:session" => (proc do |project:, session:, entity_type:|
                   raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
                   raise ::ArgumentError, "session cannot contain /" if session.to_s.include? "/"
 

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

@@ -41,6 +41,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :session_entity_types, :message, 5, "google.cloud.dialogflow.v2.SessionEntityType"
       optional :payload, :message, 6, "google.protobuf.Struct"
       optional :sentiment_analysis_request_config, :message, 10, "google.cloud.dialogflow.v2.SentimentAnalysisRequestConfig"
+      map :webhook_headers, :string, :string, 14
     end
     add_message "google.cloud.dialogflow.v2.QueryInput" do
       oneof :input do

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

@@ -24,10 +24,10 @@ module Google
     module Dialogflow
       module V2
         module Sessions
-          # A session represents an interaction with a user. You retrieve user input
-          # and pass it to the [DetectIntent][google.cloud.dialogflow.v2.Sessions.DetectIntent] (or
-          # [StreamingDetectIntent][google.cloud.dialogflow.v2.Sessions.StreamingDetectIntent]) method to determine
-          # user intent and respond.
+          # A service used for session interactions.
+          #
+          # For more information, see the [API interactions
+          # guide](https://cloud.google.com/dialogflow/docs/api-overview).
           class Service
 
             include GRPC::GenericService
@@ -40,11 +40,19 @@ module Google
             # as a result. This method is not idempotent, because it may cause contexts
             # and session entity types to be updated, which in turn might affect
             # results of future queries.
-            rpc :DetectIntent, DetectIntentRequest, DetectIntentResponse
+            #
+            # Note: Always use agent versions for production traffic.
+            # See [Versions and
+            # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
+            rpc :DetectIntent, ::Google::Cloud::Dialogflow::V2::DetectIntentRequest, ::Google::Cloud::Dialogflow::V2::DetectIntentResponse
             # Processes a natural language query in audio format in a streaming fashion
             # and returns structured, actionable data as a result. This method is only
             # available via the gRPC API (not REST).
-            rpc :StreamingDetectIntent, stream(StreamingDetectIntentRequest), stream(StreamingDetectIntentResponse)
+            #
+            # Note: Always use agent versions for production traffic.
+            # See [Versions and
+            # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
+            rpc :StreamingDetectIntent, stream(::Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest), stream(::Google::Cloud::Dialogflow::V2::StreamingDetectIntentResponse)
           end
 
           Stub = Service.rpc_stub_class

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

@@ -31,10 +31,10 @@ module Google
     module Dialogflow
       module V2
         ##
-        # A session represents an interaction with a user. You retrieve user input
-        # and pass it to the {::Google::Cloud::Dialogflow::V2::Sessions::Client#detect_intent DetectIntent} (or
-        # {::Google::Cloud::Dialogflow::V2::Sessions::Client#streaming_detect_intent StreamingDetectIntent}) method to determine
-        # user intent and respond.
+        # A service used for session interactions.
+        #
+        # For more information, see the [API interactions
+        # guide](https://cloud.google.com/dialogflow/docs/api-overview).
         #
         # To load this service and instantiate a client:
         #

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

@@ -27,10 +27,10 @@ module Google
           ##
           # Client for the Sessions service.
           #
-          # A session represents an interaction with a user. You retrieve user input
-          # and pass it to the {::Google::Cloud::Dialogflow::V2::Sessions::Client#detect_intent DetectIntent} (or
-          # {::Google::Cloud::Dialogflow::V2::Sessions::Client#streaming_detect_intent StreamingDetectIntent}) method to determine
-          # user intent and respond.
+          # A service used for session interactions.
+          #
+          # For more information, see the [API interactions
+          # guide](https://cloud.google.com/dialogflow/docs/api-overview).
           #
           class Client
             include Paths
@@ -63,7 +63,7 @@ module Google
                 parent_config = while namespace.any?
                                   parent_name = namespace.join "::"
                                   parent_const = const_get parent_name
-                                  break parent_const.configure if parent_const&.respond_to? :configure
+                                  break parent_const.configure if parent_const.respond_to? :configure
                                   namespace.pop
                                 end
                 default_config = Client::Configuration.new parent_config
@@ -71,17 +71,17 @@ module Google
                 default_config.timeout = 60.0
                 default_config.retry_policy = {
                   initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE"]
+                max_delay: 60.0,
+                multiplier: 1.3,
+                retry_codes: [14]
                 }
 
                 default_config.rpcs.detect_intent.timeout = 220.0
                 default_config.rpcs.detect_intent.retry_policy = {
                   initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE"]
+              max_delay: 60.0,
+              multiplier: 1.3,
+              retry_codes: [14]
                 }
 
                 default_config.rpcs.streaming_detect_intent.timeout = 220.0
@@ -147,7 +147,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              credentials ||= Credentials.default scope: @config.scope
+              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # but only if the default endpoint does not have a region prefix.
+              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                       @config.endpoint == Client.configure.endpoint &&
+                                       !@config.endpoint.split(".").first.include?("-")
+              credentials ||= Credentials.default scope: @config.scope,
+                                                  enable_self_signed_jwt: enable_self_signed_jwt
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
@@ -171,6 +177,10 @@ module Google
             # and session entity types to be updated, which in turn might affect
             # results of future queries.
             #
+            # Note: Always use agent versions for production traffic.
+            # See [Versions and
+            # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
+            #
             # @overload detect_intent(request, options = nil)
             #   Pass arguments to `detect_intent` via a request object, either of type
             #   {::Google::Cloud::Dialogflow::V2::DetectIntentRequest} or an equivalent Hash.
@@ -191,11 +201,19 @@ module Google
             #     `projects/<Project ID>/agent/sessions/<Session ID>`, or
             #     `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
             #     ID>/sessions/<Session ID>`. If `Environment ID` is not specified, we assume
-            #     default 'draft' environment. If `User ID` is not specified, we are using
-            #     "-". It's up to the API caller to choose an appropriate `Session ID` and
-            #     `User Id`. They can be a random number or some type of user and session
+            #     default 'draft' environment (`Environment ID` might be referred to as
+            #     environment name at some places). If `User ID` is not specified, we are
+            #     using "-". It's up to the API caller to choose an appropriate `Session ID`
+            #     and `User Id`. They can be a random number or some type of user and session
             #     identifiers (preferably hashed). The length of the `Session ID` and
             #     `User ID` must not exceed 36 characters.
+            #
+            #     For more information, see the [API interactions
+            #     guide](https://cloud.google.com/dialogflow/docs/api-overview).
+            #
+            #     Note: Always use agent versions for production traffic.
+            #     See [Versions and
+            #     environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
             #   @param query_params [::Google::Cloud::Dialogflow::V2::QueryParameters, ::Hash]
             #     The parameters of this query.
             #   @param query_input [::Google::Cloud::Dialogflow::V2::QueryInput, ::Hash]
@@ -273,6 +291,10 @@ module Google
             # and returns structured, actionable data as a result. This method is only
             # available via the gRPC API (not REST).
             #
+            # Note: Always use agent versions for production traffic.
+            # See [Versions and
+            # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
+            #
             # @param request [::Gapic::StreamInput, ::Enumerable<::Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest, ::Hash>]
             #   An enumerable of {::Google::Cloud::Dialogflow::V2::StreamingDetectIntentRequest} instances.
             # @param options [::Gapic::CallOptions, ::Hash]
@@ -407,14 +429,14 @@ module Google
 
               config_attr :endpoint,      "dialogflow.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
               config_attr :scope,         nil, ::String, ::Array, nil
               config_attr :lib_name,      nil, ::String, nil
               config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
               config_attr :interceptors,  nil, ::Array, nil
               config_attr :timeout,       nil, ::Numeric, nil
               config_attr :metadata,      nil, ::Hash, nil
@@ -435,7 +457,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end
@@ -447,7 +469,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:
@@ -471,9 +493,9 @@ module Google
 
                 # @private
                 def initialize parent_rpcs = nil
-                  detect_intent_config = parent_rpcs&.detect_intent if parent_rpcs&.respond_to? :detect_intent
+                  detect_intent_config = parent_rpcs.detect_intent if parent_rpcs.respond_to? :detect_intent
                   @detect_intent = ::Gapic::Config::Method.new detect_intent_config
-                  streaming_detect_intent_config = parent_rpcs&.streaming_detect_intent if parent_rpcs&.respond_to? :streaming_detect_intent
+                  streaming_detect_intent_config = parent_rpcs.streaming_detect_intent if parent_rpcs.respond_to? :streaming_detect_intent
                   @streaming_detect_intent = ::Gapic::Config::Method.new streaming_detect_intent_config
 
                   yield self if block_given?

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

@@ -50,7 +50,7 @@ module Google
             # @return [::String]
             def context_path **args
               resources = {
-                "context:project:session"                  => (proc do |project:, session:, context:|
+                "context:project:session" => (proc do |project:, session:, context:|
                   raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
                   raise ::ArgumentError, "session cannot contain /" if session.to_s.include? "/"
 
@@ -95,7 +95,7 @@ module Google
             # @return [::String]
             def session_path **args
               resources = {
-                "project:session"                  => (proc do |project:, session:|
+                "project:session" => (proc do |project:, session:|
                   raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
 
                   "projects/#{project}/agent/sessions/#{session}"
@@ -140,7 +140,7 @@ module Google
             # @return [::String]
             def session_entity_type_path **args
               resources = {
-                "entity_type:project:session"                  => (proc do |project:, session:, entity_type:|
+                "entity_type:project:session" => (proc do |project:, session:, entity_type:|
                   raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
                   raise ::ArgumentError, "session cannot contain /" if session.to_s.include? "/"
 

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Dialogflow
       module V2
-        VERSION = "0.6.4"
+        VERSION = "0.7.0"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -54,6 +54,12 @@ module Google
       # This indicates that the field may be set once in a request to create a
       # resource, but may not be changed thereafter.
       IMMUTABLE = 5
+
+      # Denotes that a (repeated) field is an unordered list.
+      # This indicates that the service may provide the elements of the list
+      # in any arbitrary order, rather than the order the user originally
+      # provided. Additionally, the list's order may or may not be stable.
+      UNORDERED_LIST = 6
     end
   end
 end

data/proto_docs/google/api/resource.rb

@@ -43,12 +43,12 @@ module Google
     #
     # The ResourceDescriptor Yaml config will look like:
     #
-    #    resources:
-    #    - type: "pubsub.googleapis.com/Topic"
-    #      name_descriptor:
-    #        - pattern: "projects/\\{project}/topics/\\{topic}"
-    #          parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #          parent_name_extractor: "projects/\\{project}"
+    #     resources:
+    #     - type: "pubsub.googleapis.com/Topic"
+    #       name_descriptor:
+    #         - pattern: "projects/{project}/topics/{topic}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
     #         }
     # @!attribute [rw] plural
     #   @return [::String]
-    #     The plural name used in the resource name, such as 'projects' for
-    #     the name of 'projects/\\{project}'. It is the same concept of the `plural`
-    #     field in k8s CRD spec
+    #     The plural name used in the resource name and permission names, such as
+    #     'projects' for the resource name of 'projects/\\{project}' and the permission
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
+    #     concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    #
+    #     Note: The plural form is required even for singleton resources. See
+    #     https://aip.dev/156
     # @!attribute [rw] singular
     #   @return [::String]
     #     The same concept of the `singular` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
+    # @!attribute [rw] style
+    #   @return [::Array<::Google::Api::ResourceDescriptor::Style>]
+    #     Style flag(s) for this resource.
+    #     These indicate that a resource is expected to conform to a given
+    #     style. See the specific style flags for additional information.
     class ResourceDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
         # that from being necessary once there are multiple patterns.)
         FUTURE_MULTI_PATTERN = 2
       end
+
+      # A flag representing a specific style that a resource claims to conform to.
+      module Style
+        # The unspecified value. Do not use.
+        STYLE_UNSPECIFIED = 0
+
+        # This resource is intended to be "declarative-friendly".
+        #
+        # Declarative-friendly resources must be more strictly consistent, and
+        # setting this to true communicates to tools that this resource should
+        # adhere to declarative-friendly expectations.
+        #
+        # Note: This is used by the API linter (linter.aip.dev) to enable
+        # additional checks.
+        DECLARATIVE_FRIENDLY = 1
+      end
     end
 
     # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
     #             type: "pubsub.googleapis.com/Topic"
     #           }];
     #         }
+    #
+    #     Occasionally, a field may reference an arbitrary resource. In this case,
+    #     APIs use the special value * in their resource reference.
+    #
+    #     Example:
+    #
+    #         message GetIamPolicyRequest {
+    #           string resource = 2 [(google.api.resource_reference) = {
+    #             type: "*"
+    #           }];
+    #         }
     # @!attribute [rw] child_type
     #   @return [::String]
     #     The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
     #
     #     Example:
     #
-    #       message ListLogEntriesRequest {
-    #         string parent = 1 [(google.api.resource_reference) = {
-    #           child_type: "logging.googleapis.com/LogEntry"
-    #         };
-    #       }
+    #         message ListLogEntriesRequest {
+    #           string parent = 1 [(google.api.resource_reference) = {
+    #             child_type: "logging.googleapis.com/LogEntry"
+    #           };
+    #         }
     class ResourceReference
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -29,8 +29,7 @@ module Google
         # conversations required for your system.
         #
         # For more information about agents, see the
-        # [Agents
-        # documentation](https://cloud.google.com/dialogflow/docs/agents-overview).
+        # [Agent guide](https://cloud.google.com/dialogflow/docs/agents-overview).
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The project of this agent.

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

@@ -0,0 +1,259 @@
+# 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
+        # Answer records are records to manage answer history and feedbacks for
+        # Dialogflow.
+        #
+        # Currently, answer record includes:
+        #
+        # - human agent assistant article suggestion
+        # - human agent assistant faq article
+        #
+        # It doesn't include:
+        #
+        # - `DetectIntent` intent matching
+        # - `DetectIntent` knowledge
+        #
+        # Answer records are not related to the conversation history in the
+        # Dialogflow Console. A Record is generated even when the end-user disables
+        # conversation history in the console. Records are created when there's a human
+        # agent assistant suggestion generated.
+        #
+        # A typical workflow for customers provide feedback to an answer is:
+        #
+        # 1. For human agent assistant, customers get suggestion via ListSuggestions
+        #    API. Together with the answers,
+        #    {::Google::Cloud::Dialogflow::V2::AnswerRecord#name AnswerRecord.name} are
+        #    returned to the customers.
+        # 2. The customer uses the
+        # {::Google::Cloud::Dialogflow::V2::AnswerRecord#name AnswerRecord.name} to call the
+        #    [UpdateAnswerRecord][] method to send feedback about a specific answer
+        #    that they believe is wrong.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The unique identifier of this answer record.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/answerRecords/<Answer Record ID>`.
+        # @!attribute [rw] answer_feedback
+        #   @return [::Google::Cloud::Dialogflow::V2::AnswerFeedback]
+        #     Required. The AnswerFeedback for this record. You can set this with
+        #     {::Google::Cloud::Dialogflow::V2::AnswerRecords::Client#update_answer_record AnswerRecords.UpdateAnswerRecord}
+        #     in order to give us feedback about this answer.
+        # @!attribute [r] agent_assistant_record
+        #   @return [::Google::Cloud::Dialogflow::V2::AgentAssistantRecord]
+        #     Output only. The record for human agent assistant.
+        class AnswerRecord
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::Dialogflow::V2::AnswerRecords::Client#list_answer_records AnswerRecords.ListAnswerRecords}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The project to list all answer records for in reverse
+        #     chronological order. Format: `projects/<Project ID>/locations/<Location
+        #     ID>`.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Required. Filters to restrict results to specific answer records.
+        #     Filter on answer record type. Currently predicates on `type` is supported,
+        #     valid values are `ARTICLE_ANSWER`, `FAQ_ANSWER`.
+        #
+        #     For more information about filtering, see
+        #     [API Filtering](https://aip.dev/160).
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of records to return in a single page.
+        #     The server may return fewer records than this. If unspecified, we use 10.
+        #     The maximum is 100.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. The
+        #     {::Google::Cloud::Dialogflow::V2::ListAnswerRecordsResponse#next_page_token ListAnswerRecordsResponse.next_page_token}
+        #     value returned from a previous list request used to continue listing on
+        #     the next page.
+        class ListAnswerRecordsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::Dialogflow::V2::AnswerRecords::Client#list_answer_records AnswerRecords.ListAnswerRecords}.
+        # @!attribute [rw] answer_records
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::AnswerRecord>]
+        #     The list of answer records.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token to retrieve next page of results. Or empty if there are no more
+        #     results.
+        #     Pass this value in the
+        #     {::Google::Cloud::Dialogflow::V2::ListAnswerRecordsRequest#page_token ListAnswerRecordsRequest.page_token}
+        #     field in the subsequent call to `ListAnswerRecords` method to retrieve the
+        #     next page of results.
+        class ListAnswerRecordsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::Dialogflow::V2::AnswerRecords::Client#update_answer_record AnswerRecords.UpdateAnswerRecord}.
+        # @!attribute [rw] answer_record
+        #   @return [::Google::Cloud::Dialogflow::V2::AnswerRecord]
+        #     Required. Answer record to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. The mask to control which fields get updated.
+        class UpdateAnswerRecordRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents feedback the customer has about the quality & correctness of a
+        # certain answer in a conversation.
+        # @!attribute [rw] correctness_level
+        #   @return [::Google::Cloud::Dialogflow::V2::AnswerFeedback::CorrectnessLevel]
+        #     The correctness level of the specific answer.
+        # @!attribute [rw] agent_assistant_detail_feedback
+        #   @return [::Google::Cloud::Dialogflow::V2::AgentAssistantFeedback]
+        #     Detail feedback of agent assist suggestions.
+        # @!attribute [rw] clicked
+        #   @return [::Boolean]
+        #     Indicates whether the answer/item was clicked by the human agent
+        #     or not. Default to false.
+        # @!attribute [rw] click_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Time when the answer/item was clicked.
+        # @!attribute [rw] displayed
+        #   @return [::Boolean]
+        #     Indicates whether the answer/item was displayed to the human
+        #     agent in the agent desktop UI. Default to false.
+        # @!attribute [rw] display_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Time when the answer/item was displayed.
+        class AnswerFeedback
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The correctness level of an answer.
+          module CorrectnessLevel
+            # Correctness level unspecified.
+            CORRECTNESS_LEVEL_UNSPECIFIED = 0
+
+            # Answer is totally wrong.
+            NOT_CORRECT = 1
+
+            # Answer is partially correct.
+            PARTIALLY_CORRECT = 2
+
+            # Answer is fully correct.
+            FULLY_CORRECT = 3
+          end
+        end
+
+        # Detail feedback of Agent Assist result.
+        # @!attribute [rw] answer_relevance
+        #   @return [::Google::Cloud::Dialogflow::V2::AgentAssistantFeedback::AnswerRelevance]
+        #     Optional. Whether or not the suggested answer is relevant.
+        #
+        #     For example:
+        #
+        #     * Query: "Can I change my mailing address?"
+        #     * Suggested document says: "Items must be returned/exchanged within 60
+        #       days of the purchase date."
+        #     * {::Google::Cloud::Dialogflow::V2::AgentAssistantFeedback#answer_relevance answer_relevance}: {::Google::Cloud::Dialogflow::V2::AgentAssistantFeedback::AnswerRelevance::IRRELEVANT AnswerRelevance.IRRELEVANT}
+        # @!attribute [rw] document_correctness
+        #   @return [::Google::Cloud::Dialogflow::V2::AgentAssistantFeedback::DocumentCorrectness]
+        #     Optional. Whether or not the information in the document is correct.
+        #
+        #     For example:
+        #
+        #     * Query: "Can I return the package in 2 days once received?"
+        #     * Suggested document says: "Items must be returned/exchanged within 60
+        #       days of the purchase date."
+        #     * Ground truth: "No return or exchange is allowed."
+        #     * [document_correctness]: INCORRECT
+        # @!attribute [rw] document_efficiency
+        #   @return [::Google::Cloud::Dialogflow::V2::AgentAssistantFeedback::DocumentEfficiency]
+        #     Optional. Whether or not the suggested document is efficient. For example,
+        #     if the document is poorly written, hard to understand, hard to use or
+        #     too long to find useful information,
+        #     {::Google::Cloud::Dialogflow::V2::AgentAssistantFeedback#document_efficiency document_efficiency}
+        #     is
+        #     {::Google::Cloud::Dialogflow::V2::AgentAssistantFeedback::DocumentEfficiency::INEFFICIENT DocumentEfficiency.INEFFICIENT}.
+        class AgentAssistantFeedback
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Relevance of an answer.
+          module AnswerRelevance
+            # Answer relevance unspecified.
+            ANSWER_RELEVANCE_UNSPECIFIED = 0
+
+            # Answer is irrelevant to query.
+            IRRELEVANT = 1
+
+            # Answer is relevant to query.
+            RELEVANT = 2
+          end
+
+          # Correctness of document.
+          module DocumentCorrectness
+            # Document correctness unspecified.
+            DOCUMENT_CORRECTNESS_UNSPECIFIED = 0
+
+            # Information in document is incorrect.
+            INCORRECT = 1
+
+            # Information in document is correct.
+            CORRECT = 2
+          end
+
+          # Efficiency of document.
+          module DocumentEfficiency
+            # Document efficiency unspecified.
+            DOCUMENT_EFFICIENCY_UNSPECIFIED = 0
+
+            # Document is inefficient.
+            INEFFICIENT = 1
+
+            # Document is efficient.
+            EFFICIENT = 2
+          end
+        end
+
+        # Represents a record of a human agent assist answer.
+        # @!attribute [r] article_suggestion_answer
+        #   @return [::Google::Cloud::Dialogflow::V2::ArticleAnswer]
+        #     Output only. The article suggestion answer.
+        # @!attribute [r] faq_answer
+        #   @return [::Google::Cloud::Dialogflow::V2::FaqAnswer]
+        #     Output only. The FAQ answer.
+        class AgentAssistantRecord
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end