google-apis-dialogflow_v2 0.19.0 → 0.23.0

data/lib/google/apis/dialogflow_v2/service.rb

@@ -150,7 +150,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Exports the specified agent to a ZIP file.
+        # Exports the specified agent to a ZIP file. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`:
+        # ExportAgentResponse
         # @param [String] parent
         #   Required. The project that the agent to export is associated with. Format: `
         #   projects/`.
@@ -257,8 +262,13 @@ module Google
         # the import, the imported draft agent will be trained automatically (unless
         # disabled in agent settings). However, once the import is done, training may
         # not be completed yet. Please call TrainAgent and wait for the operation it
-        # returns in order to train explicitly. An operation which tracks when importing
-        # is complete. It only tracks when the draft agent is updated not when it is
+        # returns in order to train explicitly. This method is a [long-running operation]
+        # (https://cloud.google.com/dialogflow/es/docs/how/long-running-operations). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: An empty [Struct message](https://developers.google.com/protocol-
+        # buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message]
+        # (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        # empty) The operation only tracks when importing is complete, not when it is
         # done training. Note: You should always train an agent prior to sending it
         # queries. See the [training documentation](https://cloud.google.com/dialogflow/
         # es/docs/training).
@@ -300,9 +310,14 @@ module Google
         # are deleted. After the restore, the restored draft agent will be trained
         # automatically (unless disabled in agent settings). However, once the restore
         # is done, training may not be completed yet. Please call TrainAgent and wait
-        # for the operation it returns in order to train explicitly. An operation which
-        # tracks when restoring is complete. It only tracks when the draft agent is
-        # updated not when it is done training. Note: You should always train an agent
+        # for the operation it returns in order to train explicitly. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#empty) The operation only tracks when restoring is
+        # complete, not when it is done training. Note: You should always train an agent
         # prior to sending it queries. See the [training documentation](https://cloud.
         # google.com/dialogflow/es/docs/training).
         # @param [String] parent
@@ -379,9 +394,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Trains the specified agent. Note: You should always train an agent prior to
-        # sending it queries. See the [training documentation](https://cloud.google.com/
-        # dialogflow/es/docs/training).
+        # Trains the specified agent. This method is a [long-running operation](https://
+        # cloud.google.com/dialogflow/es/docs/how/long-running-operations). The returned
+        # `Operation` type has the following method-specific fields: - `metadata`: An
+        # empty [Struct message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#struct) - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+        # Note: You should always train an agent prior to sending it queries. See the [
+        # training documentation](https://cloud.google.com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The project that the agent to train is associated with. Format: `
         #   projects/`.
@@ -454,9 +474,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes entity types in the specified agent. Note: You should always train an
-        # agent prior to sending it queries. See the [training documentation](https://
-        # cloud.google.com/dialogflow/es/docs/training).
+        # Deletes entity types in the specified agent. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to delete all entities types for. Format: `
         #   projects//agent`.
@@ -490,9 +516,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates/Creates multiple entity types in the specified agent. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Updates/Creates multiple entity types in the specified agent. This method is a
+        # [long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : BatchUpdateEntityTypesResponse Note: You should always train an agent prior
+        # to sending it queries. See the [training documentation](https://cloud.google.
+        # com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to update or create entity types in. Format: `
         #   projects//agent`.
@@ -725,9 +756,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates multiple new entities in the specified entity type. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Creates multiple new entities in the specified entity type. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#empty) Note: You should always train an agent prior
+        # to sending it queries. See the [training documentation](https://cloud.google.
+        # com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the entity type to create entities in. Format: `projects/
         #   /agent/entityTypes/`.
@@ -761,9 +798,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes entities in the specified entity type. Note: You should always train
-        # an agent prior to sending it queries. See the [training documentation](https://
-        # cloud.google.com/dialogflow/es/docs/training).
+        # Deletes entities in the specified entity type. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the entity type to delete entries for. Format: `projects/
         #   /agent/entityTypes/`.
@@ -799,9 +842,14 @@ module Google
         
         # Updates or creates multiple entities in the specified entity type. This method
         # does not affect entities in the entity type that aren't explicitly specified
