|
1 | 1 |
|
| 2 | +# 4.0.0 (Preview) (https://github.com/watson-developer-cloud/swift-sdk/compare/3.6.0...4.0.0) (2020-10-29) |
| 3 | + |
| 4 | +## Breaking Changes |
| 5 | + |
| 6 | +### All Services |
| 7 | +* `init` now accepts a `serviceName` parameter to set the default service name of the instance |
| 8 | + |
| 9 | +### AssistantV1 Instance |
| 10 | + |
| 11 | +* Now Accepts `includeCount` Parameter: `listWorkspaces()`, `listIntents()`, `listExamples()`, `listCounterexamples()`, `listEntities()`, `listValues()`, `listSynonyms()`, `listDialogNodes()`, |
| 12 | +* `createWorkspace()`: function parameter reordering |
| 13 | +* `updateWorkspace()`: function parameter reordering |
| 14 | +* `createDialogNode()`: parameter `context` type change from `[Sting: JSON]?` to `DialogNodeContext?` |
| 15 | +* `updateDialogNode()`: parameter `newContext` type change from `[Sting: JSON]?` to `DialogNodeContext?` |
| 16 | +* `bulkClassify()`: function added - Identify intents and entities in multiple user utterances. |
| 17 | + |
| 18 | + |
| 19 | +### AssistantV1 Models |
| 20 | + |
| 21 | +#### Models Added |
| 22 | +`BulkClassifyOutput`, `BulkClassifyResponse`, `BulkClassifyUtterance`, `DialogNodeContext`, `DialogNodeOutputConnectToAgentTransferInfo`, `DialogNodeOutputGenericDialogNodeOutputResponseTypeConnectToAgent`, `DialogNodeOutputGenericDialogNodeOutputResponseTypeImage`, `DialogNodeOutputGenericDialogNodeOutputResponseTypeOption`, `DialogNodeOutputGenericDialogNodeOutputResponseTypePause`, `DialogNodeOutputGenericDialogNodeOutputResponseTypeSearchSkill`, `DialogNodeOutputGenericDialogNodeOutputResponseTypeText`, `RuntimeResponseGenericRuntimeResponseTypeConnectToAgent`, `RuntimeResponseGenericRuntimeResponseTypeImage`, `RuntimeResponseGenericRuntimeResponseTypeOption`, `RuntimeResponseGenericRuntimeResponseTypePause`, `RuntimeResponseGenericRuntimeResponseTypeSuggestion`, `RuntimeResponseGenericRuntimeResponseTypeText` |
| 23 | + |
| 24 | +#### Models Removed |
| 25 | +`CreateWorkspace`, `DialogNodeSuggestionOutput`, `DialogSuggestionResponseGeneric`, `SystemResponse`, `UpdateCounterexample`, `UpdateDialogNode`, `UpdateEntity`, `UpdateExample`, `UpdateIntent`, `UpdateSynonym`, `UpdateValue`, `UpdateWorkspace`, `WorkspaceSystemSettings`, `WorkspaceSystemSettingsDisambiguation`, `WorkspaceSystemSettingsOffTopic`, `WorkspaceSystemSettingsSystemEntities`, `WorkspaceSystemSettingsTooling`, `WorkspaceSystemSettings`, |
| 26 | + |
| 27 | +#### Model Properties Changed |
| 28 | +`Context` |
| 29 | +* `system` type changed from `SystemResponse?` to `[String: JSON]?` |
| 30 | +`DialogSuggestion` |
| 31 | +* `output` type changed from `DialogSuggestionOutput?` to `[String: JSON]?` |
| 32 | +`Counterexample`, `CreateEntity`, `CreateIntent`, `CreateValue`, `Example`, `Synonym` |
| 33 | +* `created` read only |
| 34 | +* `updated` read only |
| 35 | +`DialogNodeOutput` |
| 36 | +* `integrations` added |
| 37 | +`MessageInput` |
| 38 | +* `suggestedText` read only |
| 39 | +* `originalText` read only |
| 40 | +`MessageRequest` |
| 41 | +* `actions` read only |
| 42 | +`Webhook` |
| 43 | +* `headers` renamed to `xheaders` |
| 44 | + |
| 45 | +#### Multiple/Unique Changes |
| 46 | +`DialogNode` |
| 47 | +* `context` type changed from `[String: JSON]?` to `DialogNodeContext?` |
| 48 | +* `disabled` parameter removed |
| 49 | +* `created` parameter removed |
| 50 | +* `updated` parameter removed |
| 51 | + |
| 52 | +`DialogNodeOutputGeneric` |
| 53 | +* Changed from struct to enum to discriminate between response types |
| 54 | +`RuntimeResponseGeneric` |
| 55 | +* Changed from struct to enum to discriminate between response types |
| 56 | + |
| 57 | + |
| 58 | +### AssistantV2 Instance |
| 59 | + |
| 60 | +* `bulkClassify()`: function added - Identify intents and entities in multiple user utterances. |
| 61 | + |
| 62 | +### AssistantV2 Models |
| 63 | + |
| 64 | +#### Models Added |
| 65 | +`BulkClassifyOutput`, `BulkClassifyResponse`, `BulkClassifyUtterance`, `DialogNodeOutputConnectToAgentTransferInfo`, `RuntimeResponseGenericRuntimeResponseTypeConnectToAgent`, `RuntimeResponseGenericRuntimeResponseTypeImage`, `RuntimeResponseGenericRuntimeResponseTypeOption`, `RuntimeResponseGenericRuntimeResponseTypePause`, `RuntimeResponseGenericRuntimeResponseTypeSuggestion`, `RuntimeResponseGenericRuntimeResponseTypeText` |
| 66 | +#### Models Removed |
| 67 | +`MessageContextSkills`, `MessageRequestStateless` |
| 68 | +#### Model Properties Changed |
| 69 | +`MessageContextGlobal` |
| 70 | +* `system` read only |
| 71 | +`MessageContext`, `MessageContextStateless` |
| 72 | +* `skills` type changed from `MessageContextSkills?` to `[String: MessageContextSkill]?` |
| 73 | +`MessageInputOptions` |
| 74 | +* model parameters repositioned |
| 75 | +#### Multiple/Unique Changes |
| 76 | +`RuntimeResponseGeneric` |
| 77 | +* Changed from struct to enum to discriminate between response types |
| 78 | + |
| 79 | +### CompareComplyV1 Instance |
| 80 | + |
| 81 | +`listFeedback()`: `before` and `after` parameters removed |
| 82 | + |
| 83 | +### CompareComplyV1 Models |
| 84 | + |
| 85 | +#### Models Removed |
| 86 | +`FeedbackInput` |
| 87 | + |
| 88 | +#### Model Properties Changed |
| 89 | +`Category`, `TypeLabel` |
| 90 | +* `modification` added |
| 91 | +`OriginalLabelsOut`, `UpdatedLabelsOut` |
| 92 | +* `modification` removed |
| 93 | + |
| 94 | +### DiscoveryV1 Instance |
| 95 | + |
| 96 | +* No changes |
| 97 | + |
| 98 | +### DiscoveryV1 Models |
| 99 | + |
| 100 | +#### Models Removed |
| 101 | +`CollQueryLarge`, `CreateCollectionRequest`, `CreateEnvironmentRequest`, `CreateEventObject`, `FedQueryLarge`, `GatewayName`, `GenericQueryAggregation`, `NewTrainingQuery`, `NluEnrichmentCategories`, `QueryLarge`, `TokenDict`, `TrainingExamplePatch`, `UpdateCollectionRequest`, `UpdateEnvironmentRequest` |
| 102 | +#### Model Prroperties Changed |
| 103 | +`Configuration` |
| 104 | +* `created` read only |
| 105 | +* `updated` read only |
| 106 | +* `configurationID` read only |
| 107 | +`Credentials` |
| 108 | +* `credentialID` read only |
| 109 | +`EventData` |
| 110 | +* `queryID` read only |
| 111 | +`NluEnrichmentFeatures` |
| 112 | +* `categories` type changed from `NluEnrichmentCategories?` to `[String: JSON]?` |
| 113 | + |
| 114 | +### DiscoveryV2 Instance |
| 115 | + |
| 116 | +`analyzeDocument()`: function added - Process a document using the specified collection's settings and return it for realtime use. - Currently CP4D only |
| 117 | + |
| 118 | +### DiscoveryV2 Models |
| 119 | + |
| 120 | +#### Models Added |
| 121 | +`AnalyzedDocument`, `AnalyzedResult`, `QueryResponsePassage`, ` |
| 122 | +#### Models Removed |
| 123 | +`GenericQueryAggregation`, `ProjectCreation`, `ProjectName`, `QueryLarge`, `QueryNoticesResult`, `UpdateCollection`, `UpdateEnrichment` |
| 124 | +#### Model Properties Changed |
| 125 | +`CollectionDetails` |
| 126 | +* `collectionID` read only |
| 127 | +* `created` read only |
| 128 | +`QueryResponse` |
| 129 | +* `passages` added |
| 130 | +`TrainingExample` |
| 131 | +* `created` read only |
| 132 | +* `updated` read only |
| 133 | +`TraningQuery` |
| 134 | +* `created` read only |
| 135 | +* `updated` read only |
| 136 | +* `queryID` read only |
| 137 | + |
| 138 | +### LanguageTranslator Instance |
| 139 | +* No changes |
| 140 | + |
| 141 | +### LanguageTranslatorV3 Models |
| 142 | + |
| 143 | +#### Models Removed |
| 144 | +`TranslateRequest` |
| 145 | + |
| 146 | +### NaturalLanguageClassifierV1 Instance |
| 147 | +* No changes |
| 148 | + |
| 149 | +### NaturalLanguageClassifierV1 Models |
| 150 | + |
| 151 | +#### Models Removed |
| 152 | +`ClassifyCollectionInput` |
| 153 | + |
| 154 | +### NaturalLanguageUnderstanding Instance |
| 155 | +* No changes |
| 156 | + |
| 157 | +### NaturalLanguageUnderstandingV1 Models |
| 158 | + |
| 159 | +#### Models Added |
| 160 | +`FeaturesResultsMetadata` |
| 161 | +#### Models Removed |
| 162 | +`AnalysisResultsMetadata`, `MetadataOptions`, `Parameters` |
| 163 | +#### Model Properties Changed |
| 164 | +`AnalysisResults` |
| 165 | +* `metadata` type changed from `AnalysisResultsMetadata?` to `FeaturesResultsMetadata?` |
| 166 | +`Features` |
| 167 | +* `metadata` type changed from `MetadataOptions?` to `[String: JSON]?` |
| 168 | + |
| 169 | +### PersonalityInsights Instance |
| 170 | +* `profile()`: csvHeaders parameter added |
| 171 | +* `profileAsCSV()`: return type changed from `WatsonResponse<String>?` to `WatsonResponse<Data>?` |
| 172 | + |
| 173 | +### PersonalityInightsV3 Models |
| 174 | +* No changes |
| 175 | + |
| 176 | +### SpeechToTextV1 Instance |
| 177 | +`trainLanguageModel()`: return type changed from `WatsonResponse<Void>?` to `WatsonResponse<TrainingResponse>?` |
| 178 | +`trainAcousticModel()`: return type changed from `WatsonResponse<Void>?` to `WatsonResponse<TrainingResponse>?` |
| 179 | + |
| 180 | +### SpeechToTextV1 Models |
| 181 | +* No changes |
| 182 | + |
| 183 | +#### Models Removed |
| 184 | +`CreateAcousticModel`, `CreateLanguageModel`, `CustomWords` |
| 185 | + |
| 186 | +### TextToSpeechV1 Instance |
| 187 | +* `createVoiceModel()`: function changed to `createCustomModel()` now returning `WatsonResponse<CustomModel>?` |
| 188 | +* `listVoiceModels()`: function changed to `listCustomModels()` now returning `WatsonResponse<CustomModels>?` |
| 189 | +* `updateVoiceModel()`: function changed to `updateCustomModel()` |
| 190 | +* `getVoiceModel()`: function changed to `getCustomModel()` now returning `WatsonResponse<CustomModel>?` |
| 191 | +* `deleteVoiceModel()`: function changed to `deleteCustomModel()` |
| 192 | + |
| 193 | +### TextToSpeechV1 Models |
| 194 | + |
| 195 | +#### Models Added |
| 196 | +`CustomModel`, `CustomModels` |
| 197 | +#### Models Removed |
| 198 | +`CreateVoiceModel`, `Text`, `UpdateVoiceModel`, `VoiceModel`, `VoiceModels` |
| 199 | +#### Model Properties Changed |
| 200 | +`Voice` |
| 201 | +* customization type changed from `VoiceModel?` to `CustomModel?` |
| 202 | + |
| 203 | +### ToneAnalyzer Instance |
| 204 | +* `tone()`: `tones` parameter added |
| 205 | + |
| 206 | +### ToneAnalyzerV3 Models |
| 207 | + |
| 208 | +#### Models Removed |
| 209 | +`ToneChatInput` |
| 210 | + |
| 211 | +### VisualRecognitionV3 Instance |
| 212 | +* No changes |
| 213 | + |
| 214 | +### VisualRecognitionV3 Models |
| 215 | +* No changes |
| 216 | + |
| 217 | +### VisualRecognitionV4 Instance |
| 218 | +* `createCollection()`: `trainingStatus` parameter added |
| 219 | +* `updateCollection()`: `trainingStatus` parameter added |
| 220 | +* `getTrainingUsage()`: `startTime` and `endTime` parameter types changed from `String?` to `Date?` |
| 221 | + |
| 222 | +### VisualRecognitionV4 Models |
| 223 | + |
| 224 | +#### Models Added |
| 225 | +`CollectionTrainingStatus`, `ObjectDetailLocation` |
| 226 | +#### Models Removed |
| 227 | +`BaseCollection`, `BaseTrainingDataObjects` |
| 228 | +#### Model Properties Changed |
| 229 | +`Collection` |
| 230 | +* `trainingStatus` type changed from `TrainingStatus` to `CollectionTrainingStatus` |
| 231 | +`ObjectDetail` |
| 232 | +* `location` type changed from `Location` to `ObjectDetailLocation` |
| 233 | +`UpdateObjectMetadata` |
| 234 | +* `count` read only |
| 235 | + |
2 | 236 | ## 3.0.0 (Preview) (https://github.com/watson-developer-cloud/swift-sdk/compare/2.3.0...3.0.0) (2019-10-04) |
3 | 237 |
|
4 | 238 | ### Breaking Changes |
|
0 commit comments