ibm_watson 1.6.0 → 2.1.0

data/lib/ibm_watson/language_translator_v3.rb

@@ -13,7 +13,9 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
+#
+# IBM OpenAPI SDK Code Generator Version: 3.31.0-902c9336-20210504-161156
+#
 # IBM Watson™ Language Translator translates text from one language to another.
 # The service offers multiple IBM-provided translation models that you can customize based
 # on your unique terminology and language. Use Language Translator to take news from
@@ -26,7 +28,6 @@ require "json"
 require "ibm_cloud_sdk_core"
 require_relative "./common.rb"
 
-# Module for the Watson APIs
 module IBMWatson
   ##
   # The Language Translator V3 service.
@@ -34,21 +35,14 @@ module IBMWatson
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "language_translator"
     DEFAULT_SERVICE_URL = "https://api.us-south.language-translator.watson.cloud.ibm.com"
+    attr_accessor :version
     ##
     # @!method initialize(args)
     # Construct a new client for the Language Translator service.
     #
     # @param args [Hash] The args to initialize with
-    # @option args version [String] The API version date to use with the service, in
-    #   "YYYY-MM-DD" format. Whenever the API is changed in a backwards
-    #   incompatible way, a new minor version of the API is released.
-    #   The service uses the API version for the date you specify, or
-    #   the most recent version before that date. Note that you should
-    #   not programmatically specify the current date at runtime, in
-    #   case the API has been updated since your application's release.
-    #   Instead, specify a version date that is compatible with your
-    #   application, and don't change it until your application is
-    #   ready for a later version.
+    # @option args version [String] Release date of the version of the API you want to use. Specify dates in
+    #   YYYY-MM-DD format. The current version is `2018-05-01`.
     # @option args service_url [String] The base service URL to use when contacting the service.
     #   The base service_url may differ between IBM Cloud regions.
     # @option args authenticator [Object] The Authenticator instance to be configured for this service.
@@ -57,10 +51,10 @@ module IBMWatson
     def initialize(args = {})
       @__async_initialized__ = false
       defaults = {}
-      defaults[:version] = nil
       defaults[:service_url] = DEFAULT_SERVICE_URL
       defaults[:service_name] = DEFAULT_SERVICE_NAME
       defaults[:authenticator] = nil
+      defaults[:version] = nil
       user_service_url = args[:service_url] unless args[:service_url].nil?
       args = defaults.merge(args)
       @version = args[:version]
@@ -78,11 +72,16 @@ module IBMWatson
     ##
     # @!method list_languages
     # List supported languages.
-    # Lists all supported languages. The method returns an array of supported languages
-    #   with information about each language. Languages are listed in alphabetical order
-    #   by language code (for example, `af`, `ar`).
+    # Lists all supported languages for translation. The method returns an array of
+    #   supported languages with information about each language. Languages are listed in
+    #   alphabetical order by language code (for example, `af`, `ar`). In addition to
+    #   basic information about each language, the response indicates whether the language
+    #   is `supported_as_source` for translation and `supported_as_target` for
+    #   translation. It also lists whether the language is `identifiable`.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_languages
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("language_translator", "V3", "list_languages")
@@ -116,8 +115,12 @@ module IBMWatson
     #   service attempt to detect the language from the input text. If you omit the source
     #   language, the request must contain sufficient input text for the service to
     #   identify the source language.
-    # @param text [Array[String]] Input text in UTF-8 encoding. Multiple entries result in multiple translations in
-    #   the response.
+    #
+    #   You can translate a maximum of 50 KB (51,200 bytes) of text with a single request.
+    #   All input text must be encoded in UTF-8 format.
+    # @param text [Array[String]] Input text in UTF-8 encoding. Submit a maximum of 50 KB (51,200 bytes) of text
+    #   with a single request. Multiple elements result in multiple translations in the
+    #   response.
     # @param model_id [String] The model to use for translation. For example, `en-de` selects the IBM-provided
     #   base model for English-to-German translation. A model ID overrides the `source`
     #   and `target` parameters and is required if you use a custom model. If no model ID