-        # in the request. Note: You should always train an agent prior to sending it
-        # queries. See the [training documentation](https://cloud.google.com/dialogflow/
-        # es/docs/training).
+        # in the request. This method is a [long-running operation](https://cloud.google.
+        # com/dialogflow/es/docs/how/long-running-operations). The returned `Operation`
+        # type has the following method-specific fields: - `metadata`: An empty [Struct
+        # message](https://developers.google.com/protocol-buffers/docs/reference/google.
+        # protobuf#struct) - `response`: An [Empty message](https://developers.google.
+        # com/protocol-buffers/docs/reference/google.protobuf#empty) Note: You should
+        # always train an agent prior to sending it queries. See the [training
+        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the entity type to update or create entities in. Format:
         #   `projects//agent/entityTypes/`.
@@ -1152,9 +1200,12 @@ module Google
         # Processes a natural language query and returns structured, actionable data 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. Note: Always use agent versions for production traffic. See [
-        # Versions and environments](https://cloud.google.com/dialogflow/es/docs/agents-
-        # versions).
+        # future queries. If you might use [Agent Assist](https://cloud.google.com/
+        # dialogflow/docs/#aa) or other CCAI products now or in the future, consider
+        # using AnalyzeContent instead of `DetectIntent`. `AnalyzeContent` has
+        # additional functionality for Agent Assist and other CCAI products. Note:
+        # Always use agent versions for production traffic. See [Versions and
+        # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
         # @param [String] session
         #   Required. The name of the session this query is sent to. Format: `projects//
         #   agent/sessions/`, or `projects//agent/environments//users//sessions/`. If `
@@ -1579,9 +1630,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes intents in the specified agent. Note: You should always train an agent
-        # prior to sending it queries. See the [training documentation](https://cloud.
-        # google.com/dialogflow/es/docs/training).
+        # Deletes intents in the specified agent. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to delete all entities types for. Format: `
         #   projects//agent`.
@@ -1615,9 +1672,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates/Creates multiple intents in the specified agent. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Updates/Creates multiple intents in the specified agent. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : BatchUpdateIntentsResponse Note: You should always train an agent prior to
+        # sending it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to update or create intents in. Format: `
         #   projects//agent`.
@@ -2044,7 +2106,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new document. Operation
+        # Creates a new document. This method is a [long-running operation](https://
+        # cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
+        # Operation` type has the following method-specific fields: - `metadata`:
+        # KnowledgeOperationMetadata - `response`: Document
         # @param [String] parent
         #   Required. The knowledge base to create a document for. Format: `projects//
         #   locations//knowledgeBases/`.
@@ -2078,7 +2143,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified document. Operation
+        # Deletes the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
         # @param [String] name
         #   Required. The name of the document to delete. Format: `projects//locations//
         #   knowledgeBases//documents/`.
@@ -2178,7 +2247,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified document. Operation
+        # Updates the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: Document
         # @param [String] name
         #   Optional. The document resource name. The name must be empty when creating a
         #   document. Format: `projects//locations//knowledgeBases//documents/`.
@@ -2220,9 +2292,12 @@ module Google
         # Reloads the specified document from its specified source, content_uri or
         # content. The previously loaded content of the document will be deleted. Note:
         # Even when the content of the document has not changed, there still may be side
-        # effects because of internal implementation changes. Note: The `projects.agent.
-        # knowledgeBases.documents` resource is deprecated; only use `projects.
-        # knowledgeBases.documents`. Operation
+        # effects because of internal implementation changes. This method is a [long-
+        # running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-
+        # running-operation). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: KnowledgeOperationMetadata - `response`:
+        # Document Note: The `projects.agent.knowledgeBases.documents` resource is
+        # deprecated; only use `projects.knowledgeBases.documents`.
         # @param [String] name
         #   Required. The name of the document to reload. Format: `projects//locations//
         #   knowledgeBases//documents/`
@@ -2292,9 +2367,12 @@ module Google
         # Processes a natural language query and returns structured, actionable data 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. Note: Always use agent versions for production traffic. See [
-        # Versions and environments](https://cloud.google.com/dialogflow/es/docs/agents-
-        # versions).
+        # future queries. If you might use [Agent Assist](https://cloud.google.com/
+        # dialogflow/docs/#aa) or other CCAI products now or in the future, consider
+        # using AnalyzeContent instead of `DetectIntent`. `AnalyzeContent` has
+        # additional functionality for Agent Assist and other CCAI products. Note:
+        # Always use agent versions for production traffic. See [Versions and
+        # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
         # @param [String] session
         #   Required. The name of the session this query is sent to. Format: `projects//
         #   agent/sessions/`, or `projects//agent/environments//users//sessions/`. If `
