Merge pull request #682 from watson-developer-cloud/unity-sdk-9721

Unity SDK Generation 5.3.0

Scripts/Services/Assistant/V1/AssistantService.cs

@@ -16,7 +16,7 @@
 */
 
 /**
-* IBM OpenAPI SDK Code Generator Version: 99-SNAPSHOT-902c9336-20210513-140138
+* IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 */
 
 using System.Collections.Generic;
@@ -43,7 +43,7 @@ public partial class AssistantService : BaseService
         /// <summary>
         /// Gets and sets the version of the service.
         /// Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is
-        /// `2020-04-01`.
+        /// `2021-06-14`.
         /// </summary>
         public string Version
         {
@@ -68,30 +68,30 @@ public bool DisableSslVerification
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-04-01`.</param>
+        /// The current version is `2021-06-14`.</param>
         public AssistantService(string version) : this(version, defaultServiceName, ConfigBasedAuthenticatorFactory.GetAuthenticator(defaultServiceName)) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-04-01`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="authenticator">The service authenticator.</param>
         public AssistantService(string version, Authenticator authenticator) : this(version, defaultServiceName, authenticator) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-04-01`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="serviceName">The service name to be used when configuring the client instance</param>
         public AssistantService(string version, string serviceName) : this(version, serviceName, ConfigBasedAuthenticatorFactory.GetAuthenticator(serviceName)) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-04-01`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="serviceName">The service name to be used when configuring the client instance</param>
         /// <param name="authenticator">The service authenticator.</param>
         public AssistantService(string version, string serviceName, Authenticator authenticator) : base(authenticator, serviceName)
@@ -4605,8 +4605,8 @@ private void OnListLogsResponse(RESTConnector.Request req, RESTConnector.Respons
         /// <param name="callback">The callback function that is invoked when the operation completes.</param>
         /// <param name="filter">A cacheable parameter that limits the results to those matching the specified filter.
         /// You must specify a filter query that includes a value for `language`, as well as a value for
-        /// `request.context.system.assistant_id`, `workspace_id`, or `request.context.metadata.deployment`. For more
-        /// information, see the
+        /// `request.context.system.assistant_id`, `workspace_id`, or `request.context.metadata.deployment`. These
+        /// required filters must be specified using the exact match (`::`) operator. For more information, see the
         /// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-filter-reference#filter-reference).</param>
         /// <param name="sort">How to sort the returned log events. You can sort by **request_timestamp**. To reverse
         /// the sort order, prefix the parameter value with a minus sign (`-`). (optional)</param>

Scripts/Services/Assistant/V1/Model/DialogNodeOutputGeneric.cs

@@ -161,7 +161,7 @@ public class QueryTypeValue
         [JsonProperty("typing", NullValueHandling = NullValueHandling.Ignore)]
         public bool? Typing { get; protected set; }
         /// <summary>
-        /// The URL of the image.
+        /// The `https:` URL of the image.
         /// </summary>
         [JsonProperty("source", NullValueHandling = NullValueHandling.Ignore)]
         public string Source { get; protected set; }
@@ -176,6 +176,11 @@ public class QueryTypeValue
         [JsonProperty("description", NullValueHandling = NullValueHandling.Ignore)]
         public string Description { get; protected set; }
         /// <summary>
+        /// Descriptive text that can be used for screen readers or other situations where the image cannot be seen.
+        /// </summary>
+        [JsonProperty("alt_text", NullValueHandling = NullValueHandling.Ignore)]
+        public string AltText { get; protected set; }
+        /// <summary>
         /// An array of objects describing the options from which the user can choose. You can include up to 20 options.
         /// </summary>
         [JsonProperty("options", NullValueHandling = NullValueHandling.Ignore)]

Scripts/Services/Assistant/V1/Model/DialogNodeOutputGenericDialogNodeOutputResponseTypeImage.cs

@@ -36,7 +36,7 @@ public class DialogNodeOutputGenericDialogNodeOutputResponseTypeImage : DialogNo
             set { base.ResponseType = value; }
         }
         /// <summary>
-        /// The URL of the image.
+        /// The `https:` URL of the image.
         /// </summary>
         [JsonProperty("source", NullValueHandling = NullValueHandling.Ignore)]
         public new string Source
@@ -71,5 +71,14 @@ public class DialogNodeOutputGenericDialogNodeOutputResponseTypeImage : DialogNo
             get { return base.Channels; }
             set { base.Channels = value; }
         }
+        /// <summary>
+        /// Descriptive text that can be used for screen readers or other situations where the image cannot be seen.
+        /// </summary>
+        [JsonProperty("alt_text", NullValueHandling = NullValueHandling.Ignore)]
+        public new string AltText
+        {
+            get { return base.AltText; }
+            set { base.AltText = value; }
+        }
     }
 }

