aws-sdk-lexmodelsv2 1.13.0 → 1.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -119,7 +119,9 @@ module Aws::LexModelsV2
119
119
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
120
  # are very aggressive. Construct and pass an instance of
121
121
  # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
- # enable retries and extended timeouts.
122
+ # enable retries and extended timeouts. Instance profile credential
123
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
124
+ # to true.
123
125
  #
124
126
  # @option options [required, String] :region
125
127
  # The AWS region to connect to. The configured `:region` is
@@ -275,6 +277,15 @@ module Aws::LexModelsV2
275
277
  # ** Please note ** When response stubbing is enabled, no HTTP
276
278
  # requests are made, and retries are disabled.
277
279
  #
280
+ # @option options [Boolean] :use_dualstack_endpoint
281
+ # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
282
+ # will be used if available.
283
+ #
284
+ # @option options [Boolean] :use_fips_endpoint
285
+ # When set to `true`, fips compatible endpoints will be used if available.
286
+ # When a `fips` region is used, the region is normalized and this config
287
+ # is set to `true`.
288
+ #
278
289
  # @option options [Boolean] :validate_params (true)
279
290
  # When `true`, request parameters are validated before
280
291
  # sending the request.
@@ -333,7 +344,11 @@ module Aws::LexModelsV2
333
344
  #
334
345
  # @option params [required, String] :bot_id
335
346
  # The identifier of the bot to build. The identifier is returned in the
336
- # response from the operation.
347
+ # response from the [CreateBot][1] operation.
348
+ #
349
+ #
350
+ #
351
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/API_CreateBot.html
337
352
  #
338
353
  # @option params [required, String] :bot_version
339
354
  # The version of the bot to build. This can only be the draft version of
@@ -370,7 +385,7 @@ module Aws::LexModelsV2
370
385
  # resp.bot_id #=> String
371
386
  # resp.bot_version #=> String
372
387
  # resp.locale_id #=> String
373
- # resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"
388
+ # resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing", "Processing"
374
389
  # resp.last_build_submitted_date_time #=> Time
375
390
  #
376
391
  # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/BuildBotLocale AWS API Documentation
@@ -492,7 +507,12 @@ module Aws::LexModelsV2
492
507
  #
493
508
  # @option params [String] :bot_version
494
509
  # The version of the bot that this alias points to. You can use the
495
- # operation to change the bot version associated with the alias.
510
+ # [UpdateBotAlias][1] operation to change the bot version associated
511
+ # with the alias.
512
+ #
513
+ #
514
+ #
515
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/API_UpdateBotAlias.html
496
516
  #
497
517
  # @option params [Hash<String,Types::BotAliasLocaleSettings>] :bot_alias_locale_settings
498
518
  # Maps configuration information to a specific locale. You can use this
@@ -691,6 +711,7 @@ module Aws::LexModelsV2
691
711
  # nlu_intent_confidence_threshold: 1.0, # required
692
712
  # voice_settings: {
693
713
  # voice_id: "VoiceId", # required
714
+ # engine: "standard", # accepts standard, neural
694
715
  # },
695
716
  # })
696
717
  #
@@ -703,7 +724,8 @@ module Aws::LexModelsV2
703
724
  # resp.description #=> String
704
725
  # resp.nlu_intent_confidence_threshold #=> Float
705
726
  # resp.voice_settings.voice_id #=> String
706
- # resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"
727
+ # resp.voice_settings.engine #=> String, one of "standard", "neural"
728
+ # resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing", "Processing"
707
729
  # resp.creation_date_time #=> Time
708
730
  #
709
731
  # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateBotLocale AWS API Documentation
@@ -2549,7 +2571,7 @@ module Aws::LexModelsV2
2549
2571
  # resp.bot_id #=> String
2550
2572
  # resp.bot_version #=> String
2551
2573
  # resp.locale_id #=> String
2552
- # resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"
2574
+ # resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing", "Processing"
2553
2575
  #
2554
2576
  # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteBotLocale AWS API Documentation
2555
2577
  #
@@ -2561,7 +2583,11 @@ module Aws::LexModelsV2
2561
2583
  end
2562
2584
 
2563
2585
  # Deletes a specific version of a bot. To delete all version of a bot,
2564
- # use the DeleteBot operation.
2586
+ # use the [DeleteBot][1] operation.
2587
+ #
2588
+ #
2589
+ #
2590
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/API_DeleteBot.html
2565
2591
  #
2566
2592
  # @option params [required, String] :bot_id
2567
2593
  # The identifier of the bot that contains the version.
@@ -2895,9 +2921,10 @@ module Aws::LexModelsV2
2895
2921
  # Deletes stored utterances.
2896
2922
  #
2897
2923
  # Amazon Lex stores the utterances that users send to your bot.
2898
- # Utterances are stored for 15 days for use with the operation, and then
2899
- # stored indefinitely for use in improving the ability of your bot to
2900
- # respond to user input..
2924
+ # Utterances are stored for 15 days for use with the
2925
+ # [ListAggregatedUtterances][1] operation, and then stored indefinitely
2926
+ # for use in improving the ability of your bot to respond to user
2927
+ # input..
2901
2928
  #
2902
2929
  # Use the `DeleteUtterances` operation to manually delete utterances for
2903
2930
  # a specific session. When you use the `DeleteUtterances` operation,