@@ -3792,7 +3870,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new document. Operation
+        # Creates a new document. This method is a [long-running operation](https://
+        # cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
+        # Operation` type has the following method-specific fields: - `metadata`:
+        # KnowledgeOperationMetadata - `response`: Document
         # @param [String] parent
         #   Required. The knowledge base to create a document for. Format: `projects//
         #   locations//knowledgeBases/`.
@@ -3826,7 +3907,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified document. Operation
+        # Deletes the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
         # @param [String] name
         #   Required. The name of the document to delete. Format: `projects//locations//
         #   knowledgeBases//documents/`.
@@ -3926,7 +4011,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified document. Operation
+        # Updates the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: Document
         # @param [String] name
         #   Optional. The document resource name. The name must be empty when creating a
         #   document. Format: `projects//locations//knowledgeBases//documents/`.
@@ -3968,9 +4056,12 @@ module Google
         # Reloads the specified document from its specified source, content_uri or
         # content. The previously loaded content of the document will be deleted. Note:
         # Even when the content of the document has not changed, there still may be side
-        # effects because of internal implementation changes. Note: The `projects.agent.
-        # knowledgeBases.documents` resource is deprecated; only use `projects.
-        # knowledgeBases.documents`. Operation
+        # effects because of internal implementation changes. This method is a [long-
+        # running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-
+        # running-operation). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: KnowledgeOperationMetadata - `response`:
+        # Document Note: The `projects.agent.knowledgeBases.documents` resource is
+        # deprecated; only use `projects.knowledgeBases.documents`.
         # @param [String] name
         #   Required. The name of the document to reload. Format: `projects//locations//
         #   knowledgeBases//documents/`
@@ -4035,6 +4126,36 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets information about a location.
+        # @param [String] name
+        #   Resource name for the location.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudLocationLocation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV2::GoogleCloudLocationLocation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+name}', options)
+          command.response_representation = Google::Apis::DialogflowV2::GoogleCloudLocationLocation::Representation
+          command.response_class = Google::Apis::DialogflowV2::GoogleCloudLocationLocation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Retrieves the specified agent.
         # @param [String] parent
         #   Required. The project that the agent to fetch is associated with. Format: `
@@ -4066,6 +4187,49 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Lists information about the supported locations for this service.
+        # @param [String] name
+        #   The resource that owns the locations collection, if applicable.
+        # @param [String] filter
+        #   A filter to narrow down results to a preferred subset. The filtering language
+        #   accepts strings like "displayName=tokyo", and is documented in more detail in [
+        #   AIP-160](https://google.aip.dev/160).
+        # @param [Fixnum] page_size
+        #   The maximum number of results to return. If not set, the service selects a
+        #   default.
+        # @param [String] page_token
+        #   A page token received from the `next_page_token` field in the response. Send
+        #   that page token to receive the subsequent page.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudLocationListLocationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DialogflowV2::GoogleCloudLocationListLocationsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+name}/locations', options)
+          command.response_representation = Google::Apis::DialogflowV2::GoogleCloudLocationListLocationsResponse::Representation
+          command.response_class = Google::Apis::DialogflowV2::GoogleCloudLocationListLocationsResponse
+          command.params['name'] = name unless name.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates/updates the specified agent. Note: You should always train an agent
         # prior to sending it queries. See the [training documentation](https://cloud.
         # google.com/dialogflow/es/docs/training).
@@ -4104,7 +4268,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Exports the specified agent to a ZIP file.
+        # Exports the specified agent to a ZIP file. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`:
+        # ExportAgentResponse
         # @param [String] parent
         #   Required. The project that the agent to export is associated with. Format: `
         #   projects/`.
@@ -4211,8 +4380,13 @@ module Google
         # the import, the imported draft agent will be trained automatically (unless
         # disabled in agent settings). However, once the import is done, training may
         # not be completed yet. Please call TrainAgent and wait for the operation it
-        # returns in order to train explicitly. An operation which tracks when importing
-        # is complete. It only tracks when the draft agent is updated not when it is
+        # returns in order to train explicitly. This method is a [long-running operation]
+        # (https://cloud.google.com/dialogflow/es/docs/how/long-running-operations). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: An empty [Struct message](https://developers.google.com/protocol-
+        # buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message]
+        # (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        # empty) The operation only tracks when importing is complete, not when it is
         # done training. Note: You should always train an agent prior to sending it
         # queries. See the [training documentation](https://cloud.google.com/dialogflow/
         # es/docs/training).