Scripts/Services/Assistant/V1/Model/RuntimeEntity.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2018, 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -47,7 +47,10 @@ public class RuntimeEntity
         [JsonProperty("confidence", NullValueHandling = NullValueHandling.Ignore)]
         public float? Confidence { get; set; }
         /// <summary>
-        /// Any metadata for the entity.
+        /// **Deprecated.** Any metadata for the entity.
+        ///
+        /// Beginning with the `2021-06-14` API version, the `metadata` property is no longer returned. For information
+        /// about system entities recognized in the user input, see the `interpretation` property.
         /// </summary>
         [JsonProperty("metadata", NullValueHandling = NullValueHandling.Ignore)]
         public Dictionary<string, object> Metadata { get; set; }

Scripts/Services/Assistant/V1/Model/RuntimeResponseGeneric.cs

@@ -108,7 +108,7 @@ public class PreferenceValue
         [JsonProperty("typing", NullValueHandling = NullValueHandling.Ignore)]
         public bool? Typing { get; protected set; }
         /// <summary>
-        /// The URL of the image.
+        /// The `https:` URL of the image.
         /// </summary>
         [JsonProperty("source", NullValueHandling = NullValueHandling.Ignore)]
         public string Source { get; protected set; }
@@ -123,6 +123,11 @@ public class PreferenceValue
         [JsonProperty("description", NullValueHandling = NullValueHandling.Ignore)]
         public string Description { get; protected set; }
         /// <summary>
+        /// Descriptive text that can be used for screen readers or other situations where the image cannot be seen.
+        /// </summary>
+        [JsonProperty("alt_text", NullValueHandling = NullValueHandling.Ignore)]
+        public string AltText { get; protected set; }
+        /// <summary>
         /// An array of objects describing the options from which the user can choose.
         /// </summary>
         [JsonProperty("options", NullValueHandling = NullValueHandling.Ignore)]

Scripts/Services/Assistant/V1/Model/RuntimeResponseGenericRuntimeResponseTypeImage.cs

@@ -36,7 +36,7 @@ public class RuntimeResponseGenericRuntimeResponseTypeImage : RuntimeResponseGen
             set { base.ResponseType = value; }
         }
         /// <summary>
-        /// The URL of the image.
+        /// The `https:` URL of the image.
         /// </summary>
         [JsonProperty("source", NullValueHandling = NullValueHandling.Ignore)]
         public new string Source
@@ -72,5 +72,14 @@ public class RuntimeResponseGenericRuntimeResponseTypeImage : RuntimeResponseGen
             get { return base.Channels; }
             set { base.Channels = value; }
         }
+        /// <summary>
+        /// Descriptive text that can be used for screen readers or other situations where the image cannot be seen.
+        /// </summary>
+        [JsonProperty("alt_text", NullValueHandling = NullValueHandling.Ignore)]
+        public new string AltText
+        {
+            get { return base.AltText; }
+            set { base.AltText = value; }
+        }
     }
 }