@@ -2905,6 +2932,10 @@ module Aws::LexModelsV2
2905
2932
  # input are deleted immediately. Utterances stored for use with the
2906
2933
  # `ListAggregatedUtterances` operation are deleted after 15 days.
2907
2934
  #
2935
+ #
2936
+ #
2937
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/API_ListAggregatedUtterances.html
2938
+ #
2908
2939
  # @option params [required, String] :bot_id
2909
2940
  # The unique identifier of the bot that contains the utterances.
2910
2941
  #
@@ -2919,7 +2950,13 @@ module Aws::LexModelsV2
2919
2950
  #
2920
2951
  # @option params [String] :session_id
2921
2952
  # The unique identifier of the session with the user. The ID is returned
2922
- # in the response from the and operations.
2953
+ # in the response from the [RecognizeText][1] and
2954
+ # [RecognizeUtterance][2] operations.
2955
+ #
2956
+ #
2957
+ #
2958
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/API_runtime_RecognizeText.html
2959
+ # [2]: https://docs.aws.amazon.com/lexv2/latest/dg/API_runtime_RecognizeUtterance.html
2923
2960
  #
2924
2961
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2925
2962
  #
@@ -3114,9 +3151,10 @@ module Aws::LexModelsV2
3114
3151
  # resp.description #=> String
3115
3152
  # resp.nlu_intent_confidence_threshold #=> Float
3116
3153
  # resp.voice_settings.voice_id #=> String
3154
+ # resp.voice_settings.engine #=> String, one of "standard", "neural"
3117
3155
  # resp.intents_count #=> Integer
3118
3156
  # resp.slot_types_count #=> Integer
3119
- # resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"
3157
+ # resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing", "Processing"
3120
3158
  # resp.failure_reasons #=> Array
3121
3159
  # resp.failure_reasons[0] #=> String
3122
3160
  # resp.creation_date_time #=> Time
@@ -3142,6 +3180,89 @@ module Aws::LexModelsV2
3142
3180
  req.send_request(options)
3143
3181
  end
3144
3182
 
3183
+ # Provides metadata information about a bot recommendation. This
3184
+ # information will enable you to get a description on the request
3185
+ # inputs, to download associated transcripts after processing is
3186
+ # complete, and to download intents and slot-types generated by the bot
3187
+ # recommendation.
3188
+ #
3189
+ # @option params [required, String] :bot_id
3190
+ # The unique identifier of the bot associated with the bot
3191
+ # recommendation.
3192
+ #
3193
+ # @option params [required, String] :bot_version
3194
+ # The version of the bot associated with the bot recommendation.
3195
+ #
3196
+ # @option params [required, String] :locale_id
3197
+ # The identifier of the language and locale of the bot recommendation to
3198
+ # describe. The string must match one of the supported locales. For more
3199
+ # information, see [Supported languages][1].
3200
+ #
3201
+ #
3202
+ #
3203
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html
3204
+ #
3205
+ # @option params [required, String] :bot_recommendation_id
3206
+ # The identifier of the bot recommendation to describe.
3207
+ #
3208
+ # @return [Types::DescribeBotRecommendationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3209
+ #
3210
+ # * {Types::DescribeBotRecommendationResponse#bot_id #bot_id} => String
3211
+ # * {Types::DescribeBotRecommendationResponse#bot_version #bot_version} => String
3212
+ # * {Types::DescribeBotRecommendationResponse#locale_id #locale_id} => String
3213
+ # * {Types::DescribeBotRecommendationResponse#bot_recommendation_status #bot_recommendation_status} => String
3214
+ # * {Types::DescribeBotRecommendationResponse#bot_recommendation_id #bot_recommendation_id} => String
3215
+ # * {Types::DescribeBotRecommendationResponse#failure_reasons #failure_reasons} => Array&lt;String&gt;
3216
+ # * {Types::DescribeBotRecommendationResponse#creation_date_time #creation_date_time} => Time
3217
+ # * {Types::DescribeBotRecommendationResponse#last_updated_date_time #last_updated_date_time} => Time
3218
+ # * {Types::DescribeBotRecommendationResponse#transcript_source_setting #transcript_source_setting} => Types::TranscriptSourceSetting
3219
+ # * {Types::DescribeBotRecommendationResponse#encryption_setting #encryption_setting} => Types::EncryptionSetting
3220
+ # * {Types::DescribeBotRecommendationResponse#bot_recommendation_results #bot_recommendation_results} => Types::BotRecommendationResults
3221
+ #
3222
+ # @example Request syntax with placeholder values
3223
+ #
3224
+ # resp = client.describe_bot_recommendation({
3225
+ # bot_id: "Id", # required
3226
+ # bot_version: "DraftBotVersion", # required
3227
+ # locale_id: "LocaleId", # required
3228
+ # bot_recommendation_id: "Id", # required
3229
+ # })
3230
+ #
3231
+ # @example Response structure
3232
+ #
3233
+ # resp.bot_id #=> String
3234
+ # resp.bot_version #=> String
3235
+ # resp.locale_id #=> String
3236
+ # resp.bot_recommendation_status #=> String, one of "Processing", "Deleting", "Deleted", "Downloading", "Updating", "Available", "Failed"
3237
+ # resp.bot_recommendation_id #=> String
3238
+ # resp.failure_reasons #=> Array
3239
+ # resp.failure_reasons[0] #=> String
3240
+ # resp.creation_date_time #=> Time
3241
+ # resp.last_updated_date_time #=> Time
3242
+ # resp.transcript_source_setting.s3_bucket_transcript_source.s3_bucket_name #=> String
3243
+ # resp.transcript_source_setting.s3_bucket_transcript_source.path_format.object_prefixes #=> Array
3244
+ # resp.transcript_source_setting.s3_bucket_transcript_source.path_format.object_prefixes[0] #=> String
3245
+ # resp.transcript_source_setting.s3_bucket_transcript_source.transcript_format #=> String, one of "Lex"
3246
+ # resp.transcript_source_setting.s3_bucket_transcript_source.transcript_filter.lex_transcript_filter.date_range_filter.start_date_time #=> Time
3247
+ # resp.transcript_source_setting.s3_bucket_transcript_source.transcript_filter.lex_transcript_filter.date_range_filter.end_date_time #=> Time
3248
+ # resp.transcript_source_setting.s3_bucket_transcript_source.kms_key_arn #=> String
3249
+ # resp.encryption_setting.kms_key_arn #=> String
3250
+ # resp.encryption_setting.bot_locale_export_password #=> String
3251
+ # resp.encryption_setting.associated_transcripts_password #=> String
3252
+ # resp.bot_recommendation_results.bot_locale_export_url #=> String
3253
+ # resp.bot_recommendation_results.associated_transcripts_url #=> String
3254
+ # resp.bot_recommendation_results.statistics.intents.discovered_intent_count #=> Integer
3255
+ # resp.bot_recommendation_results.statistics.slot_types.discovered_slot_type_count #=> Integer
3256
+ #
3257
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeBotRecommendation AWS API Documentation
3258
+ #
3259
+ # @overload describe_bot_recommendation(params = {})
3260
+ # @param [Hash] params ({})
3261
+ def describe_bot_recommendation(params = {}, options = {})
3262
+ req = build_request(:describe_bot_recommendation, params)
3263
+ req.send_request(options)
3264
+ end
3265
+
3145
3266
  # Provides metadata about a version of a bot.
