feat(regenerate): regenerate services based on current api definitions

Author: mamoonraja

lib/ibm_watson/assistant_v1.rb

@@ -17,6 +17,9 @@
 # The IBM Watson™ Assistant service combines machine learning, natural language
 # understanding, and an integrated dialog editor to create conversation flows between your
 # apps and your users.
+#
+# The Assistant v1 API provides authoring methods your application can use to create or
+# update a workspace.
 
 require "concurrent"
 require "erb"
@@ -72,8 +75,8 @@ def initialize(args = {})
     # Get response to user input.
     # Send user input to a workspace and receive a response.
     #
-    #   **Note:** For most applications, there are significant advantages to using the v2
-    #   runtime API instead. These advantages include ease of deployment, automatic state
+    #   **Important:** This method has been superseded by the new v2 runtime API. The v2
+    #   API offers significant advantages, including ease of deployment, automatic state
     #   management, versioning, and search capabilities. For more information, see the
     #   [documentation](https://cloud.ibm.com/docs/services/assistant?topic=assistant-api-overview).
     #

lib/ibm_watson/assistant_v2.rb

@@ -17,6 +17,9 @@
 # The IBM Watson™ Assistant service combines machine learning, natural language
 # understanding, and an integrated dialog editor to create conversation flows between your
 # apps and your users.
+#
+# The Assistant v2 API provides runtime methods your client application can use to send
+# user input to an assistant and receive a response.
 
 require "concurrent"
 require "erb"

lib/ibm_watson/text_to_speech_v1.rb

@@ -158,7 +158,8 @@ def get_voice(voice:, customization_id: nil)
     #    The service can return audio in the following formats (MIME types).
     #   * Where indicated, you can optionally specify the sampling rate (`rate`) of the
     #   audio. You must specify a sampling rate for the `audio/l16` and `audio/mulaw`
-    #   formats. A specified sampling rate must lie in the range of 8 kHz to 192 kHz.
+    #   formats. A specified sampling rate must lie in the range of 8 kHz to 192 kHz. Some
+    #   formats restrict the sampling rate to certain values, as noted.
     #   * For the `audio/l16` format, you can optionally specify the endianness
     #   (`endianness`) of the audio: `endianness=big-endian` or
     #   `endianness=little-endian`.
@@ -167,55 +168,33 @@ def get_voice(voice:, customization_id: nil)
     #   of the response audio. If you omit an audio format altogether, the service returns
     #   the audio in Ogg format with the Opus codec (`audio/ogg;codecs=opus`). The service
     #   always returns single-channel audio.
