Merge pull request #514 from watson-developer-cloud/release-08-22

SDK Release 08-2022

Author: kevinkowa

.secrets.baseline

@@ -3,7 +3,7 @@
     "files": "package-lock.json|^.secrets.baseline$",
     "lines": null
   },
-  "generated_at": "2022-03-18T19:36:41Z",
+  "generated_at": "2022-08-09T14:20:08Z",
   "plugins_used": [
     {
       "name": "AWSKeyDetector"
@@ -82,15 +82,15 @@
         "hashed_secret": "939999726d2023fca902233e45790c08081dc91b",
         "is_secret": false,
         "is_verified": false,
-        "line_number": 67,
+        "line_number": 92,
         "type": "Hex High Entropy String",
         "verified_result": null
       },
       {
         "hashed_secret": "edb6d1eb73ea2d50a6b29b7f3f66862b9fd515a8",
         "is_secret": false,
         "is_verified": false,
-        "line_number": 94,
+        "line_number": 119,
         "type": "Hex High Entropy String",
         "verified_result": null
       }
@@ -100,7 +100,7 @@
         "hashed_secret": "5d700c5e6706768a3f86c4e52318e9f640fdeeee",
         "is_secret": false,
         "is_verified": false,
-        "line_number": 34,
+        "line_number": 36,
         "type": "Secret Keyword",
         "verified_result": null
       }
@@ -252,7 +252,7 @@
         "hashed_secret": "f36082ba942225c26353b911fd9beb809e5322be",
         "is_secret": false,
         "is_verified": false,
-        "line_number": 1288,
+        "line_number": 1349,
         "type": "Secret Keyword",
         "verified_result": null
       }
@@ -312,7 +312,7 @@
       }
     ]
   },