3146
3267
  #
3147
3268
  # @option params [required, String] :bot_id
@@ -3290,9 +3411,10 @@ module Aws::LexModelsV2
3290
3411
  # resp.resource_specification.bot_locale_import_specification.locale_id #=> String
3291
3412
  # resp.resource_specification.bot_locale_import_specification.nlu_intent_confidence_threshold #=> Float
3292
3413
  # resp.resource_specification.bot_locale_import_specification.voice_settings.voice_id #=> String
3414
+ # resp.resource_specification.bot_locale_import_specification.voice_settings.engine #=> String, one of "standard", "neural"
3293
3415
  # resp.imported_resource_id #=> String
3294
3416
  # resp.imported_resource_name #=> String
3295
- # resp.merge_strategy #=> String, one of "Overwrite", "FailOnConflict"
3417
+ # resp.merge_strategy #=> String, one of "Overwrite", "FailOnConflict", "Append"
3296
3418
  # resp.import_status #=> String, one of "InProgress", "Completed", "Failed", "Deleting"
3297
3419
  # resp.failure_reasons #=> Array
3298
3420
  # resp.failure_reasons[0] #=> String
@@ -4104,7 +4226,7 @@ module Aws::LexModelsV2
4104
4226
  # resp.bot_locale_summaries[0].locale_id #=> String
4105
4227
  # resp.bot_locale_summaries[0].locale_name #=> String
4106
4228
  # resp.bot_locale_summaries[0].description #=> String
4107
- # resp.bot_locale_summaries[0].bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"
4229
+ # resp.bot_locale_summaries[0].bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing", "Processing"
4108
4230
  # resp.bot_locale_summaries[0].last_updated_date_time #=> Time
4109
4231
  # resp.bot_locale_summaries[0].last_build_submitted_date_time #=> Time
4110
4232
  #
@@ -4117,6 +4239,71 @@ module Aws::LexModelsV2
4117
4239
  req.send_request(options)
4118
4240
  end
4119
4241
 