-    #   * `audio/basic`
-    #
-    #     The service returns audio with a sampling rate of 8000 Hz.
-    #   * `audio/flac`
-    #
-    #     You can optionally specify the `rate` of the audio. The default sampling rate is
-    #   22,050 Hz.
-    #   * `audio/l16`
-    #
-    #     You must specify the `rate` of the audio. You can optionally specify the
-    #   `endianness` of the audio. The default endianness is `little-endian`.
-    #   * `audio/mp3`
-    #
-    #     You can optionally specify the `rate` of the audio. The default sampling rate is
-    #   22,050 Hz.
-    #   * `audio/mpeg`
-    #
-    #     You can optionally specify the `rate` of the audio. The default sampling rate is
-    #   22,050 Hz.
-    #   * `audio/mulaw`
-    #
-    #     You must specify the `rate` of the audio.
-    #   * `audio/ogg`
-    #
-    #     The service returns the audio in the `vorbis` codec. You can optionally specify
-    #   the `rate` of the audio. The default sampling rate is 22,050 Hz.
-    #   * `audio/ogg;codecs=opus`
-    #
-    #     You can optionally specify the `rate` of the audio. The default sampling rate is
-    #   22,050 Hz.
-    #   * `audio/ogg;codecs=vorbis`
-    #
-    #     You can optionally specify the `rate` of the audio. The default sampling rate is
-    #   22,050 Hz.
-    #   * `audio/wav`
-    #
-    #     You can optionally specify the `rate` of the audio. The default sampling rate is
-    #   22,050 Hz.
-    #   * `audio/webm`
-    #
-    #     The service returns the audio in the `opus` codec. The service returns audio
-    #   with a sampling rate of 48,000 Hz.
-    #   * `audio/webm;codecs=opus`
-    #
-    #     The service returns audio with a sampling rate of 48,000 Hz.
-    #   * `audio/webm;codecs=vorbis`
-    #
-    #     You can optionally specify the `rate` of the audio. The default sampling rate is
-    #   22,050 Hz.
+    #   * `audio/basic` - The service returns audio with a sampling rate of 8000 Hz.
+    #   * `audio/flac` - You can optionally specify the `rate` of the audio. The default
+    #   sampling rate is 22,050 Hz.
+    #   * `audio/l16` - You must specify the `rate` of the audio. You can optionally
+    #   specify the `endianness` of the audio. The default endianness is `little-endian`.
+    #   * `audio/mp3` - You can optionally specify the `rate` of the audio. The default
+    #   sampling rate is 22,050 Hz.
+    #   * `audio/mpeg` - You can optionally specify the `rate` of the audio. The default
+    #   sampling rate is 22,050 Hz.
+    #   * `audio/mulaw` - You must specify the `rate` of the audio.
+    #   * `audio/ogg` - The service returns the audio in the `vorbis` codec. You can
+    #   optionally specify the `rate` of the audio. The default sampling rate is 22,050
+    #   Hz.
+    #   * `audio/ogg;codecs=opus` - You can optionally specify the `rate` of the audio.
+    #   Only the following values are valid sampling rates: `48000`, `24000`, `16000`,
+    #   `12000`, or `8000`. If you specify a value other than one of these, the service
+    #   returns an error. The default sampling rate is 48,000 Hz.
+    #   * `audio/ogg;codecs=vorbis` - You can optionally specify the `rate` of the audio.
+    #   The default sampling rate is 22,050 Hz.
+    #   * `audio/wav` - You can optionally specify the `rate` of the audio. The default
+    #   sampling rate is 22,050 Hz.
+    #   * `audio/webm` - The service returns the audio in the `opus` codec. The service
+    #   returns audio with a sampling rate of 48,000 Hz.
+    #   * `audio/webm;codecs=opus` - The service returns audio with a sampling rate of
+    #   48,000 Hz.
+    #   * `audio/webm;codecs=vorbis` - You can optionally specify the `rate` of the audio.
+    #   The default sampling rate is 22,050 Hz.
     #
     #   For more information about specifying an audio format, including additional
     #   details about some of the formats, see [Audio

lib/ibm_watson/visual_recognition_v4.rb

@@ -81,8 +81,8 @@ def initialize(args = {})
     #   Encode the image and .zip file names in UTF-8 if they contain non-ASCII
     #   characters. The service assumes UTF-8 encoding if it encounters non-ASCII
     #   characters.
-    # @param collection_ids [Array[String]] An array of IDs of the collections to analyze. Separate multiple values with commas.
-    # @param features [Array[String]] An array of features to analyze. Separate multiple values with commas.
+    # @param collection_ids [Array[String]] The IDs of the collections to analyze.
+    # @param features [Array[String]] The features to analyze.
     # @param images_file [Array[FileWithMetadata]] An array of image files (.jpg or .png) or .zip files with images.
     #   - Include a maximum of 20 images in a request.
     #   - Limit the .zip file to 100 MB.
@@ -582,7 +582,7 @@ def train(collection_id:)
     #   - To delete the training data, provide an empty value for the training data.
     # @param collection_id [String] The identifier of the collection.
     # @param image_id [String] The identifier of the image.
-    # @param objects [Array[BaseObject]] Training data for specific objects.
+    # @param objects [Array[TrainingDataObject]] Training data for specific objects.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def add_image_training_data(collection_id:, image_id:, objects: nil)
       raise ArgumentError.new("collection_id must be provided") if collection_id.nil?