-  "version": "0.13.1+ibm.47.dss",
+  "version": "0.13.1+ibm.50.dss",
   "word_list": {
     "file": null,
     "hash": null

src/IBM.Watson.Assistant.v1/AssistantService.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2021.
+* (C) Copyright IBM Corp. 2018, 2022.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -30,6 +30,9 @@ public partial interface IAssistantService
         DetailedResponse<Workspace> GetWorkspace(string workspaceId, bool? export = null, bool? includeAudit = null, string sort = null);
         DetailedResponse<Workspace> UpdateWorkspace(string workspaceId, string name = null, string description = null, string language = null, List<DialogNode> dialogNodes = null, List<Counterexample> counterexamples = null, Dictionary<string, object> metadata = null, bool? learningOptOut = null, WorkspaceSystemSettings systemSettings = null, List<Webhook> webhooks = null, List<CreateIntent> intents = null, List<CreateEntity> entities = null, bool? append = null, bool? includeAudit = null);
         DetailedResponse<object> DeleteWorkspace(string workspaceId);
+        DetailedResponse<Workspace> CreateWorkspaceAsync(string name = null, string description = null, string language = null, List<DialogNode> dialogNodes = null, List<Counterexample> counterexamples = null, Dictionary<string, object> metadata = null, bool? learningOptOut = null, WorkspaceSystemSettings systemSettings = null, List<Webhook> webhooks = null, List<CreateIntent> intents = null, List<CreateEntity> entities = null);
+        DetailedResponse<Workspace> UpdateWorkspaceAsync(string workspaceId, string name = null, string description = null, string language = null, List<DialogNode> dialogNodes = null, List<Counterexample> counterexamples = null, Dictionary<string, object> metadata = null, bool? learningOptOut = null, WorkspaceSystemSettings systemSettings = null, List<Webhook> webhooks = null, List<CreateIntent> intents = null, List<CreateEntity> entities = null, bool? append = null);
+        DetailedResponse<Workspace> ExportWorkspaceAsync(string workspaceId, bool? includeAudit = null, string sort = null, bool? verbose = null);
         DetailedResponse<IntentCollection> ListIntents(string workspaceId, bool? export = null, long? pageLimit = null, bool? includeCount = null, string sort = null, string cursor = null, bool? includeAudit = null);
         DetailedResponse<Intent> CreateIntent(string workspaceId, string intent, string description = null, List<Example> examples = null, bool? includeAudit = null);
         DetailedResponse<Intent> GetIntent(string workspaceId, string intent, bool? export = null, bool? includeAudit = null);

src/IBM.Watson.Assistant.v1/IAssistantService.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2019.
+* (C) Copyright IBM Corp. 2018, 2022.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -30,7 +30,8 @@ public class RuntimeIntent
         [JsonProperty("intent", NullValueHandling = NullValueHandling.Ignore)]
         public string Intent { get; set; }
         /// <summary>
-        /// A decimal percentage that represents Watson's confidence in the intent.
+        /// A decimal percentage that represents Watson's confidence in the intent. If you are specifying an intent as
+        /// part of a request, but you do not have a calculated confidence value, specify `1`.
         /// </summary>
         [JsonProperty("confidence", NullValueHandling = NullValueHandling.Ignore)]
         public double? Confidence { get; set; }

src/IBM.Watson.Assistant.v1/Model/RuntimeIntent.cs

@@ -0,0 +1,34 @@
+/**
+* (C) Copyright IBM Corp. 2022.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*      http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* 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.
+*
+*/
+
+using Newtonsoft.Json;
+
+namespace IBM.Watson.Assistant.v1.Model
+{
+    /// <summary>
+    /// An object describing an error that occurred during processing of an asynchronous operation.
+    /// </summary>
+    public class StatusError
+    {
+        /// <summary>
+        /// The text of the error message.
+        /// </summary>
+        [JsonProperty("message", NullValueHandling = NullValueHandling.Ignore)]
+        public string Message { get; set; }
+    }
+
+}

src/IBM.Watson.Assistant.v1/Model/StatusError.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2018, 2022.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -27,26 +27,37 @@ namespace IBM.Watson.Assistant.v1.Model
     public class Workspace
     {
         /// <summary>
-        /// The current status of the workspace.
+        /// The current status of the workspace:
+        ///  - **Available**: The workspace is available and ready to process messages.
+        ///  - **Failed**: An asynchronous operation has failed. See the **status_errors** property for more information
+        /// about the cause of the failure. Returned only by the **Export workspace asynchronously** method.
+        ///  - **Non Existent**: The workspace does not exist.
+        ///  - **Processing**: An asynchronous operation has not yet completed. Returned only by the **Export workspace
+        /// asynchronously** method.
+        ///  - **Training**: The workspace is training based on new data such as intents or examples.
         /// </summary>
         public class StatusEnumValue
         {
             /// <summary>
-            /// Constant NON_EXISTENT for Non Existent
-            /// </summary>
-            public const string NON_EXISTENT = "Non Existent";
-            /// <summary>
-            /// Constant TRAINING for Training
+            /// Constant AVAILABLE for Available
             /// </summary>
-            public const string TRAINING = "Training";
+            public const string AVAILABLE = "Available";
             /// <summary>
             /// Constant FAILED for Failed
             /// </summary>
             public const string FAILED = "Failed";
             /// <summary>
-            /// Constant AVAILABLE for Available
+            /// Constant NON_EXISTENT for Non Existent
             /// </summary>
-            public const string AVAILABLE = "Available";
+            public const string NON_EXISTENT = "Non Existent";
+            /// <summary>
+            /// Constant PROCESSING for Processing
+            /// </summary>
+            public const string PROCESSING = "Processing";
+            /// <summary>
+            /// Constant TRAINING for Training
+            /// </summary>
+            public const string TRAINING = "Training";
             /// <summary>
             /// Constant UNAVAILABLE for Unavailable
             /// </summary>
@@ -55,7 +66,14 @@ public class StatusEnumValue
         }
 
         /// <summary>
-        /// The current status of the workspace.
+        /// The current status of the workspace:
+        ///  - **Available**: The workspace is available and ready to process messages.
+        ///  - **Failed**: An asynchronous operation has failed. See the **status_errors** property for more information
+        /// about the cause of the failure. Returned only by the **Export workspace asynchronously** method.
+        ///  - **Non Existent**: The workspace does not exist.
+        ///  - **Processing**: An asynchronous operation has not yet completed. Returned only by the **Export workspace
+        /// asynchronously** method.
+        ///  - **Training**: The workspace is training based on new data such as intents or examples.
         /// Constants for possible values can be found using Workspace.StatusEnumValue
         /// </summary>
         [JsonProperty("status", NullValueHandling = NullValueHandling.Ignore)]
@@ -117,6 +135,11 @@ public class StatusEnumValue
         [JsonProperty("system_settings", NullValueHandling = NullValueHandling.Ignore)]
         public WorkspaceSystemSettings SystemSettings { get; set; }
         /// <summary>
+        /// An array of messages about errors that caused an asynchronous operation to fail.
+        /// </summary>
+        [JsonProperty("status_errors", NullValueHandling = NullValueHandling.Ignore)]
+        public virtual List<StatusError> StatusErrors { get; private set; }
+        /// <summary>
         /// Gets or Sets Webhooks
         /// </summary>
         [JsonProperty("webhooks", NullValueHandling = NullValueHandling.Ignore)]
@@ -131,6 +154,13 @@ public class StatusEnumValue
         /// </summary>
         [JsonProperty("entities", NullValueHandling = NullValueHandling.Ignore)]
         public List<Entity> Entities { get; set; }
+        /// <summary>
+        /// An object containing properties that indicate how many intents, entities, and dialog nodes are defined in
+        /// the workspace. This property is included only in responses from the **Export workspace asynchronously**
+        /// method, and only when the **verbose** query parameter is set to `true`.
+        /// </summary>
+        [JsonProperty("counts", NullValueHandling = NullValueHandling.Ignore)]
+        public WorkspaceCounts Counts { get; set; }
     }
 
 }