4242
+ # Get a list of bot recommendations that meet the specified criteria.
4243
+ #
4244
+ # @option params [required, String] :bot_id
4245
+ # The unique identifier of the bot that contains the bot recommendation
4246
+ # list.
4247
+ #
4248
+ # @option params [required, String] :bot_version
4249
+ # The version of the bot that contains the bot recommendation list.
4250
+ #
4251
+ # @option params [required, String] :locale_id
4252
+ # The identifier of the language and locale of the bot recommendation
4253
+ # list.
4254
+ #
4255
+ # @option params [Integer] :max_results
4256
+ # The maximum number of bot recommendations to return in each page of
4257
+ # results. If there are fewer results than the max page size, only the
4258
+ # actual number of results are returned.
4259
+ #
4260
+ # @option params [String] :next_token
4261
+ # If the response from the ListBotRecommendation operation contains more
4262
+ # results than specified in the maxResults parameter, a token is
4263
+ # returned in the response. Use that token in the nextToken parameter to
4264
+ # return the next page of results.
4265
+ #
4266
+ # @return [Types::ListBotRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4267
+ #
4268
+ # * {Types::ListBotRecommendationsResponse#bot_id #bot_id} => String
4269
+ # * {Types::ListBotRecommendationsResponse#bot_version #bot_version} => String
4270
+ # * {Types::ListBotRecommendationsResponse#locale_id #locale_id} => String
4271
+ # * {Types::ListBotRecommendationsResponse#bot_recommendation_summaries #bot_recommendation_summaries} => Array&lt;Types::BotRecommendationSummary&gt;
4272
+ # * {Types::ListBotRecommendationsResponse#next_token #next_token} => String
4273
+ #
4274
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4275
+ #
4276
+ # @example Request syntax with placeholder values
4277
+ #
4278
+ # resp = client.list_bot_recommendations({
4279
+ # bot_id: "Id", # required
4280
+ # bot_version: "DraftBotVersion", # required
4281
+ # locale_id: "LocaleId", # required
4282
+ # max_results: 1,
4283
+ # next_token: "NextToken",
4284
+ # })
4285
+ #
4286
+ # @example Response structure
4287
+ #
4288
+ # resp.bot_id #=> String
4289
+ # resp.bot_version #=> String
4290
+ # resp.locale_id #=> String
4291
+ # resp.bot_recommendation_summaries #=> Array
4292
+ # resp.bot_recommendation_summaries[0].bot_recommendation_status #=> String, one of "Processing", "Deleting", "Deleted", "Downloading", "Updating", "Available", "Failed"
4293
+ # resp.bot_recommendation_summaries[0].bot_recommendation_id #=> String
4294
+ # resp.bot_recommendation_summaries[0].creation_date_time #=> Time
4295
+ # resp.bot_recommendation_summaries[0].last_updated_date_time #=> Time
4296
+ # resp.next_token #=> String
4297
+ #
4298
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListBotRecommendations AWS API Documentation
4299
+ #
4300
+ # @overload list_bot_recommendations(params = {})
4301
+ # @param [Hash] params ({})
4302
+ def list_bot_recommendations(params = {}, options = {})
4303
+ req = build_request(:list_bot_recommendations, params)
4304
+ req.send_request(options)
4305
+ end
4306
+
4120
4307
  # Gets information about all of the versions of a bot.
4121
4308
  #
4122
4309
  # The `ListBotVersions` operation returns a summary of each version of a
@@ -4259,7 +4446,11 @@ module Aws::LexModelsV2
4259
4446
  # To use a built-in intent as a the base for your own intent, include
4260
4447
  # the built-in intent signature in the `parentIntentSignature` parameter
4261
4448
  # when you call the `CreateIntent` operation. For more information, see
4262
- # CreateIntent.
4449
+ # [CreateIntent][1].
4450
+ #
4451
+ #
4452
+ #
4453
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/API_CreateIntent.html
4263
4454
  #
4264
4455
  # @option params [required, String] :locale_id
4265
4456
  # The identifier of the language and locale of the intents to list. The
@@ -4540,7 +4731,7 @@ module Aws::LexModelsV2
4540
4731
  # resp.import_summaries[0].imported_resource_id #=> String
4541
4732
  # resp.import_summaries[0].imported_resource_name #=> String
4542
4733
  # resp.import_summaries[0].import_status #=> String, one of "InProgress", "Completed", "Failed", "Deleting"
4543
- # resp.import_summaries[0].merge_strategy #=> String, one of "Overwrite", "FailOnConflict"
4734
+ # resp.import_summaries[0].merge_strategy #=> String, one of "Overwrite", "FailOnConflict", "Append"
4544
4735
  # resp.import_summaries[0].creation_date_time #=> Time
4545
4736
  # resp.import_summaries[0].last_updated_date_time #=> Time
4546
4737
  # resp.next_token #=> String
@@ -4651,6 +4842,77 @@ module Aws::LexModelsV2
4651
4842
  req.send_request(options)
4652
4843
  end
4653
4844
 
4845
+ # Gets a list of recommended intents provided by the bot recommendation
4846
+ # that you can use in your bot.
4847
+ #
4848
+ # @option params [required, String] :bot_id
4849
+ # The unique identifier of the bot associated with the recommended
4850
+ # intents.
4851
+ #
4852
+ # @option params [required, String] :bot_version
4853
+ # The version of the bot that contains the recommended intents.
4854
+ #
4855
+ # @option params [required, String] :locale_id
4856
+ # The identifier of the language and locale of the recommended intents.
4857
+ #
4858
+ # @option params [required, String] :bot_recommendation_id
4859
+ # The identifier of the bot recommendation that contains the recommended
4860
+ # intents.
4861
+ #
4862
+ # @option params [String] :next_token
4863
+ # If the response from the ListRecommendedIntents operation contains
4864
+ # more results than specified in the maxResults parameter, a token is
4865
+ # returned in the response. Use that token in the nextToken parameter to
4866
+ # return the next page of results.
4867
+ #
4868
+ # @option params [Integer] :max_results
4869
+ # The maximum number of bot recommendations to return in each page of
4870
+ # results. If there are fewer results than the max page size, only the
4871
+ # actual number of results are returned.
4872
+ #
4873
+ # @return [Types::ListRecommendedIntentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4874
+ #
4875
+ # * {Types::ListRecommendedIntentsResponse#bot_id #bot_id} => String
4876
+ # * {Types::ListRecommendedIntentsResponse#bot_version #bot_version} => String
4877
+ # * {Types::ListRecommendedIntentsResponse#locale_id #locale_id} => String
4878
+ # * {Types::ListRecommendedIntentsResponse#bot_recommendation_id #bot_recommendation_id} => String
4879
+ # * {Types::ListRecommendedIntentsResponse#summary_list #summary_list} => Array&lt;Types::RecommendedIntentSummary&gt;
4880
+ # * {Types::ListRecommendedIntentsResponse#next_token #next_token} => String
4881
+ #
4882
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4883
+ #
4884
+ # @example Request syntax with placeholder values
4885
+ #
4886
+ # resp = client.list_recommended_intents({
4887
+ # bot_id: "Id", # required
4888
+ # bot_version: "DraftBotVersion", # required
4889
+ # locale_id: "LocaleId", # required
4890
+ # bot_recommendation_id: "Id", # required
4891
+ # next_token: "NextToken",
4892
+ # max_results: 1,
4893
+ # })
4894
+ #
4895
+ # @example Response structure
4896
+ #
4897
+ # resp.bot_id #=> String
4898
+ # resp.bot_version #=> String
4899
+ # resp.locale_id #=> String
4900
+ # resp.bot_recommendation_id #=> String
4901
+ # resp.summary_list #=> Array
4902
+ # resp.summary_list[0].intent_id #=> String
4903
+ # resp.summary_list[0].intent_name #=> String
4904
+ # resp.summary_list[0].sample_utterances_count #=> Integer
4905
+ # resp.next_token #=> String
4906
+ #
4907
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListRecommendedIntents AWS API Documentation
4908
+ #
4909
+ # @overload list_recommended_intents(params = {})
4910
+ # @param [Hash] params ({})
4911
+ def list_recommended_intents(params = {}, options = {})
4912
+ req = build_request(:list_recommended_intents, params)
4913
+ req.send_request(options)
4914
+ end
4915
+
4654
4916
  # Gets a list of slot types that match the specified criteria.