@@ -4254,9 +4428,14 @@ module Google
         # are deleted. After the restore, the restored draft agent will be trained
         # automatically (unless disabled in agent settings). However, once the restore
         # is done, training may not be completed yet. Please call TrainAgent and wait
-        # for the operation it returns in order to train explicitly. An operation which
-        # tracks when restoring is complete. It only tracks when the draft agent is
-        # updated not when it is done training. Note: You should always train an agent
+        # for the operation it returns in order to train explicitly. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#empty) The operation only tracks when restoring is
+        # complete, not when it is done training. Note: You should always train an agent
         # prior to sending it queries. See the [training documentation](https://cloud.
         # google.com/dialogflow/es/docs/training).
         # @param [String] parent
@@ -4333,9 +4512,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Trains the specified agent. Note: You should always train an agent prior to
-        # sending it queries. See the [training documentation](https://cloud.google.com/
-        # dialogflow/es/docs/training).
+        # Trains the specified agent. This method is a [long-running operation](https://
+        # cloud.google.com/dialogflow/es/docs/how/long-running-operations). The returned
+        # `Operation` type has the following method-specific fields: - `metadata`: An
+        # empty [Struct message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#struct) - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
+        # Note: You should always train an agent prior to sending it queries. See the [
+        # training documentation](https://cloud.google.com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The project that the agent to train is associated with. Format: `
         #   projects/`.
@@ -4408,9 +4592,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes entity types in the specified agent. Note: You should always train an
-        # agent prior to sending it queries. See the [training documentation](https://
-        # cloud.google.com/dialogflow/es/docs/training).
+        # Deletes entity types in the specified agent. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to delete all entities types for. Format: `
         #   projects//agent`.
@@ -4444,9 +4634,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates/Creates multiple entity types in the specified agent. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Updates/Creates multiple entity types in the specified agent. This method is a
+        # [long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : BatchUpdateEntityTypesResponse Note: You should always train an agent prior
+        # to sending it queries. See the [training documentation](https://cloud.google.
+        # com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to update or create entity types in. Format: `
         #   projects//agent`.
@@ -4679,9 +4874,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates multiple new entities in the specified entity type. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Creates multiple new entities in the specified entity type. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#empty) Note: You should always train an agent prior
+        # to sending it queries. See the [training documentation](https://cloud.google.
+        # com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the entity type to create entities in. Format: `projects/
         #   /agent/entityTypes/`.
@@ -4715,9 +4916,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes entities in the specified entity type. Note: You should always train
-        # an agent prior to sending it queries. See the [training documentation](https://
-        # cloud.google.com/dialogflow/es/docs/training).
+        # Deletes entities in the specified entity type. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the entity type to delete entries for. Format: `projects/
         #   /agent/entityTypes/`.
@@ -4753,9 +4960,14 @@ module Google
         
         # Updates or creates multiple entities in the specified entity type. This method
         # does not affect entities in the entity type that aren't explicitly specified
-        # in the request. Note: You should always train an agent prior to sending it
-        # queries. See the [training documentation](https://cloud.google.com/dialogflow/
-        # es/docs/training).
+        # in the request. This method is a [long-running operation](https://cloud.google.
+        # com/dialogflow/es/docs/how/long-running-operations). The returned `Operation`
+        # type has the following method-specific fields: - `metadata`: An empty [Struct
+        # message](https://developers.google.com/protocol-buffers/docs/reference/google.
+        # protobuf#struct) - `response`: An [Empty message](https://developers.google.
+        # com/protocol-buffers/docs/reference/google.protobuf#empty) Note: You should
+        # always train an agent prior to sending it queries. See the [training
+        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the entity type to update or create entities in. Format:
         #   `projects//agent/entityTypes/`.
@@ -5106,9 +5318,12 @@ module Google
         # Processes a natural language query and returns structured, actionable data 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. Note: Always use agent versions for production traffic. See [
-        # Versions and environments](https://cloud.google.com/dialogflow/es/docs/agents-
-        # versions).
+        # future queries. If you might use [Agent Assist](https://cloud.google.com/
+        # dialogflow/docs/#aa) or other CCAI products now or in the future, consider
+        # using AnalyzeContent instead of `DetectIntent`. `AnalyzeContent` has
+        # additional functionality for Agent Assist and other CCAI products. Note:
+        # Always use agent versions for production traffic. See [Versions and
+        # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
         # @param [String] session
         #   Required. The name of the session this query is sent to. Format: `projects//
         #   agent/sessions/`, or `projects//agent/environments//users//sessions/`. If `