Scripts/Services/Assistant/V1/Model/WorkspaceSystemSettingsDisambiguation.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2019, 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -25,8 +25,8 @@ namespace IBM.Watson.Assistant.V1.Model
     public class WorkspaceSystemSettingsDisambiguation
     {
         /// <summary>
-        /// The sensitivity of the disambiguation feature to intent detection conflicts. Set to **high** if you want the
-        /// disambiguation feature to be triggered more often. This can be useful for testing or demonstration purposes.
+        /// The sensitivity of the disambiguation feature to intent detection uncertainty. Higher sensitivity means that
+        /// the disambiguation feature is triggered more often and includes more choices.
         /// </summary>
         public class SensitivityValue
         {
@@ -38,12 +38,28 @@ public class SensitivityValue
             /// Constant HIGH for high
             /// </summary>
             public const string HIGH = "high";
+            /// <summary>
+            /// Constant MEDIUM_HIGH for medium_high
+            /// </summary>
+            public const string MEDIUM_HIGH = "medium_high";
+            /// <summary>
+            /// Constant MEDIUM for medium
+            /// </summary>
+            public const string MEDIUM = "medium";
+            /// <summary>
+            /// Constant MEDIUM_LOW for medium_low
+            /// </summary>
+            public const string MEDIUM_LOW = "medium_low";
+            /// <summary>
+            /// Constant LOW for low
+            /// </summary>
+            public const string LOW = "low";
 
         }
 
         /// <summary>
-        /// The sensitivity of the disambiguation feature to intent detection conflicts. Set to **high** if you want the
-        /// disambiguation feature to be triggered more often. This can be useful for testing or demonstration purposes.
+        /// The sensitivity of the disambiguation feature to intent detection uncertainty. Higher sensitivity means that
+        /// the disambiguation feature is triggered more often and includes more choices.
         /// Constants for possible values can be found using WorkspaceSystemSettingsDisambiguation.SensitivityValue
         /// </summary>
         [JsonProperty("sensitivity", NullValueHandling = NullValueHandling.Ignore)]

Scripts/Services/Assistant/V2/AssistantService.cs

@@ -16,7 +16,7 @@
 */
 
 /**
-* IBM OpenAPI SDK Code Generator Version: 99-SNAPSHOT-902c9336-20210513-140138
+* IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 */
 
 using System.Collections.Generic;
@@ -43,7 +43,7 @@ public partial class AssistantService : BaseService
         /// <summary>
         /// Gets and sets the version of the service.
         /// Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is
-        /// `2020-09-24`.
+        /// `2021-06-14`.
         /// </summary>
         public string Version
         {
@@ -68,30 +68,30 @@ public bool DisableSslVerification
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-09-24`.</param>
+        /// The current version is `2021-06-14`.</param>
         public AssistantService(string version) : this(version, defaultServiceName, ConfigBasedAuthenticatorFactory.GetAuthenticator(defaultServiceName)) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-09-24`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="authenticator">The service authenticator.</param>
         public AssistantService(string version, Authenticator authenticator) : this(version, defaultServiceName, authenticator) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-09-24`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="serviceName">The service name to be used when configuring the client instance</param>
         public AssistantService(string version, string serviceName) : this(version, serviceName, ConfigBasedAuthenticatorFactory.GetAuthenticator(serviceName)) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-09-24`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="serviceName">The service name to be used when configuring the client instance</param>
         /// <param name="authenticator">The service authenticator.</param>
         public AssistantService(string version, string serviceName, Authenticator authenticator) : base(authenticator, serviceName)

Scripts/Services/Assistant/V2/Model/MessageContextGlobalSystem.cs

@@ -136,12 +136,31 @@ public class LocaleValue
         /// `tomorrow`. This can be useful for simulating past or future times for testing purposes, or when analyzing
         /// documents such as news articles.
         ///
-        /// This value must be a UTC time value formatted according to ISO 8601 (for example, `2019-06-26T12:00:00Z` for
-        /// noon on 26 June 2019.
+        /// This value must be a UTC time value formatted according to ISO 8601 (for example, `2021-06-26T12:00:00Z` for
+        /// noon UTC on 26 June 2021).
         ///
         /// This property is included only if the new system entities are enabled for the skill.
         /// </summary>
         [JsonProperty("reference_time", NullValueHandling = NullValueHandling.Ignore)]
         public string ReferenceTime { get; set; }
+        /// <summary>
+        /// The time at which the session started. With the stateful `message` method, the start time is always present,
+        /// and is set by the service based on the time the session was created. With the stateless `message` method,
+        /// the start time is set by the service in the response to the first message, and should be returned as part of
+        /// the context with each subsequent message in the session.
+        ///
+        /// This value is a UTC time value formatted according to ISO 8601 (for example, `2021-06-26T12:00:00Z` for noon
+        /// UTC on 26 June 2021).
+        /// </summary>
+        [JsonProperty("session_start_time", NullValueHandling = NullValueHandling.Ignore)]
+        public string SessionStartTime { get; set; }
+        /// <summary>
+        /// An encoded string that represents the configuration state of the assistant at the beginning of the
+        /// conversation. If you are using the stateless `message` method, save this value and then send it in the
+        /// context of the subsequent message request to avoid disruptions if there are configuration changes during the
+        /// conversation (such as a change to a skill the assistant uses).
+        /// </summary>
+        [JsonProperty("state", NullValueHandling = NullValueHandling.Ignore)]
+        public string State { get; set; }
     }
 }

Scripts/Services/Assistant/V2/Model/MessageInput.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2018, 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -26,19 +26,33 @@ namespace IBM.Watson.Assistant.V2.Model
     public class MessageInput
     {
         /// <summary>
-        /// The type of user input. Currently, only text input is supported.
+        /// The type of the message:
+        ///
+        /// - `text`: The user input is processed normally by the assistant.
+        /// - `search`: Only search results are returned. (Any dialog or actions skill is bypassed.)
+        ///
+        /// **Note:** A `search` message results in an error if no search skill is configured for the assistant.
         /// </summary>
         public class MessageTypeValue
         {
             /// <summary>
             /// Constant TEXT for text
             /// </summary>
             public const string TEXT = "text";
+            /// <summary>
+            /// Constant SEARCH for search
+            /// </summary>
+            public const string SEARCH = "search";
 
         }
 
         /// <summary>
-        /// The type of user input. Currently, only text input is supported.
+        /// The type of the message:
+        ///
+        /// - `text`: The user input is processed normally by the assistant.
+        /// - `search`: Only search results are returned. (Any dialog or actions skill is bypassed.)
+        ///
+        /// **Note:** A `search` message results in an error if no search skill is configured for the assistant.
         /// Constants for possible values can be found using MessageInput.MessageTypeValue
         /// </summary>
         [JsonProperty("message_type", NullValueHandling = NullValueHandling.Ignore)]