4655
4917
  #
4656
4918
  # @option params [required, String] :bot_id
@@ -4893,12 +5155,202 @@ module Aws::LexModelsV2
4893
5155
  req.send_request(options)
4894
5156
  end
4895
5157
 
5158
+ # Search for associated transcripts that meet the specified criteria.
5159
+ #
5160
+ # @option params [required, String] :bot_id
5161
+ # The unique identifier of the bot associated with the transcripts that
5162
+ # you are searching.
5163
+ #
5164
+ # @option params [required, String] :bot_version
5165
+ # The version of the bot containing the transcripts that you are
5166
+ # searching.
5167
+ #
5168
+ # @option params [required, String] :locale_id
5169
+ # The identifier of the language and locale of the transcripts to
5170
+ # search. The string must match one of the supported locales. For more
5171
+ # information, see [Supported languages][1]
5172
+ #
5173
+ #
5174
+ #
5175
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html
5176
+ #
5177
+ # @option params [required, String] :bot_recommendation_id
5178
+ # The unique identifier of the bot recommendation associated with the
5179
+ # transcripts to search.
5180
+ #
5181
+ # @option params [String] :search_order
5182
+ # How SearchResults are ordered. Valid values are Ascending or
5183
+ # Descending. The default is Descending.
5184
+ #
5185
+ # @option params [required, Array<Types::AssociatedTranscriptFilter>] :filters
5186
+ # A list of filter objects.
5187
+ #
5188
+ # @option params [Integer] :max_results
5189
+ # The maximum number of bot recommendations to return in each page of
5190
+ # results. If there are fewer results than the max page size, only the
5191
+ # actual number of results are returned.
5192
+ #
5193
+ # @option params [Integer] :next_index
5194
+ # If the response from the SearchAssociatedTranscriptsRequest operation
5195
+ # contains more results than specified in the maxResults parameter, an
5196
+ # index is returned in the response. Use that index in the nextIndex
5197
+ # parameter to return the next page of results.
5198
+ #
5199
+ # @return [Types::SearchAssociatedTranscriptsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5200
+ #
5201
+ # * {Types::SearchAssociatedTranscriptsResponse#bot_id #bot_id} => String
5202
+ # * {Types::SearchAssociatedTranscriptsResponse#bot_version #bot_version} => String
5203
+ # * {Types::SearchAssociatedTranscriptsResponse#locale_id #locale_id} => String
5204
+ # * {Types::SearchAssociatedTranscriptsResponse#bot_recommendation_id #bot_recommendation_id} => String
5205
+ # * {Types::SearchAssociatedTranscriptsResponse#next_index #next_index} => Integer
5206
+ # * {Types::SearchAssociatedTranscriptsResponse#associated_transcripts #associated_transcripts} => Array&lt;Types::AssociatedTranscript&gt;
5207
+ # * {Types::SearchAssociatedTranscriptsResponse#total_results #total_results} => Integer
5208
+ #
5209
+ # @example Request syntax with placeholder values
5210
+ #
5211
+ # resp = client.search_associated_transcripts({
5212
+ # bot_id: "Id", # required
5213
+ # bot_version: "BotVersion", # required
5214
+ # locale_id: "LocaleId", # required
5215
+ # bot_recommendation_id: "Id", # required
5216
+ # search_order: "Ascending", # accepts Ascending, Descending
5217
+ # filters: [ # required
5218
+ # {
5219
+ # name: "IntentId", # required, accepts IntentId, SlotTypeId
5220
+ # values: ["FilterValue"], # required
5221
+ # },
5222
+ # ],
5223
+ # max_results: 1,
5224
+ # next_index: 1,
5225
+ # })
5226
+ #
5227
+ # @example Response structure
5228
+ #
5229
+ # resp.bot_id #=> String
5230
+ # resp.bot_version #=> String
5231
+ # resp.locale_id #=> String
5232
+ # resp.bot_recommendation_id #=> String
5233
+ # resp.next_index #=> Integer
5234
+ # resp.associated_transcripts #=> Array
5235
+ # resp.associated_transcripts[0].transcript #=> String
5236
+ # resp.total_results #=> Integer
5237
+ #
5238
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/SearchAssociatedTranscripts AWS API Documentation
5239
+ #
5240
+ # @overload search_associated_transcripts(params = {})
5241
+ # @param [Hash] params ({})
5242
+ def search_associated_transcripts(params = {}, options = {})
5243
+ req = build_request(:search_associated_transcripts, params)
5244
+ req.send_request(options)
5245
+ end
5246
+
5247
+ # Use this to provide your transcript data, and to start the bot
5248
+ # recommendation process.
5249
+ #
5250
+ # @option params [required, String] :bot_id
5251
+ # The unique identifier of the bot containing the bot recommendation.
5252
+ #
5253
+ # @option params [required, String] :bot_version
5254
+ # The version of the bot containing the bot recommendation.
5255
+ #
5256
+ # @option params [required, String] :locale_id
5257
+ # The identifier of the language and locale of the bot recommendation to
5258
+ # start. The string must match one of the supported locales. For more
5259
+ # information, see [Supported languages][1]
5260
+ #
5261
+ #
5262
+ #
5263
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html
5264
+ #
5265
+ # @option params [required, Types::TranscriptSourceSetting] :transcript_source_setting
5266
+ # The object representing the Amazon S3 bucket containing the
5267
+ # transcript, as well as the associated metadata.
5268
+ #
5269
+ # @option params [Types::EncryptionSetting] :encryption_setting
5270
+ # The object representing the passwords that will be used to encrypt the
5271
+ # data related to the bot recommendation results, as well as the KMS key
5272
+ # ARN used to encrypt the associated metadata.
5273
+ #
5274
+ # @return [Types::StartBotRecommendationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5275
+ #
5276
+ # * {Types::StartBotRecommendationResponse#bot_id #bot_id} => String
5277
+ # * {Types::StartBotRecommendationResponse#bot_version #bot_version} => String
5278
+ # * {Types::StartBotRecommendationResponse#locale_id #locale_id} => String
5279
+ # * {Types::StartBotRecommendationResponse#bot_recommendation_status #bot_recommendation_status} => String
5280
+ # * {Types::StartBotRecommendationResponse#bot_recommendation_id #bot_recommendation_id} => String
5281
+ # * {Types::StartBotRecommendationResponse#creation_date_time #creation_date_time} => Time
5282
+ # * {Types::StartBotRecommendationResponse#transcript_source_setting #transcript_source_setting} => Types::TranscriptSourceSetting
5283
+ # * {Types::StartBotRecommendationResponse#encryption_setting #encryption_setting} => Types::EncryptionSetting
5284
+ #
5285
+ # @example Request syntax with placeholder values
5286
+ #
5287
+ # resp = client.start_bot_recommendation({
5288
+ # bot_id: "Id", # required
5289
+ # bot_version: "DraftBotVersion", # required
5290
+ # locale_id: "LocaleId", # required
5291
+ # transcript_source_setting: { # required
5292
+ # s3_bucket_transcript_source: {
5293
+ # s3_bucket_name: "S3BucketName", # required
5294
+ # path_format: {
5295
+ # object_prefixes: ["ObjectPrefix"],
5296
+ # },
5297
+ # transcript_format: "Lex", # required, accepts Lex
5298
+ # transcript_filter: {
5299
+ # lex_transcript_filter: {
5300
+ # date_range_filter: {
5301
+ # start_date_time: Time.now, # required
5302
+ # end_date_time: Time.now, # required
5303
+ # },
5304
+ # },
5305
+ # },
5306
+ # kms_key_arn: "KmsKeyArn",
5307
+ # },
5308
+ # },
5309
+ # encryption_setting: {
5310
+ # kms_key_arn: "KmsKeyArn",
5311
+ # bot_locale_export_password: "FilePassword",
5312
+ # associated_transcripts_password: "FilePassword",
5313
+ # },
5314
+ # })
5315
+ #
5316
+ # @example Response structure
5317
+ #
5318
+ # resp.bot_id #=> String
5319
+ # resp.bot_version #=> String
5320
+ # resp.locale_id #=> String
5321
+ # resp.bot_recommendation_status #=> String, one of "Processing", "Deleting", "Deleted", "Downloading", "Updating", "Available", "Failed"
5322
+ # resp.bot_recommendation_id #=> String
5323
+ # resp.creation_date_time #=> Time
5324
+ # resp.transcript_source_setting.s3_bucket_transcript_source.s3_bucket_name #=> String
5325
+ # resp.transcript_source_setting.s3_bucket_transcript_source.path_format.object_prefixes #=> Array
5326
+ # resp.transcript_source_setting.s3_bucket_transcript_source.path_format.object_prefixes[0] #=> String
5327
+ # resp.transcript_source_setting.s3_bucket_transcript_source.transcript_format #=> String, one of "Lex"
5328
+ # resp.transcript_source_setting.s3_bucket_transcript_source.transcript_filter.lex_transcript_filter.date_range_filter.start_date_time #=> Time
5329
+ # resp.transcript_source_setting.s3_bucket_transcript_source.transcript_filter.lex_transcript_filter.date_range_filter.end_date_time #=> Time
5330
+ # resp.transcript_source_setting.s3_bucket_transcript_source.kms_key_arn #=> String
5331
+ # resp.encryption_setting.kms_key_arn #=> String
5332
+ # resp.encryption_setting.bot_locale_export_password #=> String
5333
+ # resp.encryption_setting.associated_transcripts_password #=> String
5334
+ #
5335
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/StartBotRecommendation AWS API Documentation
5336
+ #
5337
+ # @overload start_bot_recommendation(params = {})
5338
+ # @param [Hash] params ({})
5339
+ def start_bot_recommendation(params = {}, options = {})
5340
+ req = build_request(:start_bot_recommendation, params)
5341
+ req.send_request(options)
5342
+ end
5343
+
4896
5344
  # Starts importing a bot or bot locale from a zip archive that you