src/IBM.Watson.Assistant.v1/Model/Workspace.cs

@@ -0,0 +1,46 @@
+/**
+* (C) Copyright IBM Corp. 2022.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*      http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* 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.
+*
+*/
+
+using Newtonsoft.Json;
+
+namespace IBM.Watson.Assistant.v1.Model
+{
+    /// <summary>
+    /// An object containing properties that indicate how many intents, entities, and dialog nodes are defined in the
+    /// workspace. This property is included only in responses from the **Export workspace asynchronously** method, and
+    /// only when the **verbose** query parameter is set to `true`.
+    /// </summary>
+    public class WorkspaceCounts
+    {
+        /// <summary>
+        /// The number of intents defined in the workspace.
+        /// </summary>
+        [JsonProperty("intent", NullValueHandling = NullValueHandling.Ignore)]
+        public long? Intent { get; set; }
+        /// <summary>
+        /// The number of entities defined in the workspace.
+        /// </summary>
+        [JsonProperty("entity", NullValueHandling = NullValueHandling.Ignore)]
+        public long? Entity { get; set; }
+        /// <summary>
+        /// The number of nodes defined in the workspace.
+        /// </summary>
+        [JsonProperty("node", NullValueHandling = NullValueHandling.Ignore)]
+        public long? Node { get; set; }
+    }
+
+}

src/IBM.Watson.Assistant.v1/Model/WorkspaceCounts.cs

@@ -64,6 +64,11 @@ public class WorkspaceSystemSettings : DynamicModel<object>
         /// </summary>
         [JsonProperty("off_topic", NullValueHandling = NullValueHandling.Ignore)]
         public WorkspaceSystemSettingsOffTopic OffTopic { get; set; }
+        /// <summary>
+        /// Workspace settings related to the version of the training algorithms currently used by the skill.
+        /// </summary>
+        [JsonProperty("nlp", NullValueHandling = NullValueHandling.Ignore)]
+        public WorkspaceSystemSettingsNlp Nlp { get; set; }
     }
 
 }

src/IBM.Watson.Assistant.v1/Model/WorkspaceSystemSettings.cs

@@ -0,0 +1,57 @@
+/**
+* (C) Copyright IBM Corp. 2022.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*      http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* 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.
+*
+*/
+
+using Newtonsoft.Json;
+
+namespace IBM.Watson.Assistant.v1.Model
+{
+    /// <summary>
+    /// Workspace settings related to the version of the training algorithms currently used by the skill.
+    /// </summary>
+    public class WorkspaceSystemSettingsNlp
+    {
+        /// <summary>
+        /// The policy the skill follows for selecting the algorithm version to use:
+        ///
+        ///  - `baseline`: the latest mature version
+        ///  - `beta`: the latest beta version.
+        /// </summary>
+        public class ModelEnumValue
+        {
+            /// <summary>
+            /// Constant BASELINE for baseline
+            /// </summary>
+            public const string BASELINE = "baseline";
+            /// <summary>
+            /// Constant BETA for beta
+            /// </summary>
+            public const string BETA = "beta";
+            
+        }
+
+        /// <summary>
+        /// The policy the skill follows for selecting the algorithm version to use:
+        ///
+        ///  - `baseline`: the latest mature version
+        ///  - `beta`: the latest beta version.
+        /// Constants for possible values can be found using WorkspaceSystemSettingsNlp.ModelEnumValue
+        /// </summary>
+        [JsonProperty("model", NullValueHandling = NullValueHandling.Ignore)]
+        public string Model { get; set; }
+    }
+
+}