@@ -129,6 +132,8 @@ module IBMWatson
     #   model ID is not specified.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def translate(text:, model_id: nil, source: nil, target: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("text must be provided") if text.nil?
 
       headers = {
@@ -170,6 +175,8 @@ module IBMWatson
     #   example, `en` for English or `es` for Spanish) and name of each language.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_identifiable_languages
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("language_translator", "V3", "list_identifiable_languages")
@@ -198,6 +205,8 @@ module IBMWatson
     # @param text [String] Input text in UTF-8 format.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def identify(text:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("text must be provided") if text.nil?
 
       headers = {
@@ -241,6 +250,8 @@ module IBMWatson
     #   model, per language pair.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_models(source: nil, target: nil, default: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("language_translator", "V3", "list_models")
@@ -302,9 +313,13 @@ module IBMWatson
     #   * **XLIFF** (`.xliff`) - XML Localization Interchange File Format (XLIFF) is an
     #   XML specification for the exchange of translation memories.
     #   * **CSV** (`.csv`) - Comma-separated values (CSV) file with two columns for
-    #   aligned sentences and phrases. The first row contains the language code.
+    #   aligned sentences and phrases. The first row must have two language codes. The
+    #   first column is for the source language code, and the second column is for the
+    #   target language code.
     #   * **TSV** (`.tsv` or `.tab`) - Tab-separated values (TSV) file with two columns
-    #   for aligned sentences and phrases. The first row contains the language code.
+    #   for aligned sentences and phrases. The first row must have two language codes. The
+    #   first column is for the source language code, and the second column is for the
+    #   target language code.
     #   * **JSON** (`.json`) - Custom JSON format for specifying aligned sentences and
     #   phrases.
     #   * **Microsoft Excel** (`.xls` or `.xlsx`) - Excel file with the first two columns
@@ -365,6 +380,8 @@ module IBMWatson
     #   length of the name is 32 characters.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def create_model(base_model_id:, forced_glossary: nil, parallel_corpus: nil, name: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("base_model_id must be provided") if base_model_id.nil?
 
       headers = {
@@ -414,6 +431,8 @@ module IBMWatson
     # @param model_id [String] Model ID of the model to delete.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def delete_model(model_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("model_id must be provided") if model_id.nil?
 
       headers = {
@@ -446,6 +465,8 @@ module IBMWatson
     # @param model_id [String] Model ID of the model to get.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_model(model_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("model_id must be provided") if model_id.nil?
 
       headers = {
@@ -478,6 +499,8 @@ module IBMWatson
     # Lists documents that have been submitted for translation.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_documents
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("language_translator", "V3", "list_documents")
@@ -504,13 +527,14 @@ module IBMWatson
     # Translate document.
     # Submit a document for translation. You can submit the document contents in the
     #   `file` parameter, or you can reference a previously submitted document by document
-    #   ID.
-    # @param file [File] The contents of the source file to translate.
-    #
-    #   [Supported file
-    #   types](https://cloud.ibm.com/docs/language-translator?topic=language-translator-document-translator-tutorial#supported-file-formats)
-    #
-    #   Maximum file size: **20 MB**.
+    #   ID. The maximum file size for document translation is
+    #   * 20 MB for service instances on the Standard, Advanced, and Premium plans
+    #   * 2 MB for service instances on the Lite plan.
+    # @param file [File] The contents of the source file to translate. The maximum file size for document
+    #   translation is 20 MB for service instances on the Standard, Advanced, and Premium
+    #   plans, and 2 MB for service instances on the Lite plan. For more information, see
+    #   [Supported file formats
+    #   (Beta)](https://cloud.ibm.com/docs/language-translator?topic=language-translator-document-translator-tutorial#supported-file-formats).
     # @param filename [String] The filename for file.
     # @param file_content_type [String] The content type of file.
     # @param model_id [String] The model to use for translation. For example, `en-de` selects the IBM-provided
@@ -526,6 +550,8 @@ module IBMWatson
     #   the `document_id` of the document.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def translate_document(file:, filename: nil, file_content_type: nil, model_id: nil, source: nil, target: nil, document_id: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("file must be provided") if file.nil?
 
       headers = {
@@ -573,6 +599,8 @@ module IBMWatson
     # @param document_id [String] The document ID of the document.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_document_status(document_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("document_id must be provided") if document_id.nil?
 
       headers = {
@@ -603,6 +631,8 @@ module IBMWatson
     # @param document_id [String] Document ID of the document to delete.
     # @return [nil]
     def delete_document(document_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("document_id must be provided") if document_id.nil?
 
       headers = {
@@ -646,6 +676,8 @@ module IBMWatson
     #   example, 'text/html;charset=utf-8'.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_translated_document(document_id:, accept: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("document_id must be provided") if document_id.nil?
 
       headers = {

data/lib/ibm_watson/natural_language_classifier_v1.rb

@@ -13,7 +13,9 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
+#
+# IBM OpenAPI SDK Code Generator Version: 3.31.0-902c9336-20210504-161156
+#
 # IBM Watson™ Natural Language Classifier uses machine learning algorithms to
 # return the top matching predefined classes for short text input. You create and train a
 # classifier to connect predefined classes to example texts so that the service can apply
@@ -25,7 +27,6 @@ require "json"
 require "ibm_cloud_sdk_core"
 require_relative "./common.rb"
 
-# Module for the Watson APIs
 module IBMWatson
   ##
   # The Natural Language Classifier V1 service.

data/lib/ibm_watson/natural_language_understanding_v1.rb

@@ -13,7 +13,9 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
+#
+# IBM OpenAPI SDK Code Generator Version: 3.31.0-902c9336-20210504-161156
+#
 # Analyze various features of text content at scale. Provide text, raw HTML, or a public
 # URL and IBM Watson Natural Language Understanding will give you results for the features
 # you request. The service cleans HTML content before analysis by default, so the results
@@ -30,7 +32,6 @@ require "json"
 require "ibm_cloud_sdk_core"
 require_relative "./common.rb"
 
-# Module for the Watson APIs
 module IBMWatson
   ##
   # The Natural Language Understanding V1 service.
@@ -38,21 +39,14 @@ module IBMWatson
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "natural_language_understanding"
     DEFAULT_SERVICE_URL = "https://api.us-south.natural-language-understanding.watson.cloud.ibm.com"
+    attr_accessor :version
     ##
     # @!method initialize(args)
     # Construct a new client for the Natural Language Understanding service.
     #
     # @param args [Hash] The args to initialize with
-    # @option args version [String] The API version date to use with the service, in
-    #   "YYYY-MM-DD" format. Whenever the API is changed in a backwards
-    #   incompatible way, a new minor version of the API is released.
-    #   The service uses the API version for the date you specify, or
-    #   the most recent version before that date. Note that you should
-    #   not programmatically specify the current date at runtime, in
-    #   case the API has been updated since your application's release.
-    #   Instead, specify a version date that is compatible with your
-    #   application, and don't change it until your application is
-    #   ready for a later version.
+    # @option args version [String] Release date of the API version you want to use. Specify dates in YYYY-MM-DD
+    #   format. The current version is `2021-03-25`.
     # @option args service_url [String] The base service URL to use when contacting the service.
     #   The base service_url may differ between IBM Cloud regions.
     # @option args authenticator [Object] The Authenticator instance to be configured for this service.
@@ -61,10 +55,10 @@ module IBMWatson
     def initialize(args = {})
       @__async_initialized__ = false
       defaults = {}
-      defaults[:version] = nil
       defaults[:service_url] = DEFAULT_SERVICE_URL
       defaults[:service_name] = DEFAULT_SERVICE_NAME
       defaults[:authenticator] = nil
+      defaults[:version] = nil
       user_service_url = args[:service_url] unless args[:service_url].nil?
       args = defaults.merge(args)
       @version = args[:version]
@@ -84,6 +78,7 @@ module IBMWatson
     # Analyze text.
     # Analyzes text, HTML, or a public webpage for the following features:
     #   - Categories
+    #   - Classifications
     #   - Concepts
     #   - Emotion
     #   - Entities
@@ -92,7 +87,8 @@ module IBMWatson
     #   - Relations
     #   - Semantic roles
     #   - Sentiment
-    #   - Syntax.
+    #   - Syntax
+    #   - Summarization (Experimental)
     #
     #   If a language for the input text is not specified with the `language` parameter,
     #   the service [automatically detects the
@@ -121,6 +117,8 @@ module IBMWatson
     # @param limit_text_characters [Fixnum] Sets the maximum number of characters that are processed by the service.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def analyze(features:, text: nil, html: nil, url: nil, clean: nil, xpath: nil, fallback_to_raw: nil, return_analyzed_text: nil, language: nil, limit_text_characters: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("features must be provided") if features.nil?
 
       headers = {
@@ -169,6 +167,8 @@ module IBMWatson
     #   that are deployed to your Natural Language Understanding service.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_models
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       headers = {
       }
       sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "list_models")
@@ -197,6 +197,8 @@ module IBMWatson
     # @param model_id [String] Model ID of the model to delete.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def delete_model(model_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("model_id must be provided") if model_id.nil?
 
       headers = {
@@ -210,6 +212,695 @@ module IBMWatson
 
       method_url = "/v1/models/%s" % [ERB::Util.url_encode(model_id)]
 
+      response = request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+    #########################
+    # Manage sentiment models
+    #########################
+
+    ##
+    # @!method create_sentiment_model(language:, training_data:, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+    # Create sentiment model.
+    # (Beta) Creates a custom sentiment model by uploading training data and associated
+    #   metadata. The model begins the training and deploying process and is ready to use
+    #   when the `status` is `available`.
+    # @param language [String] The 2-letter language code of this model.
+    # @param training_data [File] Training data in CSV format. For more information, see [Sentiment training data
+    #   requirements](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-custom-sentiment#sentiment-training-data-requirements).
+    # @param name [String] An optional name for the model.
+    # @param description [String] An optional description of the model.
+    # @param model_version [String] An optional version string.
+    # @param workspace_id [String] ID of the Watson Knowledge Studio workspace that deployed this model to Natural
+    #   Language Understanding.
+    # @param version_description [String] The description of the version.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def create_sentiment_model(language:, training_data:, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("language must be provided") if language.nil?
+
+      raise ArgumentError.new("training_data must be provided") if training_data.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "create_sentiment_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      form_data = {}
+
+      form_data[:language] = HTTP::FormData::Part.new(language.to_s, content_type: "text/plain")
+
+      unless training_data.instance_of?(StringIO) || training_data.instance_of?(File)
+        training_data = training_data.respond_to?(:to_json) ? StringIO.new(training_data.to_json) : StringIO.new(training_data)
+      end
+      form_data[:training_data] = HTTP::FormData::File.new(training_data, content_type: "text/csv", filename: training_data.respond_to?(:path) ? training_data.path : nil)
+
+      form_data[:name] = HTTP::FormData::Part.new(name.to_s, content_type: "text/plain") unless name.nil?
+
+      form_data[:description] = HTTP::FormData::Part.new(description.to_s, content_type: "text/plain") unless description.nil?
+
+      form_data[:model_version] = HTTP::FormData::Part.new(model_version.to_s, content_type: "text/plain") unless model_version.nil?
+
+      form_data[:workspace_id] = HTTP::FormData::Part.new(workspace_id.to_s, content_type: "text/plain") unless workspace_id.nil?
+
+      form_data[:version_description] = HTTP::FormData::Part.new(version_description.to_s, content_type: "text/plain") unless version_description.nil?
+
+      method_url = "/v1/models/sentiment"
+
+      response = request(
+        method: "POST",
+        url: method_url,
+        headers: headers,
+        params: params,
+        form: form_data,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method list_sentiment_models
+    # List sentiment models.
+    # (Beta) Returns all custom sentiment models associated with this service instance.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_sentiment_models
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "list_sentiment_models")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/models/sentiment"
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method get_sentiment_model(model_id:)
+    # Get sentiment model details.
+    # (Beta) Returns the status of the sentiment model with the given model ID.
+    # @param model_id [String] ID of the model.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def get_sentiment_model(model_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("model_id must be provided") if model_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "get_sentiment_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/models/sentiment/%s" % [ERB::Util.url_encode(model_id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method update_sentiment_model(model_id:, language:, training_data:, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+    # Update sentiment model.
+    # (Beta) Overwrites the training data associated with this custom sentiment model
+    #   and retrains the model. The new model replaces the current deployment.
+    # @param model_id [String] ID of the model.
+    # @param language [String] The 2-letter language code of this model.
+    # @param training_data [File] Training data in CSV format. For more information, see [Sentiment training data
+    #   requirements](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-custom-sentiment#sentiment-training-data-requirements).
+    # @param name [String] An optional name for the model.
+    # @param description [String] An optional description of the model.
+    # @param model_version [String] An optional version string.
+    # @param workspace_id [String] ID of the Watson Knowledge Studio workspace that deployed this model to Natural
+    #   Language Understanding.
+    # @param version_description [String] The description of the version.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def update_sentiment_model(model_id:, language:, training_data:, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("model_id must be provided") if model_id.nil?
+
+      raise ArgumentError.new("language must be provided") if language.nil?
+
+      raise ArgumentError.new("training_data must be provided") if training_data.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "update_sentiment_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      form_data = {}
+
+      form_data[:language] = HTTP::FormData::Part.new(language.to_s, content_type: "text/plain")
+
+      unless training_data.instance_of?(StringIO) || training_data.instance_of?(File)
+        training_data = training_data.respond_to?(:to_json) ? StringIO.new(training_data.to_json) : StringIO.new(training_data)
+      end
+      form_data[:training_data] = HTTP::FormData::File.new(training_data, content_type: "text/csv", filename: training_data.respond_to?(:path) ? training_data.path : nil)
+
+      form_data[:name] = HTTP::FormData::Part.new(name.to_s, content_type: "text/plain") unless name.nil?
+
+      form_data[:description] = HTTP::FormData::Part.new(description.to_s, content_type: "text/plain") unless description.nil?
+
+      form_data[:model_version] = HTTP::FormData::Part.new(model_version.to_s, content_type: "text/plain") unless model_version.nil?
+
+      form_data[:workspace_id] = HTTP::FormData::Part.new(workspace_id.to_s, content_type: "text/plain") unless workspace_id.nil?
+
+      form_data[:version_description] = HTTP::FormData::Part.new(version_description.to_s, content_type: "text/plain") unless version_description.nil?
+
+      method_url = "/v1/models/sentiment/%s" % [ERB::Util.url_encode(model_id)]
+
+      response = request(
+        method: "PUT",
+        url: method_url,
+        headers: headers,
+        params: params,
+        form: form_data,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method delete_sentiment_model(model_id:)
+    # Delete sentiment model.
+    # (Beta) Un-deploys the custom sentiment model with the given model ID and deletes
+    #   all associated customer data, including any training data or binary artifacts.
+    # @param model_id [String] ID of the model.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def delete_sentiment_model(model_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("model_id must be provided") if model_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "delete_sentiment_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/models/sentiment/%s" % [ERB::Util.url_encode(model_id)]
+
+      response = request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+    #########################
+    # Manage categories models
+    #########################
+
+    ##
+    # @!method create_categories_model(language:, training_data:, training_data_content_type: nil, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+    # Create categories model.
+    # (Beta) Creates a custom categories model by uploading training data and associated
+    #   metadata. The model begins the training and deploying process and is ready to use
+    #   when the `status` is `available`.
+    # @param language [String] The 2-letter language code of this model.
+    # @param training_data [File] Training data in JSON format. For more information, see [Categories training data
+    #   requirements](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-categories##categories-training-data-requirements).
+    # @param training_data_content_type [String] The content type of training_data.
+    # @param name [String] An optional name for the model.
+    # @param description [String] An optional description of the model.
+    # @param model_version [String] An optional version string.
+    # @param workspace_id [String] ID of the Watson Knowledge Studio workspace that deployed this model to Natural
+    #   Language Understanding.
+    # @param version_description [String] The description of the version.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def create_categories_model(language:, training_data:, training_data_content_type: nil, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("language must be provided") if language.nil?
+
+      raise ArgumentError.new("training_data must be provided") if training_data.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "create_categories_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      form_data = {}
+
+      form_data[:language] = HTTP::FormData::Part.new(language.to_s, content_type: "text/plain")
+
+      unless training_data.instance_of?(StringIO) || training_data.instance_of?(File)
+        training_data = training_data.respond_to?(:to_json) ? StringIO.new(training_data.to_json) : StringIO.new(training_data)
+      end
+      form_data[:training_data] = HTTP::FormData::File.new(training_data, content_type: training_data_content_type.nil? ? "application/octet-stream" : training_data_content_type, filename: training_data.respond_to?(:path) ? training_data.path : nil)
+
+      form_data[:name] = HTTP::FormData::Part.new(name.to_s, content_type: "text/plain") unless name.nil?
+
+      form_data[:description] = HTTP::FormData::Part.new(description.to_s, content_type: "text/plain") unless description.nil?
+
+      form_data[:model_version] = HTTP::FormData::Part.new(model_version.to_s, content_type: "text/plain") unless model_version.nil?
+
+      form_data[:workspace_id] = HTTP::FormData::Part.new(workspace_id.to_s, content_type: "text/plain") unless workspace_id.nil?
+
+      form_data[:version_description] = HTTP::FormData::Part.new(version_description.to_s, content_type: "text/plain") unless version_description.nil?
+
+      method_url = "/v1/models/categories"
+
+      response = request(
+        method: "POST",
+        url: method_url,
+        headers: headers,
+        params: params,
+        form: form_data,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method list_categories_models
+    # List categories models.
+    # (Beta) Returns all custom categories models associated with this service instance.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_categories_models
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "list_categories_models")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/models/categories"
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method get_categories_model(model_id:)
+    # Get categories model details.
+    # (Beta) Returns the status of the categories model with the given model ID.
+    # @param model_id [String] ID of the model.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def get_categories_model(model_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("model_id must be provided") if model_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "get_categories_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/models/categories/%s" % [ERB::Util.url_encode(model_id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method update_categories_model(model_id:, language:, training_data:, training_data_content_type: nil, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+    # Update categories model.
+    # (Beta) Overwrites the training data associated with this custom categories model
+    #   and retrains the model. The new model replaces the current deployment.
+    # @param model_id [String] ID of the model.
+    # @param language [String] The 2-letter language code of this model.
+    # @param training_data [File] Training data in JSON format. For more information, see [Categories training data
+    #   requirements](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-categories##categories-training-data-requirements).
+    # @param training_data_content_type [String] The content type of training_data.
+    # @param name [String] An optional name for the model.
+    # @param description [String] An optional description of the model.
+    # @param model_version [String] An optional version string.
+    # @param workspace_id [String] ID of the Watson Knowledge Studio workspace that deployed this model to Natural
+    #   Language Understanding.
+    # @param version_description [String] The description of the version.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def update_categories_model(model_id:, language:, training_data:, training_data_content_type: nil, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("model_id must be provided") if model_id.nil?
+
+      raise ArgumentError.new("language must be provided") if language.nil?
+
+      raise ArgumentError.new("training_data must be provided") if training_data.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "update_categories_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      form_data = {}
+
+      form_data[:language] = HTTP::FormData::Part.new(language.to_s, content_type: "text/plain")
+
+      unless training_data.instance_of?(StringIO) || training_data.instance_of?(File)
+        training_data = training_data.respond_to?(:to_json) ? StringIO.new(training_data.to_json) : StringIO.new(training_data)
+      end
+      form_data[:training_data] = HTTP::FormData::File.new(training_data, content_type: training_data_content_type.nil? ? "application/octet-stream" : training_data_content_type, filename: training_data.respond_to?(:path) ? training_data.path : nil)
+
+      form_data[:name] = HTTP::FormData::Part.new(name.to_s, content_type: "text/plain") unless name.nil?
+
+      form_data[:description] = HTTP::FormData::Part.new(description.to_s, content_type: "text/plain") unless description.nil?
+
+      form_data[:model_version] = HTTP::FormData::Part.new(model_version.to_s, content_type: "text/plain") unless model_version.nil?
+
+      form_data[:workspace_id] = HTTP::FormData::Part.new(workspace_id.to_s, content_type: "text/plain") unless workspace_id.nil?
+
+      form_data[:version_description] = HTTP::FormData::Part.new(version_description.to_s, content_type: "text/plain") unless version_description.nil?
+
+      method_url = "/v1/models/categories/%s" % [ERB::Util.url_encode(model_id)]
+
+      response = request(
+        method: "PUT",
+        url: method_url,
+        headers: headers,
+        params: params,
+        form: form_data,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method delete_categories_model(model_id:)
+    # Delete categories model.
+    # (Beta) Un-deploys the custom categories model with the given model ID and deletes
+    #   all associated customer data, including any training data or binary artifacts.
+    # @param model_id [String] ID of the model.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def delete_categories_model(model_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("model_id must be provided") if model_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "delete_categories_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/models/categories/%s" % [ERB::Util.url_encode(model_id)]
+
+      response = request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+    #########################
+    # Manage classifications models
+    #########################
+
+    ##
+    # @!method create_classifications_model(language:, training_data:, training_data_content_type: nil, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+    # Create classifications model.
+    # (Beta) Creates a custom classifications model by uploading training data and
+    #   associated metadata. The model begins the training and deploying process and is
+    #   ready to use when the `status` is `available`.
+    # @param language [String] The 2-letter language code of this model.
+    # @param training_data [File] Training data in JSON format. For more information, see [Classifications training
+    #   data
+    #   requirements](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-classifications#classification-training-data-requirements).
+    # @param training_data_content_type [String] The content type of training_data.
+    # @param name [String] An optional name for the model.
+    # @param description [String] An optional description of the model.
+    # @param model_version [String] An optional version string.
+    # @param workspace_id [String] ID of the Watson Knowledge Studio workspace that deployed this model to Natural
+    #   Language Understanding.
+    # @param version_description [String] The description of the version.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def create_classifications_model(language:, training_data:, training_data_content_type: nil, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("language must be provided") if language.nil?
+
+      raise ArgumentError.new("training_data must be provided") if training_data.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "create_classifications_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      form_data = {}
+
+      form_data[:language] = HTTP::FormData::Part.new(language.to_s, content_type: "text/plain")
+
+      unless training_data.instance_of?(StringIO) || training_data.instance_of?(File)
+        training_data = training_data.respond_to?(:to_json) ? StringIO.new(training_data.to_json) : StringIO.new(training_data)
+      end
+      form_data[:training_data] = HTTP::FormData::File.new(training_data, content_type: training_data_content_type.nil? ? "application/octet-stream" : training_data_content_type, filename: training_data.respond_to?(:path) ? training_data.path : nil)
+
+      form_data[:name] = HTTP::FormData::Part.new(name.to_s, content_type: "text/plain") unless name.nil?
+
+      form_data[:description] = HTTP::FormData::Part.new(description.to_s, content_type: "text/plain") unless description.nil?
+
+      form_data[:model_version] = HTTP::FormData::Part.new(model_version.to_s, content_type: "text/plain") unless model_version.nil?
+
+      form_data[:workspace_id] = HTTP::FormData::Part.new(workspace_id.to_s, content_type: "text/plain") unless workspace_id.nil?
+
+      form_data[:version_description] = HTTP::FormData::Part.new(version_description.to_s, content_type: "text/plain") unless version_description.nil?
+
+      method_url = "/v1/models/classifications"
+
+      response = request(
+        method: "POST",
+        url: method_url,
+        headers: headers,
+        params: params,
+        form: form_data,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method list_classifications_models
+    # List classifications models.
+    # (Beta) Returns all custom classifications models associated with this service
+    #   instance.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_classifications_models
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "list_classifications_models")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/models/classifications"
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method get_classifications_model(model_id:)
+    # Get classifications model details.
+    # (Beta) Returns the status of the classifications model with the given model ID.
+    # @param model_id [String] ID of the model.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def get_classifications_model(model_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("model_id must be provided") if model_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "get_classifications_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/models/classifications/%s" % [ERB::Util.url_encode(model_id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method update_classifications_model(model_id:, language:, training_data:, training_data_content_type: nil, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+    # Update classifications model.
+    # (Beta) Overwrites the training data associated with this custom classifications
+    #   model and retrains the model. The new model replaces the current deployment.
+    # @param model_id [String] ID of the model.
+    # @param language [String] The 2-letter language code of this model.
+    # @param training_data [File] Training data in JSON format. For more information, see [Classifications training
+    #   data
+    #   requirements](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-classifications#classification-training-data-requirements).
+    # @param training_data_content_type [String] The content type of training_data.
+    # @param name [String] An optional name for the model.
+    # @param description [String] An optional description of the model.
+    # @param model_version [String] An optional version string.
+    # @param workspace_id [String] ID of the Watson Knowledge Studio workspace that deployed this model to Natural
+    #   Language Understanding.
+    # @param version_description [String] The description of the version.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def update_classifications_model(model_id:, language:, training_data:, training_data_content_type: nil, name: nil, description: nil, model_version: nil, workspace_id: nil, version_description: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("model_id must be provided") if model_id.nil?
+
+      raise ArgumentError.new("language must be provided") if language.nil?
+
+      raise ArgumentError.new("training_data must be provided") if training_data.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "update_classifications_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      form_data = {}
+
+      form_data[:language] = HTTP::FormData::Part.new(language.to_s, content_type: "text/plain")
+
+      unless training_data.instance_of?(StringIO) || training_data.instance_of?(File)
+        training_data = training_data.respond_to?(:to_json) ? StringIO.new(training_data.to_json) : StringIO.new(training_data)
+      end
+      form_data[:training_data] = HTTP::FormData::File.new(training_data, content_type: training_data_content_type.nil? ? "application/octet-stream" : training_data_content_type, filename: training_data.respond_to?(:path) ? training_data.path : nil)
+
+      form_data[:name] = HTTP::FormData::Part.new(name.to_s, content_type: "text/plain") unless name.nil?
+
+      form_data[:description] = HTTP::FormData::Part.new(description.to_s, content_type: "text/plain") unless description.nil?
+
+      form_data[:model_version] = HTTP::FormData::Part.new(model_version.to_s, content_type: "text/plain") unless model_version.nil?
+
+      form_data[:workspace_id] = HTTP::FormData::Part.new(workspace_id.to_s, content_type: "text/plain") unless workspace_id.nil?
+
+      form_data[:version_description] = HTTP::FormData::Part.new(version_description.to_s, content_type: "text/plain") unless version_description.nil?
+
+      method_url = "/v1/models/classifications/%s" % [ERB::Util.url_encode(model_id)]
+
+      response = request(
+        method: "PUT",
+        url: method_url,
+        headers: headers,
+        params: params,
+        form: form_data,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method delete_classifications_model(model_id:)
+    # Delete classifications model.
+    # (Beta) Un-deploys the custom classifications model with the given model ID and
+    #   deletes all associated customer data, including any training data or binary
+    #   artifacts.
+    # @param model_id [String] ID of the model.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def delete_classifications_model(model_id:)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
+      raise ArgumentError.new("model_id must be provided") if model_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("natural-language-understanding", "V1", "delete_classifications_model")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "version" => @version
+      }
+
+      method_url = "/v1/models/classifications/%s" % [ERB::Util.url_encode(model_id)]
+
       response = request(
         method: "DELETE",
         url: method_url,