4897
5345
  # uploaded to an S3 bucket.
4898
5346
  #
4899
5347
  # @option params [required, String] :import_id
4900
5348
  # The unique identifier for the import. It is included in the response
4901
- # from the operation.
5349
+ # from the [CreateUploadUrl][1] operation.
5350
+ #
5351
+ #
5352
+ #
5353
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/API_CreateUploadUrl.html
4902
5354
  #
4903
5355
  # @option params [required, Types::ImportResourceSpecification] :resource_specification
4904
5356
  # Parameters for creating the bot or bot locale.
@@ -4948,10 +5400,11 @@ module Aws::LexModelsV2
4948
5400
  # nlu_intent_confidence_threshold: 1.0,
4949
5401
  # voice_settings: {
4950
5402
  # voice_id: "VoiceId", # required
5403
+ # engine: "standard", # accepts standard, neural
4951
5404
  # },
4952
5405
  # },
4953
5406
  # },
4954
- # merge_strategy: "Overwrite", # required, accepts Overwrite, FailOnConflict
5407
+ # merge_strategy: "Overwrite", # required, accepts Overwrite, FailOnConflict, Append
4955
5408
  # file_password: "ImportExportFilePassword",
4956
5409
  # })
4957
5410
  #
@@ -4971,7 +5424,8 @@ module Aws::LexModelsV2
4971
5424
  # resp.resource_specification.bot_locale_import_specification.locale_id #=> String
