aws-sdk-lexmodelsv2 1.13.0 → 1.17.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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