@@ -5533,9 +5748,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes intents in the specified agent. Note: You should always train an agent
-        # prior to sending it queries. See the [training documentation](https://cloud.
-        # google.com/dialogflow/es/docs/training).
+        # Deletes intents in the specified agent. This method is a [long-running
+        # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
+        # operations). The returned `Operation` type has the following method-specific
+        # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
+        # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
+        # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
+        # google.protobuf#empty) Note: You should always train an agent prior to sending
+        # it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to delete all entities types for. Format: `
         #   projects//agent`.
@@ -5569,9 +5790,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates/Creates multiple intents in the specified agent. Note: You should
-        # always train an agent prior to sending it queries. See the [training
-        # documentation](https://cloud.google.com/dialogflow/es/docs/training).
+        # Updates/Creates multiple intents in the specified agent. This method is a [
+        # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
+        # running-operations). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: An empty [Struct message](https://developers.
+        # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
+        # : BatchUpdateIntentsResponse Note: You should always train an agent prior to
+        # sending it queries. See the [training documentation](https://cloud.google.com/
+        # dialogflow/es/docs/training).
         # @param [String] parent
         #   Required. The name of the agent to update or create intents in. Format: `
         #   projects//agent`.
@@ -5857,9 +6083,12 @@ module Google
         # Processes a natural language query and returns structured, actionable data 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. Note: Always use agent versions for production traffic. See [
-        # Versions and environments](https://cloud.google.com/dialogflow/es/docs/agents-
-        # versions).
+        # future queries. If you might use [Agent Assist](https://cloud.google.com/
+        # dialogflow/docs/#aa) or other CCAI products now or in the future, consider
+        # using AnalyzeContent instead of `DetectIntent`. `AnalyzeContent` has
+        # additional functionality for Agent Assist and other CCAI products. Note:
+        # Always use agent versions for production traffic. See [Versions and
+        # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
         # @param [String] session
         #   Required. The name of the session this query is sent to. Format: `projects//
         #   agent/sessions/`, or `projects//agent/environments//users//sessions/`. If `
@@ -7357,7 +7586,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new document. Operation
+        # Creates a new document. This method is a [long-running operation](https://
+        # cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
+        # Operation` type has the following method-specific fields: - `metadata`:
+        # KnowledgeOperationMetadata - `response`: Document
         # @param [String] parent
         #   Required. The knowledge base to create a document for. Format: `projects//
         #   locations//knowledgeBases/`.
@@ -7391,7 +7623,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified document. Operation
+        # Deletes the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: An [Empty message](https://
+        # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
         # @param [String] name
         #   Required. The name of the document to delete. Format: `projects//locations//
         #   knowledgeBases//documents/`.
@@ -7491,7 +7727,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified document. Operation
+        # Updates the specified document. This method is a [long-running operation](
+        # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
+        # returned `Operation` type has the following method-specific fields: - `
+        # metadata`: KnowledgeOperationMetadata - `response`: Document
         # @param [String] name
         #   Optional. The document resource name. The name must be empty when creating a
         #   document. Format: `projects//locations//knowledgeBases//documents/`.
@@ -7533,9 +7772,12 @@ module Google
         # Reloads the specified document from its specified source, content_uri or
         # content. The previously loaded content of the document will be deleted. Note:
         # Even when the content of the document has not changed, there still may be side
-        # effects because of internal implementation changes. Note: The `projects.agent.
-        # knowledgeBases.documents` resource is deprecated; only use `projects.
-        # knowledgeBases.documents`. Operation
+        # effects because of internal implementation changes. This method is a [long-
+        # running operation](https://cloud.google.com/dialogflow/cx/docs/how/long-
+        # running-operation). The returned `Operation` type has the following method-
+        # specific fields: - `metadata`: KnowledgeOperationMetadata - `response`:
+        # Document Note: The `projects.agent.knowledgeBases.documents` resource is
+        # deprecated; only use `projects.knowledgeBases.documents`.
         # @param [String] name
         #   Required. The name of the document to reload. Format: `projects//locations//
         #   knowledgeBases//documents/`