4972
5425
  # resp.resource_specification.bot_locale_import_specification.nlu_intent_confidence_threshold #=> Float
4973
5426
  # resp.resource_specification.bot_locale_import_specification.voice_settings.voice_id #=> String
4974
- # resp.merge_strategy #=> String, one of "Overwrite", "FailOnConflict"
5427
+ # resp.resource_specification.bot_locale_import_specification.voice_settings.engine #=> String, one of "standard", "neural"
5428
+ # resp.merge_strategy #=> String, one of "Overwrite", "FailOnConflict", "Append"
4975
5429
  # resp.import_status #=> String, one of "InProgress", "Completed", "Failed", "Deleting"
4976
5430
  # resp.creation_date_time #=> Time
4977
5431
  #
@@ -5047,7 +5501,11 @@ module Aws::LexModelsV2
5047
5501
  #
5048
5502
  # @option params [required, String] :bot_id
5049
5503
  # The unique identifier of the bot to update. This identifier is
5050
- # returned by the CreateBot operation.
5504
+ # returned by the [CreateBot][1] operation.
5505
+ #
5506
+ #
5507
+ #
5508
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/API_CreateBot.html
5051
5509
  #
5052
5510
  # @option params [required, String] :bot_name
5053
5511
  # The new name of the bot. The name must be unique in the account that
@@ -5299,6 +5757,7 @@ module Aws::LexModelsV2
5299
5757
  # nlu_intent_confidence_threshold: 1.0, # required
5300
5758
  # voice_settings: {
5301
5759
  # voice_id: "VoiceId", # required
5760
+ # engine: "standard", # accepts standard, neural
5302
5761
  # },
5303
5762
  # })
5304
5763
  #
@@ -5311,7 +5770,8 @@ module Aws::LexModelsV2
5311
5770
  # resp.description #=> String
5312
5771
  # resp.nlu_intent_confidence_threshold #=> Float
5313
5772
  # resp.voice_settings.voice_id #=> String
5314
- # resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"
5773
+ # resp.voice_settings.engine #=> String, one of "standard", "neural"
5774
+ # resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing", "Processing"
5315
5775
  # resp.failure_reasons #=> Array
5316
5776
  # resp.failure_reasons[0] #=> String
5317
5777
  # resp.creation_date_time #=> Time
@@ -5326,12 +5786,98 @@ module Aws::LexModelsV2
5326
5786
  req.send_request(options)
5327
5787
  end
5328
5788
 
