RubyGems - google-apis-dialogflow_v2 - Versions diffs - 0.19.0 → 0.23.0 - Mend

google-apis-dialogflow_v2 0.19.0 → 0.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +16 -0
data/OVERVIEW.md +2 -2
data/lib/google/apis/dialogflow_v2/classes.rb +421 -9
data/lib/google/apis/dialogflow_v2/gem_version.rb +2 -2
data/lib/google/apis/dialogflow_v2/representations.rb +186 -0
data/lib/google/apis/dialogflow_v2/service.rb +332 -90
data/lib/google/apis/dialogflow_v2.rb +1 -1
metadata +5 -5

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

@@ -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/`