5789
+ # Updates an existing bot recommendation request.
5790
+ #
5791
+ # @option params [required, String] :bot_id
5792
+ # The unique identifier of the bot containing the bot recommendation to
5793
+ # be updated.
5794
+ #
5795
+ # @option params [required, String] :bot_version
5796
+ # The version of the bot containing the bot recommendation to be
5797
+ # updated.
5798
+ #
5799
+ # @option params [required, String] :locale_id
5800
+ # The identifier of the language and locale of the bot recommendation to
5801
+ # update. The string must match one of the supported locales. For more
5802
+ # information, see [Supported languages][1]
5803
+ #
5804
+ #
5805
+ #
5806
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html
5807
+ #
5808
+ # @option params [required, String] :bot_recommendation_id
5809
+ # The unique identifier of the bot recommendation to be updated.
5810
+ #
5811
+ # @option params [required, Types::EncryptionSetting] :encryption_setting
5812
+ # The object representing the passwords that will be used to encrypt the
5813
+ # data related to the bot recommendation results, as well as the KMS key
5814
+ # ARN used to encrypt the associated metadata.
5815
+ #
5816
+ # @return [Types::UpdateBotRecommendationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5817
+ #
5818
+ # * {Types::UpdateBotRecommendationResponse#bot_id #bot_id} => String
5819
+ # * {Types::UpdateBotRecommendationResponse#bot_version #bot_version} => String
5820
+ # * {Types::UpdateBotRecommendationResponse#locale_id #locale_id} => String
5821
+ # * {Types::UpdateBotRecommendationResponse#bot_recommendation_status #bot_recommendation_status} => String
5822
+ # * {Types::UpdateBotRecommendationResponse#bot_recommendation_id #bot_recommendation_id} => String
5823
+ # * {Types::UpdateBotRecommendationResponse#creation_date_time #creation_date_time} => Time
5824
+ # * {Types::UpdateBotRecommendationResponse#last_updated_date_time #last_updated_date_time} => Time
5825
+ # * {Types::UpdateBotRecommendationResponse#transcript_source_setting #transcript_source_setting} => Types::TranscriptSourceSetting
5826
+ # * {Types::UpdateBotRecommendationResponse#encryption_setting #encryption_setting} => Types::EncryptionSetting
5827
+ #
5828
+ # @example Request syntax with placeholder values
5829
+ #
5830
+ # resp = client.update_bot_recommendation({
5831
+ # bot_id: "Id", # required
5832
+ # bot_version: "DraftBotVersion", # required
5833
+ # locale_id: "LocaleId", # required
5834
+ # bot_recommendation_id: "Id", # required
5835
+ # encryption_setting: { # required
5836
+ # kms_key_arn: "KmsKeyArn",
5837
+ # bot_locale_export_password: "FilePassword",
5838
+ # associated_transcripts_password: "FilePassword",
5839
+ # },
5840
+ # })
5841
+ #
5842
+ # @example Response structure
5843
+ #
5844
+ # resp.bot_id #=> String
5845
+ # resp.bot_version #=> String
5846
+ # resp.locale_id #=> String
5847
+ # resp.bot_recommendation_status #=> String, one of "Processing", "Deleting", "Deleted", "Downloading", "Updating", "Available", "Failed"
5848
+ # resp.bot_recommendation_id #=> String
5849
+ # resp.creation_date_time #=> Time
5850
+ # resp.last_updated_date_time #=> Time
5851
+ # resp.transcript_source_setting.s3_bucket_transcript_source.s3_bucket_name #=> String
5852
+ # resp.transcript_source_setting.s3_bucket_transcript_source.path_format.object_prefixes #=> Array
5853
+ # resp.transcript_source_setting.s3_bucket_transcript_source.path_format.object_prefixes[0] #=> String
5854
+ # resp.transcript_source_setting.s3_bucket_transcript_source.transcript_format #=> String, one of "Lex"
5855
+ # resp.transcript_source_setting.s3_bucket_transcript_source.transcript_filter.lex_transcript_filter.date_range_filter.start_date_time #=> Time
5856
+ # resp.transcript_source_setting.s3_bucket_transcript_source.transcript_filter.lex_transcript_filter.date_range_filter.end_date_time #=> Time
5857
+ # resp.transcript_source_setting.s3_bucket_transcript_source.kms_key_arn #=> String
5858
+ # resp.encryption_setting.kms_key_arn #=> String
5859
+ # resp.encryption_setting.bot_locale_export_password #=> String
5860
+ # resp.encryption_setting.associated_transcripts_password #=> String
5861
+ #
5862
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UpdateBotRecommendation AWS API Documentation
5863
+ #
5864
+ # @overload update_bot_recommendation(params = {})
5865
+ # @param [Hash] params ({})
5866
+ def update_bot_recommendation(params = {}, options = {})
5867
+ req = build_request(:update_bot_recommendation, params)
5868
+ req.send_request(options)
5869
+ end
5870
+
5329
5871
  # Updates the password used to protect an export zip archive.
5330
5872
  #
5331
5873
  # The password is not required. If you don't supply a password, Amazon
5332
5874
  # Lex generates a zip file that is not protected by a password. This is
5333
5875
  # the archive that is available at the pre-signed S3 URL provided by the
5334
- # operation.
5876
+ # [DescribeExport][1] operation.
5877
+ #
5878
+ #
5879
+ #
5880
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/API_DescribeExport.html
5335
5881
  #
5336
5882
  # @option params [required, String] :export_id
5337
5883
  # The unique identifier Amazon Lex assigned to the export.
@@ -6772,7 +7318,7 @@ module Aws::LexModelsV2
6772
7318
  params: params,
6773
7319
  config: config)
6774
7320
  context[:gem_name] = 'aws-sdk-lexmodelsv2'
6775
- context[:gem_version] = '1.13.0'
7321
+ context[:gem_version] = '1.17.0'
6776
7322
  Seahorse::Client::Request.new(handlers, context)
6777
7323
  end
6778
7324