LexModelsV2

Table of Contents

Client

class LexModelsV2.Client

A low-level client representing Amazon Lex Model Building V2 (Lex Models V2)

import boto3

client = boto3.client('lexv2-models')

These are the available methods:

batch_create_custom_vocabulary_item(**kwargs)

Create a batch of custom vocabulary items for a given bot locale's custom vocabulary.

See also: AWS API Documentation

Request Syntax

response = client.batch_create_custom_vocabulary_item(
    botId='string',
    botVersion='string',
    localeId='string',
    customVocabularyItemList=[
        {
            'phrase': 'string',
            'weight': 123,
            'displayAs': 'string'
        },
    ]
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with this custom vocabulary.

  • botVersion (string) --

    [REQUIRED]

    The identifier of the version of the bot associated with this custom vocabulary.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale where this custom vocabulary is used. The string must match one of the supported locales. For more information, see Supported Languages.

  • customVocabularyItemList (list) --

    [REQUIRED]

    A list of new custom vocabulary items. Each entry must contain a phrase and can optionally contain a displayAs and/or a weight.

    • (dict) --

      The new custom vocabulary item from the custom vocabulary list.

      • phrase (string) -- [REQUIRED]

        The unique phrase for the new custom vocabulary item from the custom vocabulary list.

      • weight (integer) --

        The weight assigned to the new custom vocabulary item from the custom vocabulary list.

      • displayAs (string) --

        The display as value assigned to the new custom vocabulary item from the custom vocabulary list.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'errors': [
        {
            'itemId': 'string',
            'errorMessage': 'string',
            'errorCode': 'DUPLICATE_INPUT'|'RESOURCE_DOES_NOT_EXIST'|'RESOURCE_ALREADY_EXISTS'|'INTERNAL_SERVER_FAILURE'
        },
    ],
    'resources': [
        {
            'itemId': 'string',
            'phrase': 'string',
            'weight': 123,
            'displayAs': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot associated with this custom vocabulary.

    • botVersion (string) --

      The identifier of the version of the bot associated with this custom vocabulary.

    • localeId (string) --

      The identifier of the language and locale where this custom vocabulary is used. The string must match one of the supported locales. For more information, see Supported Languages.

    • errors (list) --

      A list of custom vocabulary items that failed to create during the operation. The reason for the error is contained within each error object.

      • (dict) --

        The unique failed custom vocabulary item from the custom vocabulary list.

        • itemId (string) --

          The unique item identifer for the failed custom vocabulary item from the custom vocabulary list.

        • errorMessage (string) --

          The error message for the failed custom vocabulary item from the custom vocabulary list.

        • errorCode (string) --

          The unique error code for the failed custom vocabulary item from the custom vocabulary list.

    • resources (list) --

      A list of custom vocabulary items that were successfully created during the operation.

      • (dict) --

        The unique custom vocabulary item from the custom vocabulary list.

        • itemId (string) --

          The unique item identifer for the custom vocabulary item from the custom vocabulary list.

        • phrase (string) --

          The unique phrase for the custom vocabulary item from the custom vocabulary list.

        • weight (integer) --

          The weight assigned for the custom vocabulary item from the custom vocabulary list.

        • displayAs (string) --

          The DisplayAs value for the custom vocabulary item from the custom vocabulary list.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
batch_delete_custom_vocabulary_item(**kwargs)

Delete a batch of custom vocabulary items for a given bot locale's custom vocabulary.

See also: AWS API Documentation

Request Syntax

response = client.batch_delete_custom_vocabulary_item(
    botId='string',
    botVersion='string',
    localeId='string',
    customVocabularyItemList=[
        {
            'itemId': 'string'
        },
    ]
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with this custom vocabulary.

  • botVersion (string) --

    [REQUIRED]

    The identifier of the version of the bot associated with this custom vocabulary.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale where this custom vocabulary is used. The string must match one of the supported locales. For more information, see Supported Languages.

  • customVocabularyItemList (list) --

    [REQUIRED]

    A list of custom vocabulary items requested to be deleted. Each entry must contain the unique custom vocabulary entry identifier.

    • (dict) --

      The unique entry identifier for the custom vocabulary items.

      • itemId (string) -- [REQUIRED]

        The unique item identifier for the custom vocabulary items.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'errors': [
        {
            'itemId': 'string',
            'errorMessage': 'string',
            'errorCode': 'DUPLICATE_INPUT'|'RESOURCE_DOES_NOT_EXIST'|'RESOURCE_ALREADY_EXISTS'|'INTERNAL_SERVER_FAILURE'
        },
    ],
    'resources': [
        {
            'itemId': 'string',
            'phrase': 'string',
            'weight': 123,
            'displayAs': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot associated with this custom vocabulary.

    • botVersion (string) --

      The identifier of the version of the bot associated with this custom vocabulary.

    • localeId (string) --

      The identifier of the language and locale where this custom vocabulary is used. The string must match one of the supported locales. For more information, see Supported languages (https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html).

    • errors (list) --

      A list of custom vocabulary items that failed to delete during the operation. The reason for the error is contained within each error object.

      • (dict) --

        The unique failed custom vocabulary item from the custom vocabulary list.

        • itemId (string) --

          The unique item identifer for the failed custom vocabulary item from the custom vocabulary list.

        • errorMessage (string) --

          The error message for the failed custom vocabulary item from the custom vocabulary list.

        • errorCode (string) --

          The unique error code for the failed custom vocabulary item from the custom vocabulary list.

    • resources (list) --

      A list of custom vocabulary items that were successfully deleted during the operation.

      • (dict) --

        The unique custom vocabulary item from the custom vocabulary list.

        • itemId (string) --

          The unique item identifer for the custom vocabulary item from the custom vocabulary list.

        • phrase (string) --

          The unique phrase for the custom vocabulary item from the custom vocabulary list.

        • weight (integer) --

          The weight assigned for the custom vocabulary item from the custom vocabulary list.

        • displayAs (string) --

          The DisplayAs value for the custom vocabulary item from the custom vocabulary list.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
batch_update_custom_vocabulary_item(**kwargs)

Update a batch of custom vocabulary items for a given bot locale's custom vocabulary.

See also: AWS API Documentation

Request Syntax

response = client.batch_update_custom_vocabulary_item(
    botId='string',
    botVersion='string',
    localeId='string',
    customVocabularyItemList=[
        {
            'itemId': 'string',
            'phrase': 'string',
            'weight': 123,
            'displayAs': 'string'
        },
    ]
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with this custom vocabulary

  • botVersion (string) --

    [REQUIRED]

    The identifier of the version of the bot associated with this custom vocabulary.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale where this custom vocabulary is used. The string must match one of the supported locales. For more information, see Supported Languages.

  • customVocabularyItemList (list) --

    [REQUIRED]

    A list of custom vocabulary items with updated fields. Each entry must contain a phrase and can optionally contain a displayAs and/or a weight.

    • (dict) --

      The unique custom vocabulary item from the custom vocabulary list.

      • itemId (string) -- [REQUIRED]

        The unique item identifer for the custom vocabulary item from the custom vocabulary list.

      • phrase (string) -- [REQUIRED]

        The unique phrase for the custom vocabulary item from the custom vocabulary list.

      • weight (integer) --

        The weight assigned for the custom vocabulary item from the custom vocabulary list.

      • displayAs (string) --

        The DisplayAs value for the custom vocabulary item from the custom vocabulary list.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'errors': [
        {
            'itemId': 'string',
            'errorMessage': 'string',
            'errorCode': 'DUPLICATE_INPUT'|'RESOURCE_DOES_NOT_EXIST'|'RESOURCE_ALREADY_EXISTS'|'INTERNAL_SERVER_FAILURE'
        },
    ],
    'resources': [
        {
            'itemId': 'string',
            'phrase': 'string',
            'weight': 123,
            'displayAs': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot associated with this custom vocabulary.

    • botVersion (string) --

      The identifier of the version of the bot associated with this custom vocabulary.

    • localeId (string) --

      The identifier of the language and locale where this custom vocabulary is used. The string must match one of the supported locales. For more information, see Supported Languages.

    • errors (list) --

      A list of custom vocabulary items that failed to update during the operation. The reason for the error is contained within each error object.

      • (dict) --

        The unique failed custom vocabulary item from the custom vocabulary list.

        • itemId (string) --

          The unique item identifer for the failed custom vocabulary item from the custom vocabulary list.

        • errorMessage (string) --

          The error message for the failed custom vocabulary item from the custom vocabulary list.

        • errorCode (string) --

          The unique error code for the failed custom vocabulary item from the custom vocabulary list.

    • resources (list) --

      A list of custom vocabulary items that were successfully updated during the operation.

      • (dict) --

        The unique custom vocabulary item from the custom vocabulary list.

        • itemId (string) --

          The unique item identifer for the custom vocabulary item from the custom vocabulary list.

        • phrase (string) --

          The unique phrase for the custom vocabulary item from the custom vocabulary list.

        • weight (integer) --

          The weight assigned for the custom vocabulary item from the custom vocabulary list.

        • displayAs (string) --

          The DisplayAs value for the custom vocabulary item from the custom vocabulary list.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
build_bot_locale(**kwargs)

Builds a bot, its intents, and its slot types into a specific locale. A bot can be built into multiple locales. At runtime the locale is used to choose a specific build of the bot.

See also: AWS API Documentation

Request Syntax

response = client.build_bot_locale(
    botId='string',
    botVersion='string',
    localeId='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot to build. The identifier is returned in the response from the CreateBot operation.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot to build. This can only be the draft version of the bot.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale that the bot will be used in. The string must match one of the supported locales. All of the intents, slot types, and slots used in the bot must have the same locale. For more information, see Supported languages.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'botLocaleStatus': 'Creating'|'Building'|'Built'|'ReadyExpressTesting'|'Failed'|'Deleting'|'NotBuilt'|'Importing'|'Processing',
    'lastBuildSubmittedDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the specified bot.

    • botVersion (string) --

      The version of the bot that was built. This is only the draft version of the bot.

    • localeId (string) --

      The language and locale specified of where the bot can be used.

    • botLocaleStatus (string) --

      The bot's build status. When the status is ReadyExpressTesting you can test the bot using the utterances defined for the intents and slot types. When the status is Built , the bot is ready for use and can be tested using any utterance.

    • lastBuildSubmittedDateTime (datetime) --

      A timestamp indicating the date and time that the bot was last built for this locale.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
close()

Closes underlying endpoint connections.

create_bot(**kwargs)

Creates an Amazon Lex conversational bot.

See also: AWS API Documentation

Request Syntax

response = client.create_bot(
    botName='string',
    description='string',
    roleArn='string',
    dataPrivacy={
        'childDirected': True|False
    },
    idleSessionTTLInSeconds=123,
    botTags={
        'string': 'string'
    },
    testBotAliasTags={
        'string': 'string'
    },
    botType='Bot'|'BotNetwork',
    botMembers=[
        {
            'botMemberId': 'string',
            'botMemberName': 'string',
            'botMemberAliasId': 'string',
            'botMemberAliasName': 'string',
            'botMemberVersion': 'string'
        },
    ]
)
Parameters
  • botName (string) --

    [REQUIRED]

    The name of the bot. The bot name must be unique in the account that creates the bot.

  • description (string) -- A description of the bot. It appears in lists to help you identify a particular bot.
  • roleArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of an IAM role that has permission to access the bot.

  • dataPrivacy (dict) --

    [REQUIRED]

    Provides information on additional privacy protections Amazon Lex should use with the bot's data.

    • childDirected (boolean) -- [REQUIRED]

      For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

  • idleSessionTTLInSeconds (integer) --

    [REQUIRED]

    The time, in seconds, that Amazon Lex should keep information about a user's conversation with the bot.

    A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Lex deletes any data provided before the timeout.

    You can specify between 60 (1 minute) and 86,400 (24 hours) seconds.

  • botTags (dict) --

    A list of tags to add to the bot. You can only add tags when you create a bot. You can't use the UpdateBot operation to update tags. To update tags, use the TagResource operation.

    • (string) --
      • (string) --
  • testBotAliasTags (dict) --

    A list of tags to add to the test alias for a bot. You can only add tags when you create a bot. You can't use the UpdateAlias operation to update tags. To update tags on the test alias, use the TagResource operation.

    • (string) --
      • (string) --
  • botType (string) -- The type of a bot to create.
  • botMembers (list) --

    The list of bot members in a network to be created.

    • (dict) --

      A bot that is a member of a network of bots.

      • botMemberId (string) -- [REQUIRED]

        The unique ID of a bot that is a member of this network of bots.

      • botMemberName (string) -- [REQUIRED]

        The unique name of a bot that is a member of this network of bots.

      • botMemberAliasId (string) -- [REQUIRED]

        The alias ID of a bot that is a member of this network of bots.

      • botMemberAliasName (string) -- [REQUIRED]

        The alias name of a bot that is a member of this network of bots.

      • botMemberVersion (string) -- [REQUIRED]

        The version of a bot that is a member of this network of bots.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botName': 'string',
    'description': 'string',
    'roleArn': 'string',
    'dataPrivacy': {
        'childDirected': True|False
    },
    'idleSessionTTLInSeconds': 123,
    'botStatus': 'Creating'|'Available'|'Inactive'|'Deleting'|'Failed'|'Versioning'|'Importing'|'Updating',
    'creationDateTime': datetime(2015, 1, 1),
    'botTags': {
        'string': 'string'
    },
    'testBotAliasTags': {
        'string': 'string'
    },
    'botType': 'Bot'|'BotNetwork',
    'botMembers': [
        {
            'botMemberId': 'string',
            'botMemberName': 'string',
            'botMemberAliasId': 'string',
            'botMemberAliasName': 'string',
            'botMemberVersion': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • botId (string) --

      A unique identifier for a particular bot. You use this to identify the bot when you call other Amazon Lex API operations.

    • botName (string) --

      The name specified for the bot.

    • description (string) --

      The description specified for the bot.

    • roleArn (string) --

      The IAM role specified for the bot.

    • dataPrivacy (dict) --

      The data privacy settings specified for the bot.

      • childDirected (boolean) --

        For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

    • idleSessionTTLInSeconds (integer) --

      The session idle time specified for the bot.

    • botStatus (string) --

      Shows the current status of the bot. The bot is first in the Creating status. Once the bot is read for use, it changes to the Available status. After the bot is created, you can use the DRAFT version of the bot.

    • creationDateTime (datetime) --

      A timestamp indicating the date and time that the bot was created.

    • botTags (dict) --

      A list of tags associated with the bot.

      • (string) --
        • (string) --
    • testBotAliasTags (dict) --

      A list of tags associated with the test alias for the bot.

      • (string) --
        • (string) --
    • botType (string) --

      The type of a bot that was created.

    • botMembers (list) --

      The list of bots in a network that was created.

      • (dict) --

        A bot that is a member of a network of bots.

        • botMemberId (string) --

          The unique ID of a bot that is a member of this network of bots.

        • botMemberName (string) --

          The unique name of a bot that is a member of this network of bots.

        • botMemberAliasId (string) --

          The alias ID of a bot that is a member of this network of bots.

        • botMemberAliasName (string) --

          The alias name of a bot that is a member of this network of bots.

        • botMemberVersion (string) --

          The version of a bot that is a member of this network of bots.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
create_bot_alias(**kwargs)

Creates an alias for the specified version of a bot. Use an alias to enable you to change the version of a bot without updating applications that use the bot.

For example, you can create an alias called "PROD" that your applications use to call the Amazon Lex bot.

See also: AWS API Documentation

Request Syntax

response = client.create_bot_alias(
    botAliasName='string',
    description='string',
    botVersion='string',
    botAliasLocaleSettings={
        'string': {
            'enabled': True|False,
            'codeHookSpecification': {
                'lambdaCodeHook': {
                    'lambdaARN': 'string',
                    'codeHookInterfaceVersion': 'string'
                }
            }
        }
    },
    conversationLogSettings={
        'textLogSettings': [
            {
                'enabled': True|False,
                'destination': {
                    'cloudWatch': {
                        'cloudWatchLogGroupArn': 'string',
                        'logPrefix': 'string'
                    }
                }
            },
        ],
        'audioLogSettings': [
            {
                'enabled': True|False,
                'destination': {
                    's3Bucket': {
                        'kmsKeyArn': 'string',
                        's3BucketArn': 'string',
                        'logPrefix': 'string'
                    }
                }
            },
        ]
    },
    sentimentAnalysisSettings={
        'detectSentiment': True|False
    },
    botId='string',
    tags={
        'string': 'string'
    }
)
Parameters
  • botAliasName (string) --

    [REQUIRED]

    The alias to create. The name must be unique for the bot.

  • description (string) -- A description of the alias. Use this description to help identify the alias.
  • botVersion (string) -- The version of the bot that this alias points to. You can use the UpdateBotAlias operation to change the bot version associated with the alias.
  • botAliasLocaleSettings (dict) --

    Maps configuration information to a specific locale. You can use this parameter to specify a specific Lambda function to run different functions in different locales.

    • (string) --
      • (dict) --

        Specifies settings that are unique to a locale. For example, you can use different Lambda function depending on the bot's locale.

        • enabled (boolean) -- [REQUIRED]

          Determines whether the locale is enabled for the bot. If the value is false , the locale isn't available for use.

        • codeHookSpecification (dict) --

          Specifies the Lambda function that should be used in the locale.

          • lambdaCodeHook (dict) -- [REQUIRED]

            Specifies a Lambda function that verifies requests to a bot or fulfills the user's request to a bot.

            • lambdaARN (string) -- [REQUIRED]

              The Amazon Resource Name (ARN) of the Lambda function.

            • codeHookInterfaceVersion (string) -- [REQUIRED]

              The version of the request-response that you want Amazon Lex to use to invoke your Lambda function.

  • conversationLogSettings (dict) --

    Specifies whether Amazon Lex logs text and audio for a conversation with the bot. When you enable conversation logs, text logs store text input, transcripts of audio input, and associated metadata in Amazon CloudWatch Logs. Audio logs store audio input in Amazon S3.

    • textLogSettings (list) --

      The Amazon CloudWatch Logs settings for logging text and metadata.

      • (dict) --

        Defines settings to enable text conversation logs.

        • enabled (boolean) -- [REQUIRED]

          Determines whether conversation logs should be stored for an alias.

        • destination (dict) -- [REQUIRED]

          Defines the Amazon CloudWatch Logs destination log group for conversation text logs.

          • cloudWatch (dict) -- [REQUIRED]

            Defines the Amazon CloudWatch Logs log group where text and metadata logs are delivered.

            • cloudWatchLogGroupArn (string) -- [REQUIRED]

              The Amazon Resource Name (ARN) of the log group where text and metadata logs are delivered.

            • logPrefix (string) -- [REQUIRED]

              The prefix of the log stream name within the log group that you specified

    • audioLogSettings (list) --

      The Amazon S3 settings for logging audio to an S3 bucket.

      • (dict) --

        Settings for logging audio of conversations between Amazon Lex and a user. You specify whether to log audio and the Amazon S3 bucket where the audio file is stored.

        • enabled (boolean) -- [REQUIRED]

          Determines whether audio logging in enabled for the bot.

        • destination (dict) -- [REQUIRED]

          The location of audio log files collected when conversation logging is enabled for a bot.

          • s3Bucket (dict) -- [REQUIRED]

            The Amazon S3 bucket where the audio log files are stored. The IAM role specified in the roleArn parameter of the CreateBot operation must have permission to write to this bucket.

            • kmsKeyArn (string) --

              The Amazon Resource Name (ARN) of an AWS Key Management Service (KMS) key for encrypting audio log files stored in an S3 bucket.

            • s3BucketArn (string) -- [REQUIRED]

              The Amazon Resource Name (ARN) of an Amazon S3 bucket where audio log files are stored.

            • logPrefix (string) -- [REQUIRED]

              The S3 prefix to assign to audio log files.

  • sentimentAnalysisSettings (dict) --

    Determines whether Amazon Lex will use Amazon Comprehend to detect the sentiment of user utterances.

    • detectSentiment (boolean) -- [REQUIRED]

      Sets whether Amazon Lex uses Amazon Comprehend to detect the sentiment of user utterances.

  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot that the alias applies to.

  • tags (dict) --

    A list of tags to add to the bot alias. You can only add tags when you create an alias, you can't use the UpdateBotAlias operation to update the tags on a bot alias. To update tags, use the TagResource operation.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'botAliasId': 'string',
    'botAliasName': 'string',
    'description': 'string',
    'botVersion': 'string',
    'botAliasLocaleSettings': {
        'string': {
            'enabled': True|False,
            'codeHookSpecification': {
                'lambdaCodeHook': {
                    'lambdaARN': 'string',
                    'codeHookInterfaceVersion': 'string'
                }
            }
        }
    },
    'conversationLogSettings': {
        'textLogSettings': [
            {
                'enabled': True|False,
                'destination': {
                    'cloudWatch': {
                        'cloudWatchLogGroupArn': 'string',
                        'logPrefix': 'string'
                    }
                }
            },
        ],
        'audioLogSettings': [
            {
                'enabled': True|False,
                'destination': {
                    's3Bucket': {
                        'kmsKeyArn': 'string',
                        's3BucketArn': 'string',
                        'logPrefix': 'string'
                    }
                }
            },
        ]
    },
    'sentimentAnalysisSettings': {
        'detectSentiment': True|False
    },
    'botAliasStatus': 'Creating'|'Available'|'Deleting'|'Failed',
    'botId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • botAliasId (string) --

      The unique identifier of the bot alias.

    • botAliasName (string) --

      The name specified for the bot alias.

    • description (string) --

      The description specified for the bot alias.

    • botVersion (string) --

      The version of the bot associated with this alias.

    • botAliasLocaleSettings (dict) --

      Configuration information for a specific locale.

      • (string) --

        • (dict) --

          Specifies settings that are unique to a locale. For example, you can use different Lambda function depending on the bot's locale.

          • enabled (boolean) --

            Determines whether the locale is enabled for the bot. If the value is false , the locale isn't available for use.

          • codeHookSpecification (dict) --

            Specifies the Lambda function that should be used in the locale.

            • lambdaCodeHook (dict) --

              Specifies a Lambda function that verifies requests to a bot or fulfills the user's request to a bot.

              • lambdaARN (string) --

                The Amazon Resource Name (ARN) of the Lambda function.

              • codeHookInterfaceVersion (string) --

                The version of the request-response that you want Amazon Lex to use to invoke your Lambda function.

    • conversationLogSettings (dict) --

      The conversation log settings specified for the alias.

      • textLogSettings (list) --

        The Amazon CloudWatch Logs settings for logging text and metadata.

        • (dict) --

          Defines settings to enable text conversation logs.

          • enabled (boolean) --

            Determines whether conversation logs should be stored for an alias.

          • destination (dict) --

            Defines the Amazon CloudWatch Logs destination log group for conversation text logs.

            • cloudWatch (dict) --

              Defines the Amazon CloudWatch Logs log group where text and metadata logs are delivered.

              • cloudWatchLogGroupArn (string) --

                The Amazon Resource Name (ARN) of the log group where text and metadata logs are delivered.

              • logPrefix (string) --

                The prefix of the log stream name within the log group that you specified

      • audioLogSettings (list) --

        The Amazon S3 settings for logging audio to an S3 bucket.

        • (dict) --

          Settings for logging audio of conversations between Amazon Lex and a user. You specify whether to log audio and the Amazon S3 bucket where the audio file is stored.

          • enabled (boolean) --

            Determines whether audio logging in enabled for the bot.

          • destination (dict) --

            The location of audio log files collected when conversation logging is enabled for a bot.

            • s3Bucket (dict) --

              The Amazon S3 bucket where the audio log files are stored. The IAM role specified in the roleArn parameter of the CreateBot operation must have permission to write to this bucket.

              • kmsKeyArn (string) --

                The Amazon Resource Name (ARN) of an AWS Key Management Service (KMS) key for encrypting audio log files stored in an S3 bucket.

              • s3BucketArn (string) --

                The Amazon Resource Name (ARN) of an Amazon S3 bucket where audio log files are stored.

              • logPrefix (string) --

                The S3 prefix to assign to audio log files.

    • sentimentAnalysisSettings (dict) --

      Determines whether Amazon Lex will use Amazon Comprehend to detect the sentiment of user utterances.

      • detectSentiment (boolean) --

        Sets whether Amazon Lex uses Amazon Comprehend to detect the sentiment of user utterances.

    • botAliasStatus (string) --

      The current status of the alias. The alias is first put into the Creating state. When the alias is ready to be used, it is put into the Available state. You can use the DescribeBotAlias operation to get the current state of an alias.

    • botId (string) --

      The unique identifier of the bot that this alias applies to.

    • creationDateTime (datetime) --

      A Unix timestamp indicating the date and time that the bot alias was created.

    • tags (dict) --

      A list of tags associated with the bot alias.

      • (string) --
        • (string) --

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
create_bot_locale(**kwargs)

Creates a locale in the bot. The locale contains the intents and slot types that the bot uses in conversations with users in the specified language and locale. You must add a locale to a bot before you can add intents and slot types to the bot.

See also: AWS API Documentation

Request Syntax

response = client.create_bot_locale(
    botId='string',
    botVersion='string',
    localeId='string',
    description='string',
    nluIntentConfidenceThreshold=123.0,
    voiceSettings={
        'voiceId': 'string',
        'engine': 'standard'|'neural'
    }
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot to create the locale for.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot to create the locale for. This can only be the draft version of the bot.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale that the bot will be used in. The string must match one of the supported locales. All of the intents, slot types, and slots used in the bot must have the same locale. For more information, see Supported languages.

  • description (string) -- A description of the bot locale. Use this to help identify the bot locale in lists.
  • nluIntentConfidenceThreshold (float) --

    [REQUIRED]

    Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent , AMAZON.KendraSearchIntent , or both when returning alternative intents. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot.

    For example, suppose a bot is configured with the confidence threshold of 0.80 and the AMAZON.FallbackIntent . Amazon Lex returns three alternative intents with the following confidence scores: IntentA (0.70), IntentB (0.60), IntentC (0.50). The response from the RecognizeText operation would be:

    • AMAZON.FallbackIntent
    • IntentA
    • IntentB
    • IntentC
  • voiceSettings (dict) --

    The Amazon Polly voice ID that Amazon Lex uses for voice interaction with the user.

    • voiceId (string) -- [REQUIRED]

      The identifier of the Amazon Polly voice to use.

    • engine (string) --

      Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the engineparameter of the SynthesizeSpeechoperation in the Amazon Polly developer guide .

      If you do not specify a value, the default is standard .

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeName': 'string',
    'localeId': 'string',
    'description': 'string',
    'nluIntentConfidenceThreshold': 123.0,
    'voiceSettings': {
        'voiceId': 'string',
        'engine': 'standard'|'neural'
    },
    'botLocaleStatus': 'Creating'|'Building'|'Built'|'ReadyExpressTesting'|'Failed'|'Deleting'|'NotBuilt'|'Importing'|'Processing',
    'creationDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • botId (string) --

      The specified bot identifier.

    • botVersion (string) --

      The specified bot version.

    • localeName (string) --

      The specified locale name.

    • localeId (string) --

      The specified locale identifier.

    • description (string) --

      The specified description of the bot locale.

    • nluIntentConfidenceThreshold (float) --

      The specified confidence threshold for inserting the AMAZON.FallbackIntent and AMAZON.KendraSearchIntent intents.

    • voiceSettings (dict) --

      The Amazon Polly voice ID that Amazon Lex uses for voice interaction with the user.

      • voiceId (string) --

        The identifier of the Amazon Polly voice to use.

      • engine (string) --

        Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the engineparameter of the SynthesizeSpeechoperation in the Amazon Polly developer guide .

        If you do not specify a value, the default is standard .

    • botLocaleStatus (string) --

      The status of the bot.

      When the status is Creating the bot locale is being configured. When the status is Building Amazon Lex is building the bot for testing and use.

      If the status of the bot is ReadyExpressTesting , you can test the bot using the exact utterances specified in the bots' intents. When the bot is ready for full testing or to run, the status is Built .

      If there was a problem with building the bot, the status is Failed . If the bot was saved but not built, the status is NotBuilt .

    • creationDateTime (datetime) --

      A timestamp specifying the date and time that the bot locale was created.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
create_bot_version(**kwargs)

Creates a new version of the bot based on the DRAFT version. If the DRAFT version of this resource hasn't changed since you created the last version, Amazon Lex doesn't create a new version, it returns the last created version.

When you create the first version of a bot, Amazon Lex sets the version to 1. Subsequent versions increment by 1.

See also: AWS API Documentation

Request Syntax

response = client.create_bot_version(
    botId='string',
    description='string',
    botVersionLocaleSpecification={
        'string': {
            'sourceBotVersion': 'string'
        }
    }
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot to create the version for.

  • description (string) -- A description of the version. Use the description to help identify the version in lists.
  • botVersionLocaleSpecification (dict) --

    [REQUIRED]

    Specifies the locales that Amazon Lex adds to this version. You can choose the Draft version or any other previously published version for each locale. When you specify a source version, the locale data is copied from the source version to the new version.

    • (string) --
      • (dict) --

        The version of a bot used for a bot locale.

        • sourceBotVersion (string) -- [REQUIRED]

          The version of a bot used for a bot locale.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'description': 'string',
    'botVersion': 'string',
    'botVersionLocaleSpecification': {
        'string': {
            'sourceBotVersion': 'string'
        }
    },
    'botStatus': 'Creating'|'Available'|'Inactive'|'Deleting'|'Failed'|'Versioning'|'Importing'|'Updating',
    'creationDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • botId (string) --

      The bot identifier specified in the request.

    • description (string) --

      The description of the version specified in the request.

    • botVersion (string) --

      The version number assigned to the version.

    • botVersionLocaleSpecification (dict) --

      The source versions used for each locale in the new version.

      • (string) --

        • (dict) --

          The version of a bot used for a bot locale.

          • sourceBotVersion (string) --

            The version of a bot used for a bot locale.

    • botStatus (string) --

      When you send a request to create or update a bot, Amazon Lex sets the status response element to Creating . After Amazon Lex builds the bot, it sets status to Available . If Amazon Lex can't build the bot, it sets status to Failed .

    • creationDateTime (datetime) --

      A timestamp of the date and time that the version was created.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
create_export(**kwargs)

Creates a zip archive containing the contents of a bot or a bot locale. The archive contains a directory structure that contains JSON files that define the bot.

You can create an archive that contains the complete definition of a bot, or you can specify that the archive contain only the definition of a single bot locale.

For more information about exporting bots, and about the structure of the export archive, see Importing and exporting bots

See also: AWS API Documentation

Request Syntax

response = client.create_export(
    resourceSpecification={
        'botExportSpecification': {
            'botId': 'string',
            'botVersion': 'string'
        },
        'botLocaleExportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        },
        'customVocabularyExportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        }
    },
    fileFormat='LexJson'|'TSV',
    filePassword='string'
)
Parameters
  • resourceSpecification (dict) --

    [REQUIRED]

    Specifies the type of resource to export, either a bot or a bot locale. You can only specify one type of resource to export.

    • botExportSpecification (dict) --

      Parameters for exporting a bot.

      • botId (string) -- [REQUIRED]

        The identifier of the bot assigned by Amazon Lex.

      • botVersion (string) -- [REQUIRED]

        The version of the bot that was exported. This will be either DRAFT or the version number.

    • botLocaleExportSpecification (dict) --

      Parameters for exporting a bot locale.

      • botId (string) -- [REQUIRED]

        The identifier of the bot to create the locale for.

      • botVersion (string) -- [REQUIRED]

        The version of the bot to export.

      • localeId (string) -- [REQUIRED]

        The identifier of the language and locale to export. The string must match one of the locales in the bot.

    • customVocabularyExportSpecification (dict) --

      The parameters required to export a custom vocabulary.

      • botId (string) -- [REQUIRED]

        The identifier of the bot that contains the custom vocabulary to export.

      • botVersion (string) -- [REQUIRED]

        The version of the bot that contains the custom vocabulary to export.

      • localeId (string) -- [REQUIRED]

        The locale of the bot that contains the custom vocabulary to export.

  • fileFormat (string) --

    [REQUIRED]

    The file format of the bot or bot locale definition files.

  • filePassword (string) -- An password to use to encrypt the exported archive. Using a password is optional, but you should encrypt the archive to protect the data in transit between Amazon Lex and your local computer.
Return type

dict

Returns

Response Syntax

{
    'exportId': 'string',
    'resourceSpecification': {
        'botExportSpecification': {
            'botId': 'string',
            'botVersion': 'string'
        },
        'botLocaleExportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        },
        'customVocabularyExportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        }
    },
    'fileFormat': 'LexJson'|'TSV',
    'exportStatus': 'InProgress'|'Completed'|'Failed'|'Deleting',
    'creationDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • exportId (string) --

      An identifier for a specific request to create an export.

    • resourceSpecification (dict) --

      A description of the type of resource that was exported, either a bot or a bot locale.

      • botExportSpecification (dict) --

        Parameters for exporting a bot.

        • botId (string) --

          The identifier of the bot assigned by Amazon Lex.

        • botVersion (string) --

          The version of the bot that was exported. This will be either DRAFT or the version number.

      • botLocaleExportSpecification (dict) --

        Parameters for exporting a bot locale.

        • botId (string) --

          The identifier of the bot to create the locale for.

        • botVersion (string) --

          The version of the bot to export.

        • localeId (string) --

          The identifier of the language and locale to export. The string must match one of the locales in the bot.

      • customVocabularyExportSpecification (dict) --

        The parameters required to export a custom vocabulary.

        • botId (string) --

          The identifier of the bot that contains the custom vocabulary to export.

        • botVersion (string) --

          The version of the bot that contains the custom vocabulary to export.

        • localeId (string) --

          The locale of the bot that contains the custom vocabulary to export.

    • fileFormat (string) --

      The file format used for the bot or bot locale definition files.

    • exportStatus (string) --

      The status of the export. When the status is Completed , you can use the DescribeExport operation to get the pre-signed S3 URL link to your exported bot or bot locale.

    • creationDateTime (datetime) --

      The date and time that the request to export a bot was created.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
create_intent(**kwargs)

Creates an intent.

To define the interaction between the user and your bot, you define one or more intents. For example, for a pizza ordering bot you would create an OrderPizza intent.

When you create an intent, you must provide a name. You can optionally provide the following:

  • Sample utterances. For example, "I want to order a pizza" and "Can I order a pizza." You can't provide utterances for built-in intents.
  • Information to be gathered. You specify slots for the information that you bot requests from the user. You can specify standard slot types, such as date and time, or custom slot types for your application.
  • How the intent is fulfilled. You can provide a Lambda function or configure the intent to return the intent information to your client application. If you use a Lambda function, Amazon Lex invokes the function when all of the intent information is available.
  • A confirmation prompt to send to the user to confirm an intent. For example, "Shall I order your pizza?"
  • A conclusion statement to send to the user after the intent is fulfilled. For example, "I ordered your pizza."
  • A follow-up prompt that asks the user for additional activity. For example, "Do you want a drink with your pizza?"

See also: AWS API Documentation

Request Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Parameters

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Return type
dict
Returns

Response Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Response Structure

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
create_resource_policy(**kwargs)

Creates a new resource policy with the specified policy statements.

See also: AWS API Documentation

Request Syntax

response = client.create_resource_policy(
    resourceArn='string',
    policy='string'
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

  • policy (string) --

    [REQUIRED]

    A resource policy to add to the resource. The policy is a JSON structure that contains one or more statements that define the policy. The policy must follow the IAM syntax. For more information about the contents of a JSON policy document, see IAM JSON policy reference.

    If the policy isn't valid, Amazon Lex returns a validation exception.

Return type

dict

Returns

Response Syntax

{
    'resourceArn': 'string',
    'revisionId': 'string'
}

Response Structure

  • (dict) --

    • resourceArn (string) --

      The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy was attached to.

    • revisionId (string) --

      The current revision of the resource policy. Use the revision ID to make sure that you are updating the most current version of a resource policy when you add a policy statement to a resource, delete a resource, or update a resource.

Exceptions

  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ThrottlingException
create_resource_policy_statement(**kwargs)

Adds a new resource policy statement to a bot or bot alias. If a resource policy exists, the statement is added to the current resource policy. If a policy doesn't exist, a new policy is created.

You can't create a resource policy statement that allows cross-account access.

See also: AWS API Documentation

Request Syntax

response = client.create_resource_policy_statement(
    resourceArn='string',
    statementId='string',
    effect='Allow'|'Deny',
    principal=[
        {
            'service': 'string',
            'arn': 'string'
        },
    ],
    action=[
        'string',
    ],
    condition={
        'string': {
            'string': 'string'
        }
    },
    expectedRevisionId='string'
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

  • statementId (string) --

    [REQUIRED]

    The name of the statement. The ID is the same as the Sid IAM property. The statement name must be unique within the policy. For more information, see IAM JSON policy elements: Sid.

  • effect (string) --

    [REQUIRED]

    Determines whether the statement allows or denies access to the resource.

  • principal (list) --

    [REQUIRED]

    An IAM principal, such as an IAM users, IAM roles, or AWS services that is allowed or denied access to a resource. For more information, see AWS JSON policy elements: Principal.

    • (dict) --

      The IAM principal that you allowing or denying access to an Amazon Lex action. You must provide a service or an arn , but not both in the same statement. For more information, see AWS JSON policy elements: Principal.

      • service (string) --

        The name of the AWS service that should allowed or denied access to an Amazon Lex action.

      • arn (string) --

        The Amazon Resource Name (ARN) of the principal.

  • action (list) --

    [REQUIRED]

    The Amazon Lex action that this policy either allows or denies. The action must apply to the resource type of the specified ARN. For more information, see Actions, resources, and condition keys for Amazon Lex V2.

    • (string) --
  • condition (dict) --

    Specifies a condition when the policy is in effect. If the principal of the policy is a service principal, you must provide two condition blocks, one with a SourceAccount global condition key and one with a SourceArn global condition key.

    For more information, see IAM JSON policy elements: Condition.

    • (string) --
      • (dict) --
        • (string) --
          • (string) --
  • expectedRevisionId (string) --

    The identifier of the revision of the policy to edit. If this revision ID doesn't match the current revision ID, Amazon Lex throws an exception.

    If you don't specify a revision, Amazon Lex overwrites the contents of the policy with the new values.

Return type

dict

Returns

Response Syntax

{
    'resourceArn': 'string',
    'revisionId': 'string'
}

Response Structure

  • (dict) --

    • resourceArn (string) --

      The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

    • revisionId (string) --

      The current revision of the resource policy. Use the revision ID to make sure that you are updating the most current version of a resource policy when you add a policy statement to a resource, delete a resource, or update a resource.

Exceptions

  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ThrottlingException
create_slot(**kwargs)

Creates a slot in an intent. A slot is a variable needed to fulfill an intent. For example, an OrderPizza intent might need slots for size, crust, and number of pizzas. For each slot, you define one or more utterances that Amazon Lex uses to elicit a response from the user.

See also: AWS API Documentation

Request Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Parameters

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Return type
dict
Returns

Response Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Response Structure

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
create_slot_type(**kwargs)

Creates a custom slot type

To create a custom slot type, specify a name for the slot type and a set of enumeration values, the values that a slot of this type can assume.

See also: AWS API Documentation

Request Syntax

response = client.create_slot_type(
    slotTypeName='string',
    description='string',
    slotTypeValues=[
        {
            'sampleValue': {
                'value': 'string'
            },
            'synonyms': [
                {
                    'value': 'string'
                },
            ]
        },
    ],
    valueSelectionSetting={
        'resolutionStrategy': 'OriginalValue'|'TopResolution'|'Concatenation',
        'regexFilter': {
            'pattern': 'string'
        },
        'advancedRecognitionSetting': {
            'audioRecognitionStrategy': 'UseSlotValuesAsCustomVocabulary'
        }
    },
    parentSlotTypeSignature='string',
    botId='string',
    botVersion='string',
    localeId='string',
    externalSourceSetting={
        'grammarSlotTypeSetting': {
            'source': {
                's3BucketName': 'string',
                's3ObjectKey': 'string',
                'kmsKeyArn': 'string'
            }
        }
    },
    compositeSlotTypeSetting={
        'subSlots': [
            {
                'name': 'string',
                'slotTypeId': 'string'
            },
        ]
    }
)
Parameters
  • slotTypeName (string) --

    [REQUIRED]

    The name for the slot. A slot type name must be unique within the account.

  • description (string) -- A description of the slot type. Use the description to help identify the slot type in lists.
  • slotTypeValues (list) --

    A list of SlotTypeValue objects that defines the values that the slot type can take. Each value can have a list of synonyms, additional values that help train the machine learning model about the values that it resolves for a slot.

    • (dict) --

      Each slot type can have a set of values. Each SlotTypeValue represents a value that the slot type can take.

      • sampleValue (dict) --

        The value of the slot type entry.

        • value (string) -- [REQUIRED]

          The value that can be used for a slot type.

      • synonyms (list) --

        Additional values related to the slot type entry.

        • (dict) --

          Defines one of the values for a slot type.

          • value (string) -- [REQUIRED]

            The value that can be used for a slot type.

  • valueSelectionSetting (dict) --

    Determines the strategy that Amazon Lex uses to select a value from the list of possible values. The field can be set to one of the following values:

    • OriginalValue - Returns the value entered by the user, if the user value is similar to the slot value.
    • TopResolution - If there is a resolution list for the slot, return the first value in the resolution list. If there is no resolution list, return null.

    If you don't specify the valueSelectionSetting parameter, the default is OriginalValue .

    • resolutionStrategy (string) -- [REQUIRED]

      Determines the slot resolution strategy that Amazon Lex uses to return slot type values. The field can be set to one of the following values:

      • OriginalValue - Returns the value entered by the user, if the user value is similar to the slot value.
      • TopResolution - If there is a resolution list for the slot, return the first value in the resolution list as the slot type value. If there is no resolution list, null is returned.

      If you don't specify the valueSelectionStrategy, the default is OriginalValue.

    • regexFilter (dict) --

      A regular expression used to validate the value of a slot.

      • pattern (string) -- [REQUIRED]

        A regular expression used to validate the value of a slot.

        Use a standard regular expression. Amazon Lex supports the following characters in the regular expression:

        • A-Z, a-z
        • 0-9
        • Unicode characters ("u<Unicode>")

        Represent Unicode characters with four digits, for example "u0041" or "u005A".

        The following regular expression operators are not supported:

        • Infinite repeaters: *, +, or {x,} with no upper bound.
        • Wild card (.)
    • advancedRecognitionSetting (dict) --

      Provides settings that enable advanced recognition settings for slot values.

      • audioRecognitionStrategy (string) --

        Enables using the slot values as a custom vocabulary for recognizing user utterances.

  • parentSlotTypeSignature (string) --

    The built-in slot type used as a parent of this slot type. When you define a parent slot type, the new slot type has the configuration of the parent slot type.

    Only AMAZON.AlphaNumeric is supported.

  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with this slot type.

  • botVersion (string) --

    [REQUIRED]

    The identifier of the bot version associated with this slot type.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale that the slot type will be used in. The string must match one of the supported locales. All of the bots, intents, and slots used by the slot type must have the same locale. For more information, see Supported languages.

  • externalSourceSetting (dict) --

    Sets the type of external information used to create the slot type.

    • grammarSlotTypeSetting (dict) --

      Settings required for a slot type based on a grammar that you provide.

      • source (dict) --

        The source of the grammar used to create the slot type.

        • s3BucketName (string) -- [REQUIRED]

          The name of the S3 bucket that contains the grammar source.

        • s3ObjectKey (string) -- [REQUIRED]

          The path to the grammar in the S3 bucket.

        • kmsKeyArn (string) --

          The Amazon KMS key required to decrypt the contents of the grammar, if any.

  • compositeSlotTypeSetting (dict) --

    Specifications for a composite slot type.

    • subSlots (list) --

      Subslots in the composite slot.

      • (dict) --

        Subslot type composition.

        • name (string) -- [REQUIRED]

          Name of a constituent sub slot inside a composite slot.

        • slotTypeId (string) -- [REQUIRED]

          The unique identifier assigned to a slot type. This refers to either a built-in slot type or the unique slotTypeId of a custom slot type.

Return type

dict

Returns

Response Syntax

{
    'slotTypeId': 'string',
    'slotTypeName': 'string',
    'description': 'string',
    'slotTypeValues': [
        {
            'sampleValue': {
                'value': 'string'
            },
            'synonyms': [
                {
                    'value': 'string'
                },
            ]
        },
    ],
    'valueSelectionSetting': {
        'resolutionStrategy': 'OriginalValue'|'TopResolution'|'Concatenation',
        'regexFilter': {
            'pattern': 'string'
        },
        'advancedRecognitionSetting': {
            'audioRecognitionStrategy': 'UseSlotValuesAsCustomVocabulary'
        }
    },
    'parentSlotTypeSignature': 'string',
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'externalSourceSetting': {
        'grammarSlotTypeSetting': {
            'source': {
                's3BucketName': 'string',
                's3ObjectKey': 'string',
                'kmsKeyArn': 'string'
            }
        }
    },
    'compositeSlotTypeSetting': {
        'subSlots': [
            {
                'name': 'string',
                'slotTypeId': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    • slotTypeId (string) --

      The unique identifier assigned to the slot type. Use this to identify the slot type in the UpdateSlotType and DeleteSlotType operations.

    • slotTypeName (string) --

      The name specified for the slot type.

    • description (string) --

      The description specified for the slot type.

    • slotTypeValues (list) --

      The list of values that the slot type can assume.

      • (dict) --

        Each slot type can have a set of values. Each SlotTypeValue represents a value that the slot type can take.

        • sampleValue (dict) --

          The value of the slot type entry.

          • value (string) --

            The value that can be used for a slot type.

        • synonyms (list) --

          Additional values related to the slot type entry.

          • (dict) --

            Defines one of the values for a slot type.

            • value (string) --

              The value that can be used for a slot type.

    • valueSelectionSetting (dict) --

      The strategy that Amazon Lex uses to select a value from the list of possible values.

      • resolutionStrategy (string) --

        Determines the slot resolution strategy that Amazon Lex uses to return slot type values. The field can be set to one of the following values:

        • OriginalValue - Returns the value entered by the user, if the user value is similar to the slot value.
        • TopResolution - If there is a resolution list for the slot, return the first value in the resolution list as the slot type value. If there is no resolution list, null is returned.

        If you don't specify the valueSelectionStrategy, the default is OriginalValue.

      • regexFilter (dict) --

        A regular expression used to validate the value of a slot.

        • pattern (string) --

          A regular expression used to validate the value of a slot.

          Use a standard regular expression. Amazon Lex supports the following characters in the regular expression:

          • A-Z, a-z
          • 0-9
          • Unicode characters ("u<Unicode>")

          Represent Unicode characters with four digits, for example "u0041" or "u005A".

          The following regular expression operators are not supported:

          • Infinite repeaters: *, +, or {x,} with no upper bound.
          • Wild card (.)
      • advancedRecognitionSetting (dict) --

        Provides settings that enable advanced recognition settings for slot values.

        • audioRecognitionStrategy (string) --

          Enables using the slot values as a custom vocabulary for recognizing user utterances.

    • parentSlotTypeSignature (string) --

      The signature of the base slot type specified for the slot type.

    • botId (string) --

      The identifier for the bot associated with the slot type.

    • botVersion (string) --

      The version of the bot associated with the slot type.

    • localeId (string) --

      The specified language and local specified for the slot type.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the slot type was created.

    • externalSourceSetting (dict) --

      The type of external information used to create the slot type.

      • grammarSlotTypeSetting (dict) --

        Settings required for a slot type based on a grammar that you provide.

        • source (dict) --

          The source of the grammar used to create the slot type.

          • s3BucketName (string) --

            The name of the S3 bucket that contains the grammar source.

          • s3ObjectKey (string) --

            The path to the grammar in the S3 bucket.

          • kmsKeyArn (string) --

            The Amazon KMS key required to decrypt the contents of the grammar, if any.

    • compositeSlotTypeSetting (dict) --

      Specifications for a composite slot type.

      • subSlots (list) --

        Subslots in the composite slot.

        • (dict) --

          Subslot type composition.

          • name (string) --

            Name of a constituent sub slot inside a composite slot.

          • slotTypeId (string) --

            The unique identifier assigned to a slot type. This refers to either a built-in slot type or the unique slotTypeId of a custom slot type.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
create_upload_url()

Gets a pre-signed S3 write URL that you use to upload the zip archive when importing a bot or a bot locale.

See also: AWS API Documentation

Request Syntax

response = client.create_upload_url()
Return type
dict
Returns
Response Syntax
{
    'importId': 'string',
    'uploadUrl': 'string'
}

Response Structure

  • (dict) --
    • importId (string) --

      An identifier for a unique import job. Use it when you call the StartImport operation.

    • uploadUrl (string) --

      A pre-signed S3 write URL. Upload the zip archive file that contains the definition of your bot or bot locale.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_bot(**kwargs)

Deletes all versions of a bot, including the Draft version. To delete a specific version, use the DeleteBotVersion operation.

When you delete a bot, all of the resources contained in the bot are also deleted. Deleting a bot removes all locales, intents, slot, and slot types defined for the bot.

If a bot has an alias, the DeleteBot operation returns a ResourceInUseException exception. If you want to delete the bot and the alias, set the skipResourceInUseCheck parameter to true .

See also: AWS API Documentation

Request Syntax

response = client.delete_bot(
    botId='string',
    skipResourceInUseCheck=True|False
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot to delete.

  • skipResourceInUseCheck (boolean) -- By default, Amazon Lex checks if any other resource, such as an alias or bot network, is using the bot version before it is deleted and throws a ResourceInUseException exception if the bot is being used by another resource. Set this parameter to true to skip this check and remove the bot even if it is being used by another resource.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botStatus': 'Creating'|'Available'|'Inactive'|'Deleting'|'Failed'|'Versioning'|'Importing'|'Updating'
}

Response Structure

  • (dict) --

    • botId (string) --

      The unique identifier of the bot that Amazon Lex is deleting.

    • botStatus (string) --

      The current status of the bot. The status is Deleting while the bot and its associated resources are being deleted.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_bot_alias(**kwargs)

Deletes the specified bot alias.

See also: AWS API Documentation

Request Syntax

response = client.delete_bot_alias(
    botAliasId='string',
    botId='string',
    skipResourceInUseCheck=True|False
)
Parameters
  • botAliasId (string) --

    [REQUIRED]

    The unique identifier of the bot alias to delete.

  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot associated with the alias to delete.

  • skipResourceInUseCheck (boolean) -- By default, Amazon Lex checks if any other resource, such as a bot network, is using the bot alias before it is deleted and throws a ResourceInUseException exception if the alias is being used by another resource. Set this parameter to true to skip this check and remove the alias even if it is being used by another resource.
Return type

dict

Returns

Response Syntax

{
    'botAliasId': 'string',
    'botId': 'string',
    'botAliasStatus': 'Creating'|'Available'|'Deleting'|'Failed'
}

Response Structure

  • (dict) --

    • botAliasId (string) --

      The unique identifier of the bot alias to delete.

    • botId (string) --

      The unique identifier of the bot that contains the alias to delete.

    • botAliasStatus (string) --

      The current status of the alias. The status is Deleting while the alias is in the process of being deleted. Once the alias is deleted, it will no longer appear in the list of aliases returned by the ListBotAliases operation.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_bot_locale(**kwargs)

Removes a locale from a bot.

When you delete a locale, all intents, slots, and slot types defined for the locale are also deleted.

See also: AWS API Documentation

Request Syntax

response = client.delete_bot_locale(
    botId='string',
    botVersion='string',
    localeId='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot that contains the locale.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot that contains the locale.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale that will be deleted. The string must match one of the supported locales. For more information, see Supported languages.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'botLocaleStatus': 'Creating'|'Building'|'Built'|'ReadyExpressTesting'|'Failed'|'Deleting'|'NotBuilt'|'Importing'|'Processing'
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot that contained the deleted locale.

    • botVersion (string) --

      The version of the bot that contained the deleted locale.

    • localeId (string) --

      The language and locale of the deleted locale.

    • botLocaleStatus (string) --

      The status of deleting the bot locale. The locale first enters the Deleting status. Once the locale is deleted it no longer appears in the list of locales for the bot.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_bot_version(**kwargs)

Deletes a specific version of a bot. To delete all versions of a bot, use the DeleteBot operation.

See also: AWS API Documentation

Request Syntax

response = client.delete_bot_version(
    botId='string',
    botVersion='string',
    skipResourceInUseCheck=True|False
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot that contains the version.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot to delete.

  • skipResourceInUseCheck (boolean) -- By default, Amazon Lex checks if any other resource, such as an alias or bot network, is using the bot version before it is deleted and throws a ResourceInUseException exception if the version is being used by another resource. Set this parameter to true to skip this check and remove the version even if it is being used by another resource.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'botStatus': 'Creating'|'Available'|'Inactive'|'Deleting'|'Failed'|'Versioning'|'Importing'|'Updating'
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot that is being deleted.

    • botVersion (string) --

      The version of the bot that is being deleted.

    • botStatus (string) --

      The current status of the bot.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_custom_vocabulary(**kwargs)

Removes a custom vocabulary from the specified locale in the specified bot.

See also: AWS API Documentation

Request Syntax

response = client.delete_custom_vocabulary(
    botId='string',
    botVersion='string',
    localeId='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot to remove the custom vocabulary from.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot to remove the custom vocabulary from.

  • localeId (string) --

    [REQUIRED]

    The locale identifier for the locale that contains the custom vocabulary to remove.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'customVocabularyStatus': 'Ready'|'Deleting'|'Exporting'|'Importing'|'Creating'
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot that the custom vocabulary was removed from.

    • botVersion (string) --

      The version of the bot that the custom vocabulary was removed from.

    • localeId (string) --

      The locale identifier for the locale that the custom vocabulary was removed from.

    • customVocabularyStatus (string) --

      The status of removing the custom vocabulary.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_export(**kwargs)

Removes a previous export and the associated files stored in an S3 bucket.

See also: AWS API Documentation

Request Syntax

response = client.delete_export(
    exportId='string'
)
Parameters
exportId (string) --

[REQUIRED]

The unique identifier of the export to delete.

Return type
dict
Returns
Response Syntax
{
    'exportId': 'string',
    'exportStatus': 'InProgress'|'Completed'|'Failed'|'Deleting'
}

Response Structure

  • (dict) --
    • exportId (string) --

      The unique identifier of the deleted export.

    • exportStatus (string) --

      The current status of the deletion. When the deletion is complete, the export will no longer be returned by the ListExports operation and calls to the DescribeExport operation with the export identifier will fail.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_import(**kwargs)

Removes a previous import and the associated file stored in an S3 bucket.

See also: AWS API Documentation

Request Syntax

response = client.delete_import(
    importId='string'
)
Parameters
importId (string) --

[REQUIRED]

The unique identifier of the import to delete.

Return type
dict
Returns
Response Syntax
{
    'importId': 'string',
    'importStatus': 'InProgress'|'Completed'|'Failed'|'Deleting'
}

Response Structure

  • (dict) --
    • importId (string) --

      The unique identifier of the deleted import.

    • importStatus (string) --

      The current status of the deletion. When the deletion is complete, the import will no longer be returned by the ListImports operation and calls to the DescribeImport operation with the import identifier will fail.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_intent(**kwargs)

Removes the specified intent.

Deleting an intent also deletes the slots associated with the intent.

See also: AWS API Documentation

Request Syntax

response = client.delete_intent(
    intentId='string',
    botId='string',
    botVersion='string',
    localeId='string'
)
Parameters
  • intentId (string) --

    [REQUIRED]

    The unique identifier of the intent to delete.

  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the intent.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot associated with the intent.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale where the bot will be deleted. The string must match one of the supported locales. For more information, see Supported languages.

Returns

None

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_resource_policy(**kwargs)

Removes an existing policy from a bot or bot alias. If the resource doesn't have a policy attached, Amazon Lex returns an exception.

See also: AWS API Documentation

Request Syntax

response = client.delete_resource_policy(
    resourceArn='string',
    expectedRevisionId='string'
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the bot or bot alias that has the resource policy attached.

  • expectedRevisionId (string) --

    The identifier of the revision to edit. If this ID doesn't match the current revision number, Amazon Lex returns an exception

    If you don't specify a revision ID, Amazon Lex will delete the current policy.

Return type

dict

Returns

Response Syntax

{
    'resourceArn': 'string',
    'revisionId': 'string'
}

Response Structure

  • (dict) --

    • resourceArn (string) --

      The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy was deleted from.

    • revisionId (string) --

      The current revision of the resource policy. Use the revision ID to make sure that you are updating the most current version of a resource policy when you add a policy statement to a resource, delete a resource, or update a resource.

Exceptions

  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ThrottlingException
delete_resource_policy_statement(**kwargs)

Deletes a policy statement from a resource policy. If you delete the last statement from a policy, the policy is deleted. If you specify a statement ID that doesn't exist in the policy, or if the bot or bot alias doesn't have a policy attached, Amazon Lex returns an exception.

See also: AWS API Documentation

Request Syntax

response = client.delete_resource_policy_statement(
    resourceArn='string',
    statementId='string',
    expectedRevisionId='string'
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

  • statementId (string) --

    [REQUIRED]

    The name of the statement (SID) to delete from the policy.

  • expectedRevisionId (string) --

    The identifier of the revision of the policy to delete the statement from. If this revision ID doesn't match the current revision ID, Amazon Lex throws an exception.

    If you don't specify a revision, Amazon Lex removes the current contents of the statement.

Return type

dict

Returns

Response Syntax

{
    'resourceArn': 'string',
    'revisionId': 'string'
}

Response Structure

  • (dict) --

    • resourceArn (string) --

      The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy statement was removed from.

    • revisionId (string) --

      The current revision of the resource policy. Use the revision ID to make sure that you are updating the most current version of a resource policy when you add a policy statement to a resource, delete a resource, or update a resource.

Exceptions

  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ThrottlingException
delete_slot(**kwargs)

Deletes the specified slot from an intent.

See also: AWS API Documentation

Request Syntax

response = client.delete_slot(
    slotId='string',
    botId='string',
    botVersion='string',
    localeId='string',
    intentId='string'
)
Parameters
  • slotId (string) --

    [REQUIRED]

    The identifier of the slot to delete.

  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the slot to delete.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot associated with the slot to delete.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale that the slot will be deleted from. The string must match one of the supported locales. For more information, see Supported languages.

  • intentId (string) --

    [REQUIRED]

    The identifier of the intent associated with the slot.

Returns

None

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_slot_type(**kwargs)

Deletes a slot type from a bot locale.

If a slot is using the slot type, Amazon Lex throws a ResourceInUseException exception. To avoid the exception, set the skipResourceInUseCheck parameter to true .

See also: AWS API Documentation

Request Syntax

response = client.delete_slot_type(
    slotTypeId='string',
    botId='string',
    botVersion='string',
    localeId='string',
    skipResourceInUseCheck=True|False
)
Parameters
  • slotTypeId (string) --

    [REQUIRED]

    The identifier of the slot type to delete.

  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the slot type.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot associated with the slot type.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale that the slot type will be deleted from. The string must match one of the supported locales. For more information, see Supported languages.

  • skipResourceInUseCheck (boolean) -- By default, the DeleteSlotType operations throws a ResourceInUseException exception if you try to delete a slot type used by a slot. Set the skipResourceInUseCheck parameter to true to skip this check and remove the slot type even if a slot uses it.
Returns

None

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.InternalServerException
delete_utterances(**kwargs)

Deletes stored utterances.

Amazon Lex stores the utterances that users send to your bot. Utterances are stored for 15 days for use with the ListAggregatedUtterances operation, and then stored indefinitely for use in improving the ability of your bot to respond to user input..

Use the DeleteUtterances operation to manually delete utterances for a specific session. When you use the DeleteUtterances operation, utterances stored for improving your bot's ability to respond to user input are deleted immediately. Utterances stored for use with the ListAggregatedUtterances operation are deleted after 15 days.

See also: AWS API Documentation

Request Syntax

response = client.delete_utterances(
    botId='string',
    localeId='string',
    sessionId='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot that contains the utterances.

  • localeId (string) -- The identifier of the language and locale where the utterances were collected. The string must match one of the supported locales. For more information, see Supported languages.
  • sessionId (string) -- The unique identifier of the session with the user. The ID is returned in the response from the RecognizeText and RecognizeUtterance operations.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Exceptions

  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_bot(**kwargs)

Provides metadata information about a bot.

See also: AWS API Documentation

Request Syntax

response = client.describe_bot(
    botId='string'
)
Parameters
botId (string) --

[REQUIRED]

The unique identifier of the bot to describe.

Return type
dict
Returns
Response Syntax
{
    'botId': 'string',
    'botName': 'string',
    'description': 'string',
    'roleArn': 'string',
    'dataPrivacy': {
        'childDirected': True|False
    },
    'idleSessionTTLInSeconds': 123,
    'botStatus': 'Creating'|'Available'|'Inactive'|'Deleting'|'Failed'|'Versioning'|'Importing'|'Updating',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'botType': 'Bot'|'BotNetwork',
    'botMembers': [
        {
            'botMemberId': 'string',
            'botMemberName': 'string',
            'botMemberAliasId': 'string',
            'botMemberAliasName': 'string',
            'botMemberVersion': 'string'
        },
    ],
    'failureReasons': [
        'string',
    ]
}

Response Structure

  • (dict) --
    • botId (string) --

      The unique identifier of the bot.

    • botName (string) --

      The name of the bot.

    • description (string) --

      The description of the bot.

    • roleArn (string) --

      The Amazon Resource Name (ARN) of an IAM role that has permission to access the bot.

    • dataPrivacy (dict) --

      Settings for managing data privacy of the bot and its conversations with users.

      • childDirected (boolean) --

        For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

    • idleSessionTTLInSeconds (integer) --

      The maximum time in seconds that Amazon Lex retains the data gathered in a conversation.

    • botStatus (string) --

      The current status of the bot. When the status is Available the bot is ready to be used in conversations with users.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the bot was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the date and time that the bot was last updated.

    • botType (string) --

      The type of the bot that was described.

    • botMembers (list) --

      The list of bots in the network that was described.

      • (dict) --

        A bot that is a member of a network of bots.

        • botMemberId (string) --

          The unique ID of a bot that is a member of this network of bots.

        • botMemberName (string) --

          The unique name of a bot that is a member of this network of bots.

        • botMemberAliasId (string) --

          The alias ID of a bot that is a member of this network of bots.

        • botMemberAliasName (string) --

          The alias name of a bot that is a member of this network of bots.

        • botMemberVersion (string) --

          The version of a bot that is a member of this network of bots.

    • failureReasons (list) --

      If the botStatus is Failed , this contains a list of reasons that the bot couldn't be built.

      • (string) --

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_bot_alias(**kwargs)

Get information about a specific bot alias.

See also: AWS API Documentation

Request Syntax

response = client.describe_bot_alias(
    botAliasId='string',
    botId='string'
)
Parameters
  • botAliasId (string) --

    [REQUIRED]

    The identifier of the bot alias to describe.

  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the bot alias to describe.

Return type

dict

Returns

Response Syntax

{
    'botAliasId': 'string',
    'botAliasName': 'string',
    'description': 'string',
    'botVersion': 'string',
    'botAliasLocaleSettings': {
        'string': {
            'enabled': True|False,
            'codeHookSpecification': {
                'lambdaCodeHook': {
                    'lambdaARN': 'string',
                    'codeHookInterfaceVersion': 'string'
                }
            }
        }
    },
    'conversationLogSettings': {
        'textLogSettings': [
            {
                'enabled': True|False,
                'destination': {
                    'cloudWatch': {
                        'cloudWatchLogGroupArn': 'string',
                        'logPrefix': 'string'
                    }
                }
            },
        ],
        'audioLogSettings': [
            {
                'enabled': True|False,
                'destination': {
                    's3Bucket': {
                        'kmsKeyArn': 'string',
                        's3BucketArn': 'string',
                        'logPrefix': 'string'
                    }
                }
            },
        ]
    },
    'sentimentAnalysisSettings': {
        'detectSentiment': True|False
    },
    'botAliasHistoryEvents': [
        {
            'botVersion': 'string',
            'startDate': datetime(2015, 1, 1),
            'endDate': datetime(2015, 1, 1)
        },
    ],
    'botAliasStatus': 'Creating'|'Available'|'Deleting'|'Failed',
    'botId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'parentBotNetworks': [
        {
            'botId': 'string',
            'botVersion': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • botAliasId (string) --

      The identifier of the bot alias.

    • botAliasName (string) --

      The name of the bot alias.

    • description (string) --

      The description of the bot alias.

    • botVersion (string) --

      The version of the bot associated with the bot alias.

    • botAliasLocaleSettings (dict) --

      The locale settings that are unique to the alias.

      • (string) --

        • (dict) --

          Specifies settings that are unique to a locale. For example, you can use different Lambda function depending on the bot's locale.

          • enabled (boolean) --

            Determines whether the locale is enabled for the bot. If the value is false , the locale isn't available for use.

          • codeHookSpecification (dict) --

            Specifies the Lambda function that should be used in the locale.

            • lambdaCodeHook (dict) --

              Specifies a Lambda function that verifies requests to a bot or fulfills the user's request to a bot.

              • lambdaARN (string) --

                The Amazon Resource Name (ARN) of the Lambda function.

              • codeHookInterfaceVersion (string) --

                The version of the request-response that you want Amazon Lex to use to invoke your Lambda function.

    • conversationLogSettings (dict) --

      Specifics of how Amazon Lex logs text and audio conversations with the bot associated with the alias.

      • textLogSettings (list) --

        The Amazon CloudWatch Logs settings for logging text and metadata.

        • (dict) --

          Defines settings to enable text conversation logs.

          • enabled (boolean) --

            Determines whether conversation logs should be stored for an alias.

          • destination (dict) --

            Defines the Amazon CloudWatch Logs destination log group for conversation text logs.

            • cloudWatch (dict) --

              Defines the Amazon CloudWatch Logs log group where text and metadata logs are delivered.

              • cloudWatchLogGroupArn (string) --

                The Amazon Resource Name (ARN) of the log group where text and metadata logs are delivered.

              • logPrefix (string) --

                The prefix of the log stream name within the log group that you specified

      • audioLogSettings (list) --

        The Amazon S3 settings for logging audio to an S3 bucket.

        • (dict) --

          Settings for logging audio of conversations between Amazon Lex and a user. You specify whether to log audio and the Amazon S3 bucket where the audio file is stored.

          • enabled (boolean) --

            Determines whether audio logging in enabled for the bot.

          • destination (dict) --

            The location of audio log files collected when conversation logging is enabled for a bot.

            • s3Bucket (dict) --

              The Amazon S3 bucket where the audio log files are stored. The IAM role specified in the roleArn parameter of the CreateBot operation must have permission to write to this bucket.

              • kmsKeyArn (string) --

                The Amazon Resource Name (ARN) of an AWS Key Management Service (KMS) key for encrypting audio log files stored in an S3 bucket.

              • s3BucketArn (string) --

                The Amazon Resource Name (ARN) of an Amazon S3 bucket where audio log files are stored.

              • logPrefix (string) --

                The S3 prefix to assign to audio log files.

    • sentimentAnalysisSettings (dict) --

      Determines whether Amazon Lex will use Amazon Comprehend to detect the sentiment of user utterances.

      • detectSentiment (boolean) --

        Sets whether Amazon Lex uses Amazon Comprehend to detect the sentiment of user utterances.

    • botAliasHistoryEvents (list) --

      A list of events that affect a bot alias. For example, an event is recorded when the version that the alias points to changes.

      • (dict) --

        Provides a record of an event that affects a bot alias. For example, when the version of a bot that the alias points to changes.

        • botVersion (string) --

          The version of the bot that was used in the event.

        • startDate (datetime) --

          The date and time that the event started.

        • endDate (datetime) --

          The date and time that the event ended.

    • botAliasStatus (string) --

      The current status of the alias. When the alias is Available , the alias is ready for use with your bot.

    • botId (string) --

      The identifier of the bot associated with the bot alias.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the alias was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the date and time that the alias was last updated.

    • parentBotNetworks (list) --

      A list of the networks to which the bot alias you described belongs.

      • (dict) --

        A network of bots.

        • botId (string) --

          The identifier of the network of bots assigned by Amazon Lex.

        • botVersion (string) --

          The version of the network of bots.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_bot_locale(**kwargs)

Describes the settings that a bot has for a specific locale.

See also: AWS API Documentation

Request Syntax

response = client.describe_bot_locale(
    botId='string',
    botVersion='string',
    localeId='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the locale.

  • botVersion (string) --

    [REQUIRED]

    The identifier of the version of the bot associated with the locale.

  • localeId (string) --

    [REQUIRED]

    The unique identifier of the locale to describe. The string must match one of the supported locales. For more information, see Supported languages.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'localeName': 'string',
    'description': 'string',
    'nluIntentConfidenceThreshold': 123.0,
    'voiceSettings': {
        'voiceId': 'string',
        'engine': 'standard'|'neural'
    },
    'intentsCount': 123,
    'slotTypesCount': 123,
    'botLocaleStatus': 'Creating'|'Building'|'Built'|'ReadyExpressTesting'|'Failed'|'Deleting'|'NotBuilt'|'Importing'|'Processing',
    'failureReasons': [
        'string',
    ],
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'lastBuildSubmittedDateTime': datetime(2015, 1, 1),
    'botLocaleHistoryEvents': [
        {
            'event': 'string',
            'eventDate': datetime(2015, 1, 1)
        },
    ],
    'recommendedActions': [
        'string',
    ]
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot associated with the locale.

    • botVersion (string) --

      The identifier of the version of the bot associated with the locale.

    • localeId (string) --

      The unique identifier of the described locale.

    • localeName (string) --

      The name of the locale.

    • description (string) --

      The description of the locale.

    • nluIntentConfidenceThreshold (float) --

      The confidence threshold where Amazon Lex inserts the AMAZON.FallbackIntent and AMAZON.KendraSearchIntent intents in the list of possible intents for an utterance.

    • voiceSettings (dict) --

      The Amazon Polly voice Amazon Lex uses for voice interaction with the user.

      • voiceId (string) --

        The identifier of the Amazon Polly voice to use.

      • engine (string) --

        Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the engineparameter of the SynthesizeSpeechoperation in the Amazon Polly developer guide .

        If you do not specify a value, the default is standard .

    • intentsCount (integer) --

      The number of intents defined for the locale.

    • slotTypesCount (integer) --

      The number of slot types defined for the locale.

    • botLocaleStatus (string) --

      The status of the bot. If the status is Failed , the reasons for the failure are listed in the failureReasons field.

    • failureReasons (list) --

      if botLocaleStatus is Failed , Amazon Lex explains why it failed to build the bot.

      • (string) --
    • creationDateTime (datetime) --

      The date and time that the locale was created.

    • lastUpdatedDateTime (datetime) --

      The date and time that the locale was last updated.

    • lastBuildSubmittedDateTime (datetime) --

      The date and time that the locale was last submitted for building.

    • botLocaleHistoryEvents (list) --

      History of changes, such as when a locale is used in an alias, that have taken place for the locale.

      • (dict) --

        Provides information about an event that occurred affecting the bot locale.

        • event (string) --

          A description of the event that occurred.

        • eventDate (datetime) --

          A timestamp of the date and time that the event occurred.

    • recommendedActions (list) --

      Recommended actions to take to resolve an error in the failureReasons field.

      • (string) --

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_bot_recommendation(**kwargs)

Provides metadata information about a bot recommendation. This information will enable you to get a description on the request inputs, to download associated transcripts after processing is complete, and to download intents and slot-types generated by the bot recommendation.

See also: AWS API Documentation

Request Syntax

response = client.describe_bot_recommendation(
    botId='string',
    botVersion='string',
    localeId='string',
    botRecommendationId='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot associated with the bot recommendation.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot associated with the bot recommendation.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the bot recommendation to describe. The string must match one of the supported locales. For more information, see Supported languages.

  • botRecommendationId (string) --

    [REQUIRED]

    The identifier of the bot recommendation to describe.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'botRecommendationStatus': 'Processing'|'Deleting'|'Deleted'|'Downloading'|'Updating'|'Available'|'Failed'|'Stopping'|'Stopped',
    'botRecommendationId': 'string',
    'failureReasons': [
        'string',
    ],
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'transcriptSourceSetting': {
        's3BucketTranscriptSource': {
            's3BucketName': 'string',
            'pathFormat': {
                'objectPrefixes': [
                    'string',
                ]
            },
            'transcriptFormat': 'Lex',
            'transcriptFilter': {
                'lexTranscriptFilter': {
                    'dateRangeFilter': {
                        'startDateTime': datetime(2015, 1, 1),
                        'endDateTime': datetime(2015, 1, 1)
                    }
                }
            },
            'kmsKeyArn': 'string'
        }
    },
    'encryptionSetting': {
        'kmsKeyArn': 'string',
        'botLocaleExportPassword': 'string',
        'associatedTranscriptsPassword': 'string'
    },
    'botRecommendationResults': {
        'botLocaleExportUrl': 'string',
        'associatedTranscriptsUrl': 'string',
        'statistics': {
            'intents': {
                'discoveredIntentCount': 123
            },
            'slotTypes': {
                'discoveredSlotTypeCount': 123
            }
        }
    }
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot associated with the bot recommendation.

    • botVersion (string) --

      The version of the bot associated with the bot recommendation.

    • localeId (string) --

      The identifier of the language and locale of the bot recommendation to describe.

    • botRecommendationStatus (string) --

      The status of the bot recommendation. If the status is Failed, then the reasons for the failure are listed in the failureReasons field.

    • botRecommendationId (string) --

      The identifier of the bot recommendation being described.

    • failureReasons (list) --

      If botRecommendationStatus is Failed, Amazon Lex explains why.

      • (string) --
    • creationDateTime (datetime) --

      The date and time that the bot recommendation was created.

    • lastUpdatedDateTime (datetime) --

      The date and time that the bot recommendation was last updated.

    • transcriptSourceSetting (dict) --

      The object representing the Amazon S3 bucket containing the transcript, as well as the associated metadata.

      • s3BucketTranscriptSource (dict) --

        Indicates the setting of the Amazon S3 bucket where the transcript is stored.

        • s3BucketName (string) --

          The name of the bucket containing the transcript and the associated metadata.

        • pathFormat (dict) --

          The object that contains a path format that will be applied when Amazon Lex reads the transcript file in the bucket you provide. Specify this object if you only want Lex to read a subset of files in your Amazon S3 bucket.

          • objectPrefixes (list) --

            A list of Amazon S3 prefixes that points to sub-folders in the Amazon S3 bucket. Specify this list if you only want Lex to read the files under this set of sub-folders.

            • (string) --
        • transcriptFormat (string) --

          The format of the transcript content. Currently, Genie only supports the Amazon Lex transcript format.

        • transcriptFilter (dict) --

          The object that contains the filter which will be applied when Amazon Lex reads through the Amazon S3 bucket. Specify this object if you want Amazon Lex to read only a subset of the Amazon S3 bucket based on the filter you provide.

          • lexTranscriptFilter (dict) --

            The object representing the filter that Amazon Lex will use to select the appropriate transcript when the transcript format is the Amazon Lex format.

            • dateRangeFilter (dict) --

              The object that contains a date range filter that will be applied to the transcript. Specify this object if you want Amazon Lex to only read the files that are within the date range.

              • startDateTime (datetime) --

                A timestamp indicating the start date for the date range filter.

              • endDateTime (datetime) --

                A timestamp indicating the end date for the date range filter.

        • kmsKeyArn (string) --

          The ARN of the KMS key that customer use to encrypt their Amazon S3 bucket. Only use this field if your bucket is encrypted using a customer managed KMS key.

    • encryptionSetting (dict) --

      The object representing the passwords that were used to encrypt the data related to the bot recommendation results, as well as the KMS key ARN used to encrypt the associated metadata.

      • kmsKeyArn (string) --

        The KMS key ARN used to encrypt the metadata associated with the bot recommendation.

      • botLocaleExportPassword (string) --

        The password used to encrypt the recommended bot recommendation file.

      • associatedTranscriptsPassword (string) --

        The password used to encrypt the associated transcript file.

    • botRecommendationResults (dict) --

      The object representing the URL of the bot definition, the URL of the associated transcript and a statistical summary of the bot recommendation results.

      • botLocaleExportUrl (string) --

        The presigned URL link of the recommended bot definition.

      • associatedTranscriptsUrl (string) --

        The presigned url link of the associated transcript.

      • statistics (dict) --

        The statistical summary of the bot recommendation results.

        • intents (dict) --

          Statistical information about about the intents associated with the bot recommendation results.

          • discoveredIntentCount (integer) --

            The number of recommended intents associated with the bot recommendation.

        • slotTypes (dict) --

          Statistical information about the slot types associated with the bot recommendation results.

          • discoveredSlotTypeCount (integer) --

            The number of recommended slot types associated with the bot recommendation.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_bot_version(**kwargs)

Provides metadata about a version of a bot.

See also: AWS API Documentation

Request Syntax

response = client.describe_bot_version(
    botId='string',
    botVersion='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot containing the version to return metadata for.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot to return metadata for.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botName': 'string',
    'botVersion': 'string',
    'description': 'string',
    'roleArn': 'string',
    'dataPrivacy': {
        'childDirected': True|False
    },
    'idleSessionTTLInSeconds': 123,
    'botStatus': 'Creating'|'Available'|'Inactive'|'Deleting'|'Failed'|'Versioning'|'Importing'|'Updating',
    'failureReasons': [
        'string',
    ],
    'creationDateTime': datetime(2015, 1, 1),
    'parentBotNetworks': [
        {
            'botId': 'string',
            'botVersion': 'string'
        },
    ],
    'botType': 'Bot'|'BotNetwork',
    'botMembers': [
        {
            'botMemberId': 'string',
            'botMemberName': 'string',
            'botMemberAliasId': 'string',
            'botMemberAliasName': 'string',
            'botMemberVersion': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot that contains the version.

    • botName (string) --

      The name of the bot that contains the version.

    • botVersion (string) --

      The version of the bot that was described.

    • description (string) --

      The description specified for the bot.

    • roleArn (string) --

      The Amazon Resource Name (ARN) of an IAM role that has permission to access the bot version.

    • dataPrivacy (dict) --

      Data privacy settings for the bot version.

      • childDirected (boolean) --

        For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

    • idleSessionTTLInSeconds (integer) --

      The number of seconds that a session with the bot remains active before it is discarded by Amazon Lex.

    • botStatus (string) --

      The current status of the bot. When the status is Available , the bot version is ready for use.

    • failureReasons (list) --

      If the botStatus is Failed , this contains a list of reasons that the version couldn't be built.

      • (string) --
    • creationDateTime (datetime) --

      A timestamp of the date and time that the bot version was created.

    • parentBotNetworks (list) --

      A list of the networks to which the bot version you described belongs.

      • (dict) --

        A network of bots.

        • botId (string) --

          The identifier of the network of bots assigned by Amazon Lex.

        • botVersion (string) --

          The version of the network of bots.

    • botType (string) --

      The type of the bot in the version that was described.

    • botMembers (list) --

      The members of bot network in the version that was described.

      • (dict) --

        A bot that is a member of a network of bots.

        • botMemberId (string) --

          The unique ID of a bot that is a member of this network of bots.

        • botMemberName (string) --

          The unique name of a bot that is a member of this network of bots.

        • botMemberAliasId (string) --

          The alias ID of a bot that is a member of this network of bots.

        • botMemberAliasName (string) --

          The alias name of a bot that is a member of this network of bots.

        • botMemberVersion (string) --

          The version of a bot that is a member of this network of bots.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_custom_vocabulary_metadata(**kwargs)

Provides metadata information about a custom vocabulary.

See also: AWS API Documentation

Request Syntax

response = client.describe_custom_vocabulary_metadata(
    botId='string',
    botVersion='string',
    localeId='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot that contains the custom vocabulary.

  • botVersion (string) --

    [REQUIRED]

    The bot version of the bot to return metadata for.

  • localeId (string) --

    [REQUIRED]

    The locale to return the custom vocabulary information for. The locale must be en_GB .

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'customVocabularyStatus': 'Ready'|'Deleting'|'Exporting'|'Importing'|'Creating',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot that contains the custom vocabulary.

    • botVersion (string) --

      The version of the bot that contains the custom vocabulary to describe.

    • localeId (string) --

      The locale that contains the custom vocabulary to describe.

    • customVocabularyStatus (string) --

      The status of the custom vocabulary. If the status is Ready the custom vocabulary is ready to use.

    • creationDateTime (datetime) --

      The date and time that the custom vocabulary was created.

    • lastUpdatedDateTime (datetime) --

      The date and time that the custom vocabulary was last updated.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_export(**kwargs)

Gets information about a specific export.

See also: AWS API Documentation

Request Syntax

response = client.describe_export(
    exportId='string'
)
Parameters
exportId (string) --

[REQUIRED]

The unique identifier of the export to describe.

Return type
dict
Returns
Response Syntax
{
    'exportId': 'string',
    'resourceSpecification': {
        'botExportSpecification': {
            'botId': 'string',
            'botVersion': 'string'
        },
        'botLocaleExportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        },
        'customVocabularyExportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        }
    },
    'fileFormat': 'LexJson'|'TSV',
    'exportStatus': 'InProgress'|'Completed'|'Failed'|'Deleting',
    'failureReasons': [
        'string',
    ],
    'downloadUrl': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --
    • exportId (string) --

      The unique identifier of the described export.

    • resourceSpecification (dict) --

      The bot, bot ID, and optional locale ID of the exported bot or bot locale.

      • botExportSpecification (dict) --

        Parameters for exporting a bot.

        • botId (string) --

          The identifier of the bot assigned by Amazon Lex.

        • botVersion (string) --

          The version of the bot that was exported. This will be either DRAFT or the version number.

      • botLocaleExportSpecification (dict) --

        Parameters for exporting a bot locale.

        • botId (string) --

          The identifier of the bot to create the locale for.

        • botVersion (string) --

          The version of the bot to export.

        • localeId (string) --

          The identifier of the language and locale to export. The string must match one of the locales in the bot.

      • customVocabularyExportSpecification (dict) --

        The parameters required to export a custom vocabulary.

        • botId (string) --

          The identifier of the bot that contains the custom vocabulary to export.

        • botVersion (string) --

          The version of the bot that contains the custom vocabulary to export.

        • localeId (string) --

          The locale of the bot that contains the custom vocabulary to export.

    • fileFormat (string) --

      The file format used in the files that describe the resource.

    • exportStatus (string) --

      The status of the export. When the status is Complete the export archive file is available for download.

    • failureReasons (list) --

      If the exportStatus is failed, contains one or more reasons why the export could not be completed.

      • (string) --
    • downloadUrl (string) --

      A pre-signed S3 URL that points to the bot or bot locale archive. The URL is only available for 5 minutes after calling the DescribeExport operation.

    • creationDateTime (datetime) --

      The date and time that the export was created.

    • lastUpdatedDateTime (datetime) --

      The last date and time that the export was updated.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_import(**kwargs)

Gets information about a specific import.

See also: AWS API Documentation

Request Syntax

response = client.describe_import(
    importId='string'
)
Parameters
importId (string) --

[REQUIRED]

The unique identifier of the import to describe.

Return type
dict
Returns
Response Syntax
{
    'importId': 'string',
    'resourceSpecification': {
        'botImportSpecification': {
            'botName': 'string',
            'roleArn': 'string',
            'dataPrivacy': {
                'childDirected': True|False
            },
            'idleSessionTTLInSeconds': 123,
            'botTags': {
                'string': 'string'
            },
            'testBotAliasTags': {
                'string': 'string'
            }
        },
        'botLocaleImportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string',
            'nluIntentConfidenceThreshold': 123.0,
            'voiceSettings': {
                'voiceId': 'string',
                'engine': 'standard'|'neural'
            }
        },
        'customVocabularyImportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        }
    },
    'importedResourceId': 'string',
    'importedResourceName': 'string',
    'mergeStrategy': 'Overwrite'|'FailOnConflict'|'Append',
    'importStatus': 'InProgress'|'Completed'|'Failed'|'Deleting',
    'failureReasons': [
        'string',
    ],
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --
    • importId (string) --

      The unique identifier of the described import.

    • resourceSpecification (dict) --

      The specifications of the imported bot, bot locale, or custom vocabulary.

      • botImportSpecification (dict) --

        Parameters for importing a bot.

        • botName (string) --

          The name that Amazon Lex should use for the bot.

        • roleArn (string) --

          The Amazon Resource Name (ARN) of the IAM role used to build and run the bot.

        • dataPrivacy (dict) --

          By default, data stored by Amazon Lex is encrypted. The DataPrivacy structure provides settings that determine how Amazon Lex handles special cases of securing the data for your bot.

          • childDirected (boolean) --

            For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

        • idleSessionTTLInSeconds (integer) --

          The time, in seconds, that Amazon Lex should keep information about a user's conversation with the bot.

          A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Lex deletes any data provided before the timeout.

          You can specify between 60 (1 minute) and 86,400 (24 hours) seconds.

        • botTags (dict) --

          A list of tags to add to the bot. You can only add tags when you import a bot. You can't use the UpdateBot operation to update tags. To update tags, use the TagResource operation.

          • (string) --
            • (string) --
        • testBotAliasTags (dict) --

          A list of tags to add to the test alias for a bot. You can only add tags when you import a bot. You can't use the UpdateAlias operation to update tags. To update tags on the test alias, use the TagResource operation.

          • (string) --
            • (string) --
      • botLocaleImportSpecification (dict) --

        Parameters for importing a bot locale.

        • botId (string) --

          The identifier of the bot to import the locale to.

        • botVersion (string) --

          The version of the bot to import the locale to. This can only be the DRAFT version of the bot.

        • localeId (string) --

          The identifier of the language and locale that the bot will be used in. The string must match one of the supported locales. All of the intents, slot types, and slots used in the bot must have the same locale. For more information, see Supported languages.

        • nluIntentConfidenceThreshold (float) --

          Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent , AMAZON.KendraSearchIntent , or both when returning alternative intents. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot.

          For example, suppose a bot is configured with the confidence threshold of 0.80 and the AMAZON.FallbackIntent . Amazon Lex returns three alternative intents with the following confidence scores: IntentA (0.70), IntentB (0.60), IntentC (0.50). The response from the PostText operation would be:

          • AMAZON.FallbackIntent
          • IntentA
          • IntentB
          • IntentC
        • voiceSettings (dict) --

          Defines settings for using an Amazon Polly voice to communicate with a user.

          • voiceId (string) --

            The identifier of the Amazon Polly voice to use.

          • engine (string) --

            Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the engineparameter of the SynthesizeSpeechoperation in the Amazon Polly developer guide .

            If you do not specify a value, the default is standard .

      • customVocabularyImportSpecification (dict) --

        Provides the parameters required for importing a custom vocabulary.

        • botId (string) --

          The identifier of the bot to import the custom vocabulary to.

        • botVersion (string) --

          The version of the bot to import the custom vocabulary to.

        • localeId (string) --

          The identifier of the local to import the custom vocabulary to. The value must be en_GB .

    • importedResourceId (string) --

      The unique identifier that Amazon Lex assigned to the resource created by the import.

    • importedResourceName (string) --

      The name of the imported resource.

    • mergeStrategy (string) --

      The strategy used when there was a name conflict between the imported resource and an existing resource. When the merge strategy is FailOnConflict existing resources are not overwritten and the import fails.

    • importStatus (string) --

      The status of the import process. When the status is Completed the resource is imported and ready for use.

    • failureReasons (list) --

      If the importStatus field is Failed , this provides one or more reasons for the failure.

      • (string) --
    • creationDateTime (datetime) --

      The date and time that the import was created.

    • lastUpdatedDateTime (datetime) --

      The date and time that the import was last updated.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_intent(**kwargs)

Returns metadata about an intent.

See also: AWS API Documentation

Request Syntax

response = client.describe_intent(
    intentId='string',
    botId='string',
    botVersion='string',
    localeId='string'
)
Parameters
  • intentId (string) --

    [REQUIRED]

    The identifier of the intent to describe.

  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the intent.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot associated with the intent.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the intent to describe. The string must match one of the supported locales. For more information, see Supported languages.

Return type

dict

Returns

Response Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Response Structure

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_resource_policy(**kwargs)

Gets the resource policy and policy revision for a bot or bot alias.

See also: AWS API Documentation

Request Syntax

response = client.describe_resource_policy(
    resourceArn='string'
)
Parameters
resourceArn (string) --

[REQUIRED]

The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

Return type
dict
Returns
Response Syntax
{
    'resourceArn': 'string',
    'policy': 'string',
    'revisionId': 'string'
}

Response Structure

  • (dict) --
    • resourceArn (string) --

      The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

    • policy (string) --

      The JSON structure that contains the resource policy. For more information about the contents of a JSON policy document, see IAM JSON policy reference.

    • revisionId (string) --

      The current revision of the resource policy. Use the revision ID to make sure that you are updating the most current version of a resource policy when you add a policy statement to a resource, delete a resource, or update a resource.

Exceptions

  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ThrottlingException
describe_slot(**kwargs)

Gets metadata information about a slot.

See also: AWS API Documentation

Request Syntax

response = client.describe_slot(
    slotId='string',
    botId='string',
    botVersion='string',
    localeId='string',
    intentId='string'
)
Parameters
  • slotId (string) --

    [REQUIRED]

    The unique identifier for the slot.

  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the slot.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot associated with the slot.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the slot to describe. The string must match one of the supported locales. For more information, see Supported languages.

  • intentId (string) --

    [REQUIRED]

    The identifier of the intent that contains the slot.

Return type

dict

Returns

Response Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Response Structure

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
describe_slot_type(**kwargs)

Gets metadata information about a slot type.

See also: AWS API Documentation

Request Syntax

response = client.describe_slot_type(
    slotTypeId='string',
    botId='string',
    botVersion='string',
    localeId='string'
)
Parameters
  • slotTypeId (string) --

    [REQUIRED]

    The identifier of the slot type.

  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the slot type.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot associated with the slot type.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the slot type to describe. The string must match one of the supported locales. For more information, see Supported languages.

Return type

dict

Returns

Response Syntax

{
    'slotTypeId': 'string',
    'slotTypeName': 'string',
    'description': 'string',
    'slotTypeValues': [
        {
            'sampleValue': {
                'value': 'string'
            },
            'synonyms': [
                {
                    'value': 'string'
                },
            ]
        },
    ],
    'valueSelectionSetting': {
        'resolutionStrategy': 'OriginalValue'|'TopResolution'|'Concatenation',
        'regexFilter': {
            'pattern': 'string'
        },
        'advancedRecognitionSetting': {
            'audioRecognitionStrategy': 'UseSlotValuesAsCustomVocabulary'
        }
    },
    'parentSlotTypeSignature': 'string',
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'externalSourceSetting': {
        'grammarSlotTypeSetting': {
            'source': {
                's3BucketName': 'string',
                's3ObjectKey': 'string',
                'kmsKeyArn': 'string'
            }
        }
    },
    'compositeSlotTypeSetting': {
        'subSlots': [
            {
                'name': 'string',
                'slotTypeId': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    • slotTypeId (string) --

      The unique identifier for the slot type.

    • slotTypeName (string) --

      The name specified for the slot type.

    • description (string) --

      The description specified for the slot type.

    • slotTypeValues (list) --

      The values that the slot type can take. Includes any synonyms for the slot type values.

      • (dict) --

        Each slot type can have a set of values. Each SlotTypeValue represents a value that the slot type can take.

        • sampleValue (dict) --

          The value of the slot type entry.

          • value (string) --

            The value that can be used for a slot type.

        • synonyms (list) --

          Additional values related to the slot type entry.

          • (dict) --

            Defines one of the values for a slot type.

            • value (string) --

              The value that can be used for a slot type.

    • valueSelectionSetting (dict) --

      The strategy that Amazon Lex uses to choose a value from a list of possible values.

      • resolutionStrategy (string) --

        Determines the slot resolution strategy that Amazon Lex uses to return slot type values. The field can be set to one of the following values:

        • OriginalValue - Returns the value entered by the user, if the user value is similar to the slot value.
        • TopResolution - If there is a resolution list for the slot, return the first value in the resolution list as the slot type value. If there is no resolution list, null is returned.

        If you don't specify the valueSelectionStrategy, the default is OriginalValue.

      • regexFilter (dict) --

        A regular expression used to validate the value of a slot.

        • pattern (string) --

          A regular expression used to validate the value of a slot.

          Use a standard regular expression. Amazon Lex supports the following characters in the regular expression:

          • A-Z, a-z
          • 0-9
          • Unicode characters ("u<Unicode>")

          Represent Unicode characters with four digits, for example "u0041" or "u005A".

          The following regular expression operators are not supported:

          • Infinite repeaters: *, +, or {x,} with no upper bound.
          • Wild card (.)
      • advancedRecognitionSetting (dict) --

        Provides settings that enable advanced recognition settings for slot values.

        • audioRecognitionStrategy (string) --

          Enables using the slot values as a custom vocabulary for recognizing user utterances.

    • parentSlotTypeSignature (string) --

      The built in slot type used as a parent to this slot type.

    • botId (string) --

      The identifier of the bot associated with the slot type.

    • botVersion (string) --

      The version of the bot associated with the slot type.

    • localeId (string) --

      The language and locale specified for the slot type.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the slot type was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the date and time that the slot type was last updated.

    • externalSourceSetting (dict) --

      Provides information about the external source of the slot type's definition.

      • grammarSlotTypeSetting (dict) --

        Settings required for a slot type based on a grammar that you provide.

        • source (dict) --

          The source of the grammar used to create the slot type.

          • s3BucketName (string) --

            The name of the S3 bucket that contains the grammar source.

          • s3ObjectKey (string) --

            The path to the grammar in the S3 bucket.

          • kmsKeyArn (string) --

            The Amazon KMS key required to decrypt the contents of the grammar, if any.

    • compositeSlotTypeSetting (dict) --

      Specifications for a composite slot type.

      • subSlots (list) --

        Subslots in the composite slot.

        • (dict) --

          Subslot type composition.

          • name (string) --

            Name of a constituent sub slot inside a composite slot.

          • slotTypeId (string) --

            The unique identifier assigned to a slot type. This refers to either a built-in slot type or the unique slotTypeId of a custom slot type.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
list_aggregated_utterances(**kwargs)

Provides a list of utterances that users have sent to the bot.

Utterances are aggregated by the text of the utterance. For example, all instances where customers used the phrase "I want to order pizza" are aggregated into the same line in the response.

You can see both detected utterances and missed utterances. A detected utterance is where the bot properly recognized the utterance and activated the associated intent. A missed utterance was not recognized by the bot and didn't activate an intent.

Utterances can be aggregated for a bot alias or for a bot version, but not both at the same time.

Utterances statistics are not generated under the following conditions:

  • The childDirected field was set to true when the bot was created.
  • You are using slot obfuscation with one or more slots.
  • You opted out of participating in improving Amazon Lex.

See also: AWS API Documentation

Request Syntax

response = client.list_aggregated_utterances(
    botId='string',
    botAliasId='string',
    botVersion='string',
    localeId='string',
    aggregationDuration={
        'relativeAggregationDuration': {
            'timeDimension': 'Hours'|'Days'|'Weeks',
            'timeValue': 123
        }
    },
    sortBy={
        'attribute': 'HitCount'|'MissedCount',
        'order': 'Ascending'|'Descending'
    },
    filters=[
        {
            'name': 'Utterance',
            'values': [
                'string',
            ],
            'operator': 'CO'|'EQ'
        },
    ],
    maxResults=123,
    nextToken='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot associated with this request.

  • botAliasId (string) -- The identifier of the bot alias associated with this request. If you specify the bot alias, you can't specify the bot version.
  • botVersion (string) -- The identifier of the bot version associated with this request. If you specify the bot version, you can't specify the bot alias.
  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale where the utterances were collected. For more information, see Supported languages.

  • aggregationDuration (dict) --

    [REQUIRED]

    The time window for aggregating the utterance information. You can specify a time between one hour and two weeks.

    • relativeAggregationDuration (dict) -- [REQUIRED]

      The desired time window for aggregating utterances.

      • timeDimension (string) -- [REQUIRED]

        The type of time period that the timeValue field represents.

      • timeValue (integer) -- [REQUIRED]

        The period of the time window to gather statistics for. The valid value depends on the setting of the timeDimension field.

        • Hours - 1/3/6/12/24
        • Days - 3
        • Weeks - 1/2
  • sortBy (dict) --

    Specifies sorting parameters for the list of utterances. You can sort by the hit count, the missed count, or the number of distinct sessions the utterance appeared in.

    • attribute (string) -- [REQUIRED]

      The utterance attribute to sort by.

    • order (string) -- [REQUIRED]

      Specifies whether to sort the aggregated utterances in ascending or descending order.

  • filters (list) --

    Provides the specification of a filter used to limit the utterances in the response to only those that match the filter specification. You can only specify one filter and one string to filter on.

    • (dict) --

      Filters responses returned by the ListAggregatedUtterances operation.

      • name (string) -- [REQUIRED]

        The name of the field to filter the utterance list.

      • values (list) -- [REQUIRED]

        The value to use for filtering the list of bots.

        • (string) --
      • operator (string) -- [REQUIRED]

        The operator to use for the filter. Specify EQ when the ListAggregatedUtterances operation should return only utterances that equal the specified value. Specify CO when the ListAggregatedUtterances operation should return utterances that contain the specified value.

  • maxResults (integer) -- The maximum number of utterances to return in each page of results. If there are fewer results than the maximum page size, only the actual number of results are returned. If you don't specify the maxResults parameter, 1,000 results are returned.
  • nextToken (string) -- If the response from the ListAggregatedUtterances operation contains more results that specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botAliasId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'aggregationDuration': {
        'relativeAggregationDuration': {
            'timeDimension': 'Hours'|'Days'|'Weeks',
            'timeValue': 123
        }
    },
    'aggregationWindowStartTime': datetime(2015, 1, 1),
    'aggregationWindowEndTime': datetime(2015, 1, 1),
    'aggregationLastRefreshedDateTime': datetime(2015, 1, 1),
    'aggregatedUtterancesSummaries': [
        {
            'utterance': 'string',
            'hitCount': 123,
            'missedCount': 123,
            'utteranceFirstRecordedInAggregationDuration': datetime(2015, 1, 1),
            'utteranceLastRecordedInAggregationDuration': datetime(2015, 1, 1),
            'containsDataFromDeletedResources': True|False
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot that contains the utterances.

    • botAliasId (string) --

      The identifier of the bot alias that contains the utterances. If you specified the bot version, the bot alias ID isn't returned.

    • botVersion (string) --

      The identifier of the bot version that contains the utterances. If you specified the bot alias, the bot version isn't returned.

    • localeId (string) --

      The identifier of the language and locale that the utterances are in.

    • aggregationDuration (dict) --

      The time period used to aggregate the utterance data.

      • relativeAggregationDuration (dict) --

        The desired time window for aggregating utterances.

        • timeDimension (string) --

          The type of time period that the timeValue field represents.

        • timeValue (integer) --

          The period of the time window to gather statistics for. The valid value depends on the setting of the timeDimension field.

          • Hours - 1/3/6/12/24
          • Days - 3
          • Weeks - 1/2
    • aggregationWindowStartTime (datetime) --

      The date and time that the aggregation window begins. Only data collected after this time is returned in the results.

    • aggregationWindowEndTime (datetime) --

      The date and time that the aggregation window ends. Only data collected between the start time and the end time are returned in the results.

    • aggregationLastRefreshedDateTime (datetime) --

      The last date and time that the aggregated data was collected. The time period depends on the length of the aggregation window.

      • Hours - for 1 hour time window, every half hour; otherwise every hour.
      • Days - every 6 hours
      • Weeks - for a one week time window, every 12 hours; otherwise, every day
    • aggregatedUtterancesSummaries (list) --

      Summaries of the aggregated utterance data. Each response contains information about the number of times that the utterance was seen during the time period, whether it was detected or missed, and when it was seen during the time period.

      • (dict) --

        Provides summary information for aggregated utterances. The ListAggregatedUtterances operations combines all instances of the same utterance into a single aggregated summary.

        • utterance (string) --

          The text of the utterance. If the utterance was used with the RecognizeUtterance operation, the text is the transcription of the audio utterance.

        • hitCount (integer) --

          The number of times that the utterance was detected by Amazon Lex during the time period. When an utterance is detected, it activates an intent or a slot.

        • missedCount (integer) --

          The number of times that the utterance was missed by Amazon Lex An utterance is missed when it doesn't activate an intent or slot.

        • utteranceFirstRecordedInAggregationDuration (datetime) --

          The date and time that the utterance was first recorded in the time window for aggregation. An utterance may have been sent to Amazon Lex before that time, but only utterances within the time window are counted.

        • utteranceLastRecordedInAggregationDuration (datetime) --

          The last date and time that an utterance was recorded in the time window for aggregation. An utterance may be sent to Amazon Lex after that time, but only utterances within the time window are counted.

        • containsDataFromDeletedResources (boolean) --

          Aggregated utterance data may contain utterances from versions of your bot that have since been deleted. When the aggregated contains this kind of data, this field is set to true.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListAggregatedUtterances operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListAggregatedUtterances operation request to get the next page of results.

Exceptions

  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.InternalServerException
list_bot_aliases(**kwargs)

Gets a list of aliases for the specified bot.

See also: AWS API Documentation

Request Syntax

response = client.list_bot_aliases(
    botId='string',
    maxResults=123,
    nextToken='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot to list aliases for.

  • maxResults (integer) -- The maximum number of aliases to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) -- If the response from the ListBotAliases operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.
Return type

dict

Returns

Response Syntax

{
    'botAliasSummaries': [
        {
            'botAliasId': 'string',
            'botAliasName': 'string',
            'description': 'string',
            'botVersion': 'string',
            'botAliasStatus': 'Creating'|'Available'|'Deleting'|'Failed',
            'creationDateTime': datetime(2015, 1, 1),
            'lastUpdatedDateTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string',
    'botId': 'string'
}

Response Structure

  • (dict) --

    • botAliasSummaries (list) --

      Summary information for the bot aliases that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter of the request. If there are more aliases available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        Summary information about bot aliases returned from the ListBotAliases operation.

        • botAliasId (string) --

          The unique identifier assigned to the bot alias. You can use this ID to get detailed information about the alias using the DescribeBotAlias operation.

        • botAliasName (string) --

          The name of the bot alias.

        • description (string) --

          The description of the bot alias.

        • botVersion (string) --

          The version of the bot that the bot alias references.

        • botAliasStatus (string) --

          The current state of the bot alias. If the status is Available , the alias is ready for use.

        • creationDateTime (datetime) --

          A timestamp of the date and time that the bot alias was created.

        • lastUpdatedDateTime (datetime) --

          A timestamp of the date and time that the bot alias was last updated.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListBotAliases operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListBotAliases operation request to get the next page of results.

    • botId (string) --

      The identifier of the bot associated with the aliases.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
list_bot_locales(**kwargs)

Gets a list of locales for the specified bot.

See also: AWS API Documentation

Request Syntax

response = client.list_bot_locales(
    botId='string',
    botVersion='string',
    sortBy={
        'attribute': 'BotLocaleName',
        'order': 'Ascending'|'Descending'
    },
    filters=[
        {
            'name': 'BotLocaleName',
            'values': [
                'string',
            ],
            'operator': 'CO'|'EQ'
        },
    ],
    maxResults=123,
    nextToken='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot to list locales for.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot to list locales for.

  • sortBy (dict) --

    Specifies sorting parameters for the list of locales. You can sort by locale name in ascending or descending order.

    • attribute (string) -- [REQUIRED]

      The bot locale attribute to sort by.

    • order (string) -- [REQUIRED]

      Specifies whether to sort the bot locales in ascending or descending order.

  • filters (list) --

    Provides the specification for a filter used to limit the response to only those locales that match the filter specification. You can only specify one filter and one value to filter on.

    • (dict) --

      Filters responses returned by the ListBotLocales operation.

      • name (string) -- [REQUIRED]

        The name of the field to filter the list of bots.

      • values (list) -- [REQUIRED]

        The value to use for filtering the list of bots.

        • (string) --
      • operator (string) -- [REQUIRED]

        The operator to use for the filter. Specify EQ when the ListBotLocales operation should return only aliases that equal the specified value. Specify CO when the ListBotLocales operation should return aliases that contain the specified value.

  • maxResults (integer) -- The maximum number of aliases to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) -- If the response from the ListBotLocales operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token as the nextToken parameter to return the next page of results.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'nextToken': 'string',
    'botLocaleSummaries': [
        {
            'localeId': 'string',
            'localeName': 'string',
            'description': 'string',
            'botLocaleStatus': 'Creating'|'Building'|'Built'|'ReadyExpressTesting'|'Failed'|'Deleting'|'NotBuilt'|'Importing'|'Processing',
            'lastUpdatedDateTime': datetime(2015, 1, 1),
            'lastBuildSubmittedDateTime': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot to list locales for.

    • botVersion (string) --

      The version of the bot.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListBotLocales operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListBotLocales operation request to get the next page of results.

    • botLocaleSummaries (list) --

      Summary information for the locales that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter of the request. If there are more locales available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        Summary information about bot locales returned by the ListBotLocales operation.

        • localeId (string) --

          The language and locale of the bot locale.

        • localeName (string) --

          The name of the bot locale.

        • description (string) --

          The description of the bot locale.

        • botLocaleStatus (string) --

          The current status of the bot locale. When the status is Built the locale is ready for use.

        • lastUpdatedDateTime (datetime) --

          A timestamp of the date and time that the bot locale was last updated.

        • lastBuildSubmittedDateTime (datetime) --

          A timestamp of the date and time that the bot locale was last built.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
list_bot_recommendations(**kwargs)

Get a list of bot recommendations that meet the specified criteria.

See also: AWS API Documentation

Request Syntax

response = client.list_bot_recommendations(
    botId='string',
    botVersion='string',
    localeId='string',
    maxResults=123,
    nextToken='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot that contains the bot recommendation list.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot that contains the bot recommendation list.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the bot recommendation list.

  • maxResults (integer) -- The maximum number of bot recommendations to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) -- If the response from the ListBotRecommendation operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'botRecommendationSummaries': [
        {
            'botRecommendationStatus': 'Processing'|'Deleting'|'Deleted'|'Downloading'|'Updating'|'Available'|'Failed'|'Stopping'|'Stopped',
            'botRecommendationId': 'string',
            'creationDateTime': datetime(2015, 1, 1),
            'lastUpdatedDateTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The unique identifier of the bot that contains the bot recommendation list.

    • botVersion (string) --

      The version of the bot that contains the bot recommendation list.

    • localeId (string) --

      The identifier of the language and locale of the bot recommendation list.

    • botRecommendationSummaries (list) --

      Summary information for the bot recommendations that meet the filter specified in this request. The length of the list is specified in the maxResults parameter of the request. If there are more bot recommendations available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        A summary of the bot recommendation.

        • botRecommendationStatus (string) --

          The status of the bot recommendation.

          If the status is Failed, then the reasons for the failure are listed in the failureReasons field.

        • botRecommendationId (string) --

          The unique identifier of the bot recommendation to be updated.

        • creationDateTime (datetime) --

          A timestamp of the date and time that the bot recommendation was created.

        • lastUpdatedDateTime (datetime) --

          A timestamp of the date and time that the bot recommendation was last updated.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListBotRecommendations operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListBotRecommendations operation request to get the next page of results.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
list_bot_versions(**kwargs)

Gets information about all of the versions of a bot.

The ListBotVersions operation returns a summary of each version of a bot. For example, if a bot has three numbered versions, the ListBotVersions operation returns for summaries, one for each numbered version and one for the DRAFT version.

The ListBotVersions operation always returns at least one version, the DRAFT version.

See also: AWS API Documentation

Request Syntax

response = client.list_bot_versions(
    botId='string',
    sortBy={
        'attribute': 'BotVersion',
        'order': 'Ascending'|'Descending'
    },
    maxResults=123,
    nextToken='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot to list versions for.

  • sortBy (dict) --

    Specifies sorting parameters for the list of versions. You can specify that the list be sorted by version name in either ascending or descending order.

    • attribute (string) -- [REQUIRED]

      The attribute to use to sort the list of versions.

    • order (string) -- [REQUIRED]

      The order to sort the list. You can specify ascending or descending order.

  • maxResults (integer) -- The maximum number of versions to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) -- If the response to the ListBotVersion operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersionSummaries': [
        {
            'botName': 'string',
            'botVersion': 'string',
            'description': 'string',
            'botStatus': 'Creating'|'Available'|'Inactive'|'Deleting'|'Failed'|'Versioning'|'Importing'|'Updating',
            'creationDateTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot to list versions for.

    • botVersionSummaries (list) --

      Summary information for the bot versions that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter of the request. If there are more versions available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        Summary information about a bot version returned by the ListBotVersions operation.

        • botName (string) --

          The name of the bot associated with the version.

        • botVersion (string) --

          The numeric version of the bot, or DRAFT to indicate that this is the version of the bot that can be updated..

        • description (string) --

          The description of the version.

        • botStatus (string) --

          The status of the bot. When the status is available, the version of the bot is ready for use.

        • creationDateTime (datetime) --

          A timestamp of the date and time that the version was created.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListBotVersions operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListBotAliases operation request to get the next page of results.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
list_bots(**kwargs)

Gets a list of available bots.

See also: AWS API Documentation

Request Syntax

response = client.list_bots(
    sortBy={
        'attribute': 'BotName',
        'order': 'Ascending'|'Descending'
    },
    filters=[
        {
            'name': 'BotName'|'BotType',
            'values': [
                'string',
            ],
            'operator': 'CO'|'EQ'|'NE'
        },
    ],
    maxResults=123,
    nextToken='string'
)
Parameters
  • sortBy (dict) --

    Specifies sorting parameters for the list of bots. You can specify that the list be sorted by bot name in ascending or descending order.

    • attribute (string) -- [REQUIRED]

      The attribute to use to sort the list of bots.

    • order (string) -- [REQUIRED]

      The order to sort the list. You can choose ascending or descending.

  • filters (list) --

    Provides the specification of a filter used to limit the bots in the response to only those that match the filter specification. You can only specify one filter and one string to filter on.

    • (dict) --

      Filters the responses returned by the ListBots operation.

      • name (string) -- [REQUIRED]

        The name of the field to filter the list of bots.

      • values (list) -- [REQUIRED]

        The value to use for filtering the list of bots.

        • (string) --
      • operator (string) -- [REQUIRED]

        The operator to use for the filter. Specify EQ when the ListBots operation should return only aliases that equal the specified value. Specify CO when the ListBots operation should return aliases that contain the specified value.

  • maxResults (integer) -- The maximum number of bots to return in each page of results. If there are fewer results than the maximum page size, only the actual number of results are returned.
  • nextToken (string) --

    If the response from the ListBots operation contains more results than specified in the maxResults parameter, a token is returned in the response.

    Use the returned token in the nextToken parameter of a ListBots request to return the next page of results. For a complete set of results, call the ListBots operation until the nextToken returned in the response is null.

Return type

dict

Returns

Response Syntax

{
    'botSummaries': [
        {
            'botId': 'string',
            'botName': 'string',
            'description': 'string',
            'botStatus': 'Creating'|'Available'|'Inactive'|'Deleting'|'Failed'|'Versioning'|'Importing'|'Updating',
            'latestBotVersion': 'string',
            'lastUpdatedDateTime': datetime(2015, 1, 1),
            'botType': 'Bot'|'BotNetwork'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • botSummaries (list) --

      Summary information for the bots that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter of the request. If there are more bots available, the nextToken field contains a token to the next page of results.

      • (dict) --

        Summary information about a bot returned by the ListBots operation.

        • botId (string) --

          The unique identifier assigned to the bot. Use this ID to get detailed information about the bot with the DescribeBot operation.

        • botName (string) --

          The name of the bot.

        • description (string) --

          The description of the bot.

        • botStatus (string) --

          The current status of the bot. When the status is Available the bot is ready for use.

        • latestBotVersion (string) --

          The latest numerical version in use for the bot.

        • lastUpdatedDateTime (datetime) --

          The date and time that the bot was last updated.

        • botType (string) --

          The type of the bot.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListBots operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListBots operation request to get the next page of results.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
list_built_in_intents(**kwargs)

Gets a list of built-in intents provided by Amazon Lex that you can use in your bot.

To use a built-in intent as a the base for your own intent, include the built-in intent signature in the parentIntentSignature parameter when you call the CreateIntent operation. For more information, see CreateIntent.

See also: AWS API Documentation

Request Syntax

response = client.list_built_in_intents(
    localeId='string',
    sortBy={
        'attribute': 'IntentSignature',
        'order': 'Ascending'|'Descending'
    },
    maxResults=123,
    nextToken='string'
)
Parameters
  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the intents to list. The string must match one of the supported locales. For more information, see Supported languages.

  • sortBy (dict) --

    Specifies sorting parameters for the list of built-in intents. You can specify that the list be sorted by the built-in intent signature in either ascending or descending order.

    • attribute (string) -- [REQUIRED]

      The attribute to use to sort the list of built-in intents.

    • order (string) -- [REQUIRED]

      The order to sort the list. You can specify ascending or descending order.

  • maxResults (integer) -- The maximum number of built-in intents to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) -- If the response from the ListBuiltInIntents operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.
Return type

dict

Returns

Response Syntax

{
    'builtInIntentSummaries': [
        {
            'intentSignature': 'string',
            'description': 'string'
        },
    ],
    'nextToken': 'string',
    'localeId': 'string'
}

Response Structure

  • (dict) --

    • builtInIntentSummaries (list) --

      Summary information for the built-in intents that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter of the request. If there are more intents available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        Provides summary information about a built-in intent for the ListBuiltInIntents operation.

        • intentSignature (string) --

          The signature of the built-in intent. Use this to specify the parent intent of a derived intent.

        • description (string) --

          The description of the intent.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListBuiltInIntents operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListBotAliases operation request to get the next page of results.

    • localeId (string) --

      The language and locale of the intents in the list.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
list_built_in_slot_types(**kwargs)

Gets a list of built-in slot types that meet the specified criteria.

See also: AWS API Documentation

Request Syntax

response = client.list_built_in_slot_types(
    localeId='string',
    sortBy={
        'attribute': 'SlotTypeSignature',
        'order': 'Ascending'|'Descending'
    },
    maxResults=123,
    nextToken='string'
)
Parameters
  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the slot types to list. The string must match one of the supported locales. For more information, see Supported languages.

  • sortBy (dict) --

    Determines the sort order for the response from the ListBuiltInSlotTypes operation. You can choose to sort by the slot type signature in either ascending or descending order.

    • attribute (string) -- [REQUIRED]

      The attribute to use to sort the list of built-in intents.

    • order (string) -- [REQUIRED]

      The order to sort the list. You can choose ascending or descending.

  • maxResults (integer) -- The maximum number of built-in slot types to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) -- If the response from the ListBuiltInSlotTypes operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.
Return type

dict

Returns

Response Syntax

{
    'builtInSlotTypeSummaries': [
        {
            'slotTypeSignature': 'string',
            'description': 'string'
        },
    ],
    'nextToken': 'string',
    'localeId': 'string'
}

Response Structure

  • (dict) --

    • builtInSlotTypeSummaries (list) --

      Summary information for the built-in slot types that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter of the request. If there are more slot types available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        Provides summary information about a built-in slot type for the ListBuiltInSlotTypes operation.

        • slotTypeSignature (string) --

          The signature of the built-in slot type. Use this to specify the parent slot type of a derived slot type.

        • description (string) --

          The description of the built-in slot type.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListBuiltInSlotTypes operation. If the nextToken field is present, you send the contents as the nextToken parameter of a LIstBuiltInSlotTypes operation request to get the next page of results.

    • localeId (string) --

      The language and locale of the slot types in the list.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
list_custom_vocabulary_items(**kwargs)

Paginated list of custom vocabulary items for a given bot locale's custom vocabulary.

See also: AWS API Documentation

Request Syntax

response = client.list_custom_vocabulary_items(
    botId='string',
    botVersion='string',
    localeId='string',
    maxResults=123,
    nextToken='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the version of the bot associated with this custom vocabulary.

  • botVersion (string) --

    [REQUIRED]

    The bot version of the bot to the list custom vocabulary request.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale where this custom vocabulary is used. The string must match one of the supported locales. For more information, see Supported languages (https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html).

  • maxResults (integer) -- The maximum number of items returned by the list operation.
  • nextToken (string) -- The nextToken identifier to the list custom vocabulary request.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'customVocabularyItems': [
        {
            'itemId': 'string',
            'phrase': 'string',
            'weight': 123,
            'displayAs': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot associated with this custom vocabulary.

    • botVersion (string) --

      The identifier of the version of the bot associated with this custom vocabulary.

    • localeId (string) --

      The identifier of the language and locale where this custom vocabulary is used. The string must match one of the supported locales. For more information, see Supported Languages.

    • customVocabularyItems (list) --

      The custom vocabulary items from the list custom vocabulary response.

      • (dict) --

        The unique custom vocabulary item from the custom vocabulary list.

        • itemId (string) --

          The unique item identifer for the custom vocabulary item from the custom vocabulary list.

        • phrase (string) --

          The unique phrase for the custom vocabulary item from the custom vocabulary list.

        • weight (integer) --

          The weight assigned for the custom vocabulary item from the custom vocabulary list.

        • displayAs (string) --

          The DisplayAs value for the custom vocabulary item from the custom vocabulary list.

    • nextToken (string) --

      The nextToken identifier to the list custom vocabulary response.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.InternalServerException
list_exports(**kwargs)

Lists the exports for a bot, bot locale, or custom vocabulary. Exports are kept in the list for 7 days.

See also: AWS API Documentation

Request Syntax

response = client.list_exports(
    botId='string',
    botVersion='string',
    sortBy={
        'attribute': 'LastUpdatedDateTime',
        'order': 'Ascending'|'Descending'
    },
    filters=[
        {
            'name': 'ExportResourceType',
            'values': [
                'string',
            ],
            'operator': 'CO'|'EQ'
        },
    ],
    maxResults=123,
    nextToken='string',
    localeId='string'
)
Parameters
  • botId (string) -- The unique identifier that Amazon Lex assigned to the bot.
  • botVersion (string) -- The version of the bot to list exports for.
  • sortBy (dict) --

    Determines the field that the list of exports is sorted by. You can sort by the LastUpdatedDateTime field in ascending or descending order.

    • attribute (string) -- [REQUIRED]

      The export field to use for sorting.

    • order (string) -- [REQUIRED]

      The order to sort the list.

  • filters (list) --

    Provides the specification of a filter used to limit the exports in the response to only those that match the filter specification. You can only specify one filter and one string to filter on.

    • (dict) --

      Filters the response form the ListExports operation

      • name (string) -- [REQUIRED]

        The name of the field to use for filtering.

      • values (list) -- [REQUIRED]

        The values to use to filter the response. The values must be Bot , BotLocale , or CustomVocabulary .

        • (string) --
      • operator (string) -- [REQUIRED]

        The operator to use for the filter. Specify EQ when the ListExports operation should return only resource types that equal the specified value. Specify CO when the ListExports operation should return resource types that contain the specified value.

  • maxResults (integer) -- The maximum number of exports to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) --

    If the response from the ListExports operation contains more results that specified in the maxResults parameter, a token is returned in the response.

    Use the returned token in the nextToken parameter of a ListExports request to return the next page of results. For a complete set of results, call the ListExports operation until the nextToken returned in the response is null.

  • localeId (string) -- Specifies the resources that should be exported. If you don't specify a resource type in the filters parameter, both bot locales and custom vocabularies are exported.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'exportSummaries': [
        {
            'exportId': 'string',
            'resourceSpecification': {
                'botExportSpecification': {
                    'botId': 'string',
                    'botVersion': 'string'
                },
                'botLocaleExportSpecification': {
                    'botId': 'string',
                    'botVersion': 'string',
                    'localeId': 'string'
                },
                'customVocabularyExportSpecification': {
                    'botId': 'string',
                    'botVersion': 'string',
                    'localeId': 'string'
                }
            },
            'fileFormat': 'LexJson'|'TSV',
            'exportStatus': 'InProgress'|'Completed'|'Failed'|'Deleting',
            'creationDateTime': datetime(2015, 1, 1),
            'lastUpdatedDateTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string',
    'localeId': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The unique identifier assigned to the bot by Amazon Lex.

    • botVersion (string) --

      The version of the bot that was exported.

    • exportSummaries (list) --

      Summary information for the exports that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter. If there are more exports available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        Provides summary information about an export in an export list.

        • exportId (string) --

          The unique identifier that Amazon Lex assigned to the export.

        • resourceSpecification (dict) --

          Information about the bot or bot locale that was exported.

          • botExportSpecification (dict) --

            Parameters for exporting a bot.

            • botId (string) --

              The identifier of the bot assigned by Amazon Lex.

            • botVersion (string) --

              The version of the bot that was exported. This will be either DRAFT or the version number.

          • botLocaleExportSpecification (dict) --

            Parameters for exporting a bot locale.

            • botId (string) --

              The identifier of the bot to create the locale for.

            • botVersion (string) --

              The version of the bot to export.

            • localeId (string) --

              The identifier of the language and locale to export. The string must match one of the locales in the bot.

          • customVocabularyExportSpecification (dict) --

            The parameters required to export a custom vocabulary.

            • botId (string) --

              The identifier of the bot that contains the custom vocabulary to export.

            • botVersion (string) --

              The version of the bot that contains the custom vocabulary to export.

            • localeId (string) --

              The locale of the bot that contains the custom vocabulary to export.

        • fileFormat (string) --

          The file format used in the export files.

        • exportStatus (string) --

          The status of the export. When the status is Completed the export is ready to download.

        • creationDateTime (datetime) --

          The date and time that the export was created.

        • lastUpdatedDateTime (datetime) --

          The date and time that the export was last updated.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListExports operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListExports operation request to get the next page of results.

    • localeId (string) --

      The locale specified in the request.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
list_imports(**kwargs)

Lists the imports for a bot, bot locale, or custom vocabulary. Imports are kept in the list for 7 days.

See also: AWS API Documentation

Request Syntax

response = client.list_imports(
    botId='string',
    botVersion='string',
    sortBy={
        'attribute': 'LastUpdatedDateTime',
        'order': 'Ascending'|'Descending'
    },
    filters=[
        {
            'name': 'ImportResourceType',
            'values': [
                'string',
            ],
            'operator': 'CO'|'EQ'
        },
    ],
    maxResults=123,
    nextToken='string',
    localeId='string'
)
Parameters
  • botId (string) -- The unique identifier that Amazon Lex assigned to the bot.
  • botVersion (string) -- The version of the bot to list imports for.
  • sortBy (dict) --

    Determines the field that the list of imports is sorted by. You can sort by the LastUpdatedDateTime field in ascending or descending order.

    • attribute (string) -- [REQUIRED]

      The export field to use for sorting.

    • order (string) -- [REQUIRED]

      The order to sort the list.

  • filters (list) --

    Provides the specification of a filter used to limit the bots in the response to only those that match the filter specification. You can only specify one filter and one string to filter on.

    • (dict) --

      Filters the response from the ListImports operation.

      • name (string) -- [REQUIRED]

        The name of the field to use for filtering.

      • values (list) -- [REQUIRED]

        The values to use to filter the response. The values must be Bot , BotLocale , or CustomVocabulary .

        • (string) --
      • operator (string) -- [REQUIRED]

        The operator to use for the filter. Specify EQ when the ListImports operation should return only resource types that equal the specified value. Specify CO when the ListImports operation should return resource types that contain the specified value.

  • maxResults (integer) -- The maximum number of imports to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) --

    If the response from the ListImports operation contains more results than specified in the maxResults parameter, a token is returned in the response.

    Use the returned token in the nextToken parameter of a ListImports request to return the next page of results. For a complete set of results, call the ListImports operation until the nextToken returned in the response is null.

  • localeId (string) -- Specifies the locale that should be present in the list. If you don't specify a resource type in the filters parameter, the list contains both bot locales and custom vocabularies.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'importSummaries': [
        {
            'importId': 'string',
            'importedResourceId': 'string',
            'importedResourceName': 'string',
            'importStatus': 'InProgress'|'Completed'|'Failed'|'Deleting',
            'mergeStrategy': 'Overwrite'|'FailOnConflict'|'Append',
            'creationDateTime': datetime(2015, 1, 1),
            'lastUpdatedDateTime': datetime(2015, 1, 1),
            'importedResourceType': 'Bot'|'BotLocale'|'CustomVocabulary'
        },
    ],
    'nextToken': 'string',
    'localeId': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The unique identifier assigned by Amazon Lex to the bot.

    • botVersion (string) --

      The version of the bot that was imported. It will always be DRAFT .

    • importSummaries (list) --

      Summary information for the imports that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter. If there are more imports available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        Provides summary information about an import in an import list.

        • importId (string) --

          The unique identifier that Amazon Lex assigned to the import.

        • importedResourceId (string) --

          The unique identifier that Amazon Lex assigned to the imported resource.

        • importedResourceName (string) --

          The name that you gave the imported resource.

        • importStatus (string) --

          The status of the resource. When the status is Completed the resource is ready to build.

        • mergeStrategy (string) --

          The strategy used to merge existing bot or bot locale definitions with the imported definition.

        • creationDateTime (datetime) --

          The date and time that the import was created.

        • lastUpdatedDateTime (datetime) --

          The date and time that the import was last updated.

        • importedResourceType (string) --

          The type of resource that was imported.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListImports operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListImports operation request to get the next page of results.

    • localeId (string) --

      The locale specified in the request.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
list_intents(**kwargs)

Get a list of intents that meet the specified criteria.

See also: AWS API Documentation

Request Syntax

response = client.list_intents(
    botId='string',
    botVersion='string',
    localeId='string',
    sortBy={
        'attribute': 'IntentName'|'LastUpdatedDateTime',
        'order': 'Ascending'|'Descending'
    },
    filters=[
        {
            'name': 'IntentName',
            'values': [
                'string',
            ],
            'operator': 'CO'|'EQ'
        },
    ],
    maxResults=123,
    nextToken='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot that contains the intent.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot that contains the intent.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the intents to list. The string must match one of the supported locales. For more information, see Supported languages.

  • sortBy (dict) --

    Determines the sort order for the response from the ListIntents operation. You can choose to sort by the intent name or last updated date in either ascending or descending order.

    • attribute (string) -- [REQUIRED]

      The attribute to use to sort the list of intents.

    • order (string) -- [REQUIRED]

      The order to sort the list. You can choose ascending or descending.

  • filters (list) --

    Provides the specification of a filter used to limit the intents in the response to only those that match the filter specification. You can only specify one filter and only one string to filter on.

    • (dict) --

      Filters the response from the ListIntents operation.

      • name (string) -- [REQUIRED]

        The name of the field to use for the filter.

      • values (list) -- [REQUIRED]

        The value to use for the filter.

        • (string) --
      • operator (string) -- [REQUIRED]

        The operator to use for the filter. Specify EQ when the ListIntents operation should return only aliases that equal the specified value. Specify CO when the ListIntents operation should return aliases that contain the specified value.

  • maxResults (integer) -- The maximum number of intents to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) --

    If the response from the ListIntents operation contains more results than specified in the maxResults parameter, a token is returned in the response.

    Use the returned token in the nextToken parameter of a ListIntents request to return the next page of results. For a complete set of results, call the ListIntents operation until the nextToken returned in the response is null.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'intentSummaries': [
        {
            'intentId': 'string',
            'intentName': 'string',
            'description': 'string',
            'parentIntentSignature': 'string',
            'inputContexts': [
                {
                    'name': 'string'
                },
            ],
            'outputContexts': [
                {
                    'name': 'string',
                    'timeToLiveInSeconds': 123,
                    'turnsToLive': 123
                },
            ],
            'lastUpdatedDateTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot that contains the intent.

    • botVersion (string) --

      The version of the bot that contains the intent.

    • localeId (string) --

      The language and locale of the intents in the list.

    • intentSummaries (list) --

      Summary information for the intents that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter of the request. If there are more intents available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        Summary information about an intent returned by the ListIntents operation.

        • intentId (string) --

          The unique identifier assigned to the intent. Use this ID to get detailed information about the intent with the DescribeIntent operation.

        • intentName (string) --

          The name of the intent.

        • description (string) --

          The description of the intent.

        • parentIntentSignature (string) --

          If this intent is derived from a built-in intent, the name of the parent intent.

        • inputContexts (list) --

          The input contexts that must be active for this intent to be considered for recognition.

          • (dict) --

            The name of a context that must be active for an intent to be selected by Amazon Lex.

            • name (string) --

              The name of the context.

        • outputContexts (list) --

          The output contexts that are activated when this intent is fulfilled.

          • (dict) --

            Describes a session context that is activated when an intent is fulfilled.

            • name (string) --

              The name of the output context.

            • timeToLiveInSeconds (integer) --

              The amount of time, in seconds, that the output context should remain active. The time is figured from the first time the context is sent to the user.

            • turnsToLive (integer) --

              The number of conversation turns that the output context should remain active. The number of turns is counted from the first time that the context is sent to the user.

        • lastUpdatedDateTime (datetime) --

          The timestamp of the date and time that the intent was last updated.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListIntents operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListIntents operation request to get the next page of results.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException

Gets a list of recommended intents provided by the bot recommendation that you can use in your bot. Intents in the response are ordered by relevance.

See also: AWS API Documentation

Request Syntax

response = client.list_recommended_intents(
    botId='string',
    botVersion='string',
    localeId='string',
    botRecommendationId='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot associated with the recommended intents.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot that contains the recommended intents.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the recommended intents.

  • botRecommendationId (string) --

    [REQUIRED]

    The identifier of the bot recommendation that contains the recommended intents.

  • nextToken (string) -- If the response from the ListRecommendedIntents operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.
  • maxResults (integer) -- The maximum number of bot recommendations to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'botRecommendationId': 'string',
    'summaryList': [
        {
            'intentId': 'string',
            'intentName': 'string',
            'sampleUtterancesCount': 123
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The unique identifier of the bot associated with the recommended intent.

    • botVersion (string) --

      The version of the bot that contains the intent.

    • localeId (string) --

      The identifier of the language and locale of the intents to list. The string must match one of the supported locales. For more information, see Supported languages.

    • botRecommendationId (string) --

      The identifier of the bot recommendation that contains the recommended intent.

    • summaryList (list) --

      Summary information for the intents that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter of the request. If there are more intents available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        An object that contains a summary of a recommended intent.

        • intentId (string) --

          The unique identifier of a recommended intent associated with the bot recommendation.

        • intentName (string) --

          The name of a recommended intent associated with the bot recommendation.

        • sampleUtterancesCount (integer) --

          The count of sample utterances of a recommended intent that is associated with a bot recommendation.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListRecommendedIntents operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListRecommendedIntents operation request to get the next page of results.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
list_slot_types(**kwargs)

Gets a list of slot types that match the specified criteria.

See also: AWS API Documentation

Request Syntax

response = client.list_slot_types(
    botId='string',
    botVersion='string',
    localeId='string',
    sortBy={
        'attribute': 'SlotTypeName'|'LastUpdatedDateTime',
        'order': 'Ascending'|'Descending'
    },
    filters=[
        {
            'name': 'SlotTypeName'|'ExternalSourceType',
            'values': [
                'string',
            ],
            'operator': 'CO'|'EQ'
        },
    ],
    maxResults=123,
    nextToken='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot that contains the slot types.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot that contains the slot type.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the slot types to list. The string must match one of the supported locales. For more information, see Supported languages.

  • sortBy (dict) --

    Determines the sort order for the response from the ListSlotTypes operation. You can choose to sort by the slot type name or last updated date in either ascending or descending order.

    • attribute (string) -- [REQUIRED]

      The attribute to use to sort the list of slot types.

    • order (string) -- [REQUIRED]

      The order to sort the list. You can say ascending or descending.

  • filters (list) --

    Provides the specification of a filter used to limit the slot types in the response to only those that match the filter specification. You can only specify one filter and only one string to filter on.

    • (dict) --

      Filters the response from the ListSlotTypes operation.

      • name (string) -- [REQUIRED]

        The name of the field to use for filtering.

      • values (list) -- [REQUIRED]

        The value to use to filter the response.

        • (string) --
      • operator (string) -- [REQUIRED]

        The operator to use for the filter. Specify EQ when the ListSlotTypes operation should return only aliases that equal the specified value. Specify CO when the ListSlotTypes operation should return aliases that contain the specified value.

  • maxResults (integer) -- The maximum number of slot types to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) -- If the response from the ListSlotTypes operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'slotTypeSummaries': [
        {
            'slotTypeId': 'string',
            'slotTypeName': 'string',
            'description': 'string',
            'parentSlotTypeSignature': 'string',
            'lastUpdatedDateTime': datetime(2015, 1, 1),
            'slotTypeCategory': 'Custom'|'Extended'|'ExternalGrammar'|'Composite'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot that contains the slot types.

    • botVersion (string) --

      The version of the bot that contains the slot types.

    • localeId (string) --

      The language and local of the slot types in the list.

    • slotTypeSummaries (list) --

      Summary information for the slot types that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter of the request. If there are more slot types available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        Provides summary information about a slot type.

        • slotTypeId (string) --

          The unique identifier assigned to the slot type.

        • slotTypeName (string) --

          The name of the slot type.

        • description (string) --

          The description of the slot type.

        • parentSlotTypeSignature (string) --

          If the slot type is derived from a built-on slot type, the name of the parent slot type.

        • lastUpdatedDateTime (datetime) --

          A timestamp of the date and time that the slot type was last updated.

        • slotTypeCategory (string) --

          Indicates the type of the slot type.

          • Custom - A slot type that you created using custom values. For more information, see Creating custom slot types.
          • Extended - A slot type created by extending the AMAZON.AlphaNumeric built-in slot type. For more information, see AMAZON.AlphaNumeric.
          • ExternalGrammar - A slot type using a custom GRXML grammar to define values. For more information, see Using a custom grammar slot type.
    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListSlotTypes operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListSlotTypes operation request to get the next page of results.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
list_slots(**kwargs)

Gets a list of slots that match the specified criteria.

See also: AWS API Documentation

Request Syntax

response = client.list_slots(
    botId='string',
    botVersion='string',
    localeId='string',
    intentId='string',
    sortBy={
        'attribute': 'SlotName'|'LastUpdatedDateTime',
        'order': 'Ascending'|'Descending'
    },
    filters=[
        {
            'name': 'SlotName',
            'values': [
                'string',
            ],
            'operator': 'CO'|'EQ'
        },
    ],
    maxResults=123,
    nextToken='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot that contains the slot.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot that contains the slot.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the slots to list. The string must match one of the supported locales. For more information, see Supported languages.

  • intentId (string) --

    [REQUIRED]

    The unique identifier of the intent that contains the slot.

  • sortBy (dict) --

    Determines the sort order for the response from the ListSlots operation. You can choose to sort by the slot name or last updated date in either ascending or descending order.

    • attribute (string) -- [REQUIRED]

      The attribute to use to sort the list.

    • order (string) -- [REQUIRED]

      The order to sort the list. You can choose ascending or descending.

  • filters (list) --

    Provides the specification of a filter used to limit the slots in the response to only those that match the filter specification. You can only specify one filter and only one string to filter on.

    • (dict) --

      Filters the response from the ListSlots operation.

      • name (string) -- [REQUIRED]

        The name of the field to use for filtering.

      • values (list) -- [REQUIRED]

        The value to use to filter the response.

        • (string) --
      • operator (string) -- [REQUIRED]

        The operator to use for the filter. Specify EQ when the ListSlots operation should return only aliases that equal the specified value. Specify CO when the ListSlots operation should return aliases that contain the specified value.

  • maxResults (integer) -- The maximum number of slots to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextToken (string) -- If the response from the ListSlots operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'intentId': 'string',
    'slotSummaries': [
        {
            'slotId': 'string',
            'slotName': 'string',
            'description': 'string',
            'slotConstraint': 'Required'|'Optional',
            'slotTypeId': 'string',
            'valueElicitationPromptSpecification': {
                'messageGroups': [
                    {
                        'message': {
                            'plainTextMessage': {
                                'value': 'string'
                            },
                            'customPayload': {
                                'value': 'string'
                            },
                            'ssmlMessage': {
                                'value': 'string'
                            },
                            'imageResponseCard': {
                                'title': 'string',
                                'subtitle': 'string',
                                'imageUrl': 'string',
                                'buttons': [
                                    {
                                        'text': 'string',
                                        'value': 'string'
                                    },
                                ]
                            }
                        },
                        'variations': [
                            {
                                'plainTextMessage': {
                                    'value': 'string'
                                },
                                'customPayload': {
                                    'value': 'string'
                                },
                                'ssmlMessage': {
                                    'value': 'string'
                                },
                                'imageResponseCard': {
                                    'title': 'string',
                                    'subtitle': 'string',
                                    'imageUrl': 'string',
                                    'buttons': [
                                        {
                                            'text': 'string',
                                            'value': 'string'
                                        },
                                    ]
                                }
                            },
                        ]
                    },
                ],
                'maxRetries': 123,
                'allowInterrupt': True|False,
                'messageSelectionStrategy': 'Random'|'Ordered',
                'promptAttemptsSpecification': {
                    'string': {
                        'allowInterrupt': True|False,
                        'allowedInputTypes': {
                            'allowAudioInput': True|False,
                            'allowDTMFInput': True|False
                        },
                        'audioAndDTMFInputSpecification': {
                            'startTimeoutMs': 123,
                            'audioSpecification': {
                                'maxLengthMs': 123,
                                'endTimeoutMs': 123
                            },
                            'dtmfSpecification': {
                                'maxLength': 123,
                                'endTimeoutMs': 123,
                                'deletionCharacter': 'string',
                                'endCharacter': 'string'
                            }
                        },
                        'textInputSpecification': {
                            'startTimeoutMs': 123
                        }
                    }
                }
            },
            'lastUpdatedDateTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot that contains the slots.

    • botVersion (string) --

      The version of the bot that contains the slots.

    • localeId (string) --

      The language and locale of the slots in the list.

    • intentId (string) --

      The identifier of the intent that contains the slots.

    • slotSummaries (list) --

      Summary information for the slots that meet the filter criteria specified in the request. The length of the list is specified in the maxResults parameter of the request. If there are more slots available, the nextToken field contains a token to get the next page of results.

      • (dict) --

        Summary information about a slot, a value that the bot elicits from the user.

        • slotId (string) --

          The unique identifier of the slot.

        • slotName (string) --

          The name given to the slot.

        • description (string) --

          The description of the slot.

        • slotConstraint (string) --

          Whether the slot is required or optional. An intent is complete when all required slots are filled.

        • slotTypeId (string) --

          The unique identifier for the slot type that defines the values for the slot.

        • valueElicitationPromptSpecification (dict) --

          Prompts that are sent to the user to elicit a value for the slot.

          • messageGroups (list) --

            A collection of messages that Amazon Lex can send to the user. Amazon Lex chooses the actual message to send at runtime.

            • (dict) --

              Provides one or more messages that Amazon Lex should send to the user.

              • message (dict) --

                The primary message that Amazon Lex should send to the user.

                • plainTextMessage (dict) --

                  A message in plain text format.

                  • value (string) --

                    The message to send to the user.

                • customPayload (dict) --

                  A message in a custom format defined by the client application.

                  • value (string) --

                    The string that is sent to your application.

                • ssmlMessage (dict) --

                  A message in Speech Synthesis Markup Language (SSML).

                  • value (string) --

                    The SSML text that defines the prompt.

                • imageResponseCard (dict) --

                  A message that defines a response card that the client application can show to the user.

                  • title (string) --

                    The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                  • subtitle (string) --

                    The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                  • imageUrl (string) --

                    The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                  • buttons (list) --

                    A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                    • (dict) --

                      Describes a button to use on a response card used to gather slot values from a user.

                      • text (string) --

                        The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                      • value (string) --

                        The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

              • variations (list) --

                Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

                • (dict) --

                  The object that provides message text and it's type.

                  • plainTextMessage (dict) --

                    A message in plain text format.

                    • value (string) --

                      The message to send to the user.

                  • customPayload (dict) --

                    A message in a custom format defined by the client application.

                    • value (string) --

                      The string that is sent to your application.

                  • ssmlMessage (dict) --

                    A message in Speech Synthesis Markup Language (SSML).

                    • value (string) --

                      The SSML text that defines the prompt.

                  • imageResponseCard (dict) --

                    A message that defines a response card that the client application can show to the user.

                    • title (string) --

                      The title to display on the response card. The format of the title is determined by the platform displaying the response card.

                    • subtitle (string) --

                      The subtitle to display on the response card. The format of the subtitle is determined by the platform displaying the response card.

                    • imageUrl (string) --

                      The URL of an image to display on the response card. The image URL must be publicly available so that the platform displaying the response card has access to the image.

                    • buttons (list) --

                      A list of buttons that should be displayed on the response card. The arrangement of the buttons is determined by the platform that displays the button.

                      • (dict) --

                        Describes a button to use on a response card used to gather slot values from a user.

                        • text (string) --

                          The text that appears on the button. Use this to tell the user what value is returned when they choose this button.

                        • value (string) --

                          The value returned to Amazon Lex when the user chooses this button. This must be one of the slot values configured for the slot.

          • maxRetries (integer) --

            The maximum number of times the bot tries to elicit a response from the user using this prompt.

          • allowInterrupt (boolean) --

            Indicates whether the user can interrupt a speech prompt from the bot.

          • messageSelectionStrategy (string) --

            Indicates how a message is selected from a message group among retries.

          • promptAttemptsSpecification (dict) --

            Specifies the advanced settings on each attempt of the prompt.

            • (string) --

              The attempt name of attempts of a prompt.

              • (dict) --

                Specifies the settings on a prompt attempt.

                • allowInterrupt (boolean) --

                  Indicates whether the user can interrupt a speech prompt attempt from the bot.

                • allowedInputTypes (dict) --

                  Indicates the allowed input types of the prompt attempt.

                  • allowAudioInput (boolean) --

                    Indicates whether audio input is allowed.

                  • allowDTMFInput (boolean) --

                    Indicates whether DTMF input is allowed.

                • audioAndDTMFInputSpecification (dict) --

                  Specifies the settings on audio and DTMF input.

                  • startTimeoutMs (integer) --

                    Time for which a bot waits before assuming that the customer isn't going to speak or press a key. This timeout is shared between Audio and DTMF inputs.

                  • audioSpecification (dict) --

                    Specifies the settings on audio input.

                    • maxLengthMs (integer) --

                      Time for how long Amazon Lex waits before speech input is truncated and the speech is returned to application.

                    • endTimeoutMs (integer) --

                      Time for which a bot waits after the customer stops speaking to assume the utterance is finished.

                  • dtmfSpecification (dict) --

                    Specifies the settings on DTMF input.

                    • maxLength (integer) --

                      The maximum number of DTMF digits allowed in an utterance.

                    • endTimeoutMs (integer) --

                      How long the bot should wait after the last DTMF character input before assuming that the input has concluded.

                    • deletionCharacter (string) --

                      The DTMF character that clears the accumulated DTMF digits and immediately ends the input.

                    • endCharacter (string) --

                      The DTMF character that immediately ends input. If the user does not press this character, the input ends after the end timeout.

                • textInputSpecification (dict) --

                  Specifies the settings on text input.

                  • startTimeoutMs (integer) --

                    Time for which a bot waits before re-prompting a customer for text input.

        • lastUpdatedDateTime (datetime) --

          The timestamp of the last date and time that the slot was updated.

    • nextToken (string) --

      A token that indicates whether there are more results to return in a response to the ListSlots operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListSlots operation request to get the next page of results.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
list_tags_for_resource(**kwargs)

Gets a list of tags associated with a resource. Only bots, bot aliases, and bot channels can have tags associated with them.

See also: AWS API Documentation

Request Syntax

response = client.list_tags_for_resource(
    resourceARN='string'
)
Parameters
resourceARN (string) --

[REQUIRED]

The Amazon Resource Name (ARN) of the resource to get a list of tags for.

Return type
dict
Returns
Response Syntax
{
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --
    • tags (dict) --

      The tags associated with a resource.

      • (string) --
        • (string) --

Exceptions

  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ValidationException
search_associated_transcripts(**kwargs)

Search for associated transcripts that meet the specified criteria.

See also: AWS API Documentation

Request Syntax

response = client.search_associated_transcripts(
    botId='string',
    botVersion='string',
    localeId='string',
    botRecommendationId='string',
    searchOrder='Ascending'|'Descending',
    filters=[
        {
            'name': 'IntentId'|'SlotTypeId',
            'values': [
                'string',
            ]
        },
    ],
    maxResults=123,
    nextIndex=123
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot associated with the transcripts that you are searching.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot containing the transcripts that you are searching.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the transcripts to search. The string must match one of the supported locales. For more information, see Supported languages

  • botRecommendationId (string) --

    [REQUIRED]

    The unique identifier of the bot recommendation associated with the transcripts to search.

  • searchOrder (string) -- How SearchResults are ordered. Valid values are Ascending or Descending. The default is Descending.
  • filters (list) --

    [REQUIRED]

    A list of filter objects.

    • (dict) --

      Filters to search for the associated transcript.

      • name (string) -- [REQUIRED]

        The name of the field to use for filtering. The allowed names are IntentId and SlotTypeId.

      • values (list) -- [REQUIRED]

        The values to use to filter the transcript.

        • (string) --
  • maxResults (integer) -- The maximum number of bot recommendations to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.
  • nextIndex (integer) -- If the response from the SearchAssociatedTranscriptsRequest operation contains more results than specified in the maxResults parameter, an index is returned in the response. Use that index in the nextIndex parameter to return the next page of results.
Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'botRecommendationId': 'string',
    'nextIndex': 123,
    'associatedTranscripts': [
        {
            'transcript': 'string'
        },
    ],
    'totalResults': 123
}

Response Structure

  • (dict) --

    • botId (string) --

      The unique identifier of the bot associated with the transcripts that you are searching.

    • botVersion (string) --

      The version of the bot containing the transcripts that you are searching.

    • localeId (string) --

      The identifier of the language and locale of the transcripts to search. The string must match one of the supported locales. For more information, see Supported languages

    • botRecommendationId (string) --

      The unique identifier of the bot recommendation associated with the transcripts to search.

    • nextIndex (integer) --

      A index that indicates whether there are more results to return in a response to the SearchAssociatedTranscripts operation. If the nextIndex field is present, you send the contents as the nextIndex parameter of a SearchAssociatedTranscriptsRequest operation to get the next page of results.

    • associatedTranscripts (list) --

      The object that contains the associated transcript that meet the criteria you specified.

      • (dict) --

        The object containing information that associates the recommended intent/slot type with a conversation.

        • transcript (string) --

          The content of the transcript that meets the search filter criteria. For the JSON format of the transcript, see Output transcript format.

    • totalResults (integer) --

      The total number of transcripts returned by the search.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
start_bot_recommendation(**kwargs)

Use this to provide your transcript data, and to start the bot recommendation process.

See also: AWS API Documentation

Request Syntax

response = client.start_bot_recommendation(
    botId='string',
    botVersion='string',
    localeId='string',
    transcriptSourceSetting={
        's3BucketTranscriptSource': {
            's3BucketName': 'string',
            'pathFormat': {
                'objectPrefixes': [
                    'string',
                ]
            },
            'transcriptFormat': 'Lex',
            'transcriptFilter': {
                'lexTranscriptFilter': {
                    'dateRangeFilter': {
                        'startDateTime': datetime(2015, 1, 1),
                        'endDateTime': datetime(2015, 1, 1)
                    }
                }
            },
            'kmsKeyArn': 'string'
        }
    },
    encryptionSetting={
        'kmsKeyArn': 'string',
        'botLocaleExportPassword': 'string',
        'associatedTranscriptsPassword': 'string'
    }
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot containing the bot recommendation.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot containing the bot recommendation.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the bot recommendation to start. The string must match one of the supported locales. For more information, see Supported languages

  • transcriptSourceSetting (dict) --

    [REQUIRED]

    The object representing the Amazon S3 bucket containing the transcript, as well as the associated metadata.

    • s3BucketTranscriptSource (dict) --

      Indicates the setting of the Amazon S3 bucket where the transcript is stored.

      • s3BucketName (string) -- [REQUIRED]

        The name of the bucket containing the transcript and the associated metadata.

      • pathFormat (dict) --

        The object that contains a path format that will be applied when Amazon Lex reads the transcript file in the bucket you provide. Specify this object if you only want Lex to read a subset of files in your Amazon S3 bucket.

        • objectPrefixes (list) --

          A list of Amazon S3 prefixes that points to sub-folders in the Amazon S3 bucket. Specify this list if you only want Lex to read the files under this set of sub-folders.

          • (string) --
      • transcriptFormat (string) -- [REQUIRED]

        The format of the transcript content. Currently, Genie only supports the Amazon Lex transcript format.

      • transcriptFilter (dict) --

        The object that contains the filter which will be applied when Amazon Lex reads through the Amazon S3 bucket. Specify this object if you want Amazon Lex to read only a subset of the Amazon S3 bucket based on the filter you provide.

        • lexTranscriptFilter (dict) --

          The object representing the filter that Amazon Lex will use to select the appropriate transcript when the transcript format is the Amazon Lex format.

          • dateRangeFilter (dict) --

            The object that contains a date range filter that will be applied to the transcript. Specify this object if you want Amazon Lex to only read the files that are within the date range.

            • startDateTime (datetime) -- [REQUIRED]

              A timestamp indicating the start date for the date range filter.

            • endDateTime (datetime) -- [REQUIRED]

              A timestamp indicating the end date for the date range filter.

      • kmsKeyArn (string) --

        The ARN of the KMS key that customer use to encrypt their Amazon S3 bucket. Only use this field if your bucket is encrypted using a customer managed KMS key.

  • encryptionSetting (dict) --

    The object representing the passwords that will be used to encrypt the data related to the bot recommendation results, as well as the KMS key ARN used to encrypt the associated metadata.

    • kmsKeyArn (string) --

      The KMS key ARN used to encrypt the metadata associated with the bot recommendation.

    • botLocaleExportPassword (string) --

      The password used to encrypt the recommended bot recommendation file.

    • associatedTranscriptsPassword (string) --

      The password used to encrypt the associated transcript file.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'botRecommendationStatus': 'Processing'|'Deleting'|'Deleted'|'Downloading'|'Updating'|'Available'|'Failed'|'Stopping'|'Stopped',
    'botRecommendationId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'transcriptSourceSetting': {
        's3BucketTranscriptSource': {
            's3BucketName': 'string',
            'pathFormat': {
                'objectPrefixes': [
                    'string',
                ]
            },
            'transcriptFormat': 'Lex',
            'transcriptFilter': {
                'lexTranscriptFilter': {
                    'dateRangeFilter': {
                        'startDateTime': datetime(2015, 1, 1),
                        'endDateTime': datetime(2015, 1, 1)
                    }
                }
            },
            'kmsKeyArn': 'string'
        }
    },
    'encryptionSetting': {
        'kmsKeyArn': 'string',
        'botLocaleExportPassword': 'string',
        'associatedTranscriptsPassword': 'string'
    }
}

Response Structure

  • (dict) --

    • botId (string) --

      The unique identifier of the bot containing the bot recommendation.

    • botVersion (string) --

      The version of the bot containing the bot recommendation.

    • localeId (string) --

      The identifier of the language and locale of the bot recommendation to start. The string must match one of the supported locales. For more information, see Supported languages

    • botRecommendationStatus (string) --

      The status of the bot recommendation.

      If the status is Failed, then the reasons for the failure are listed in the failureReasons field.

    • botRecommendationId (string) --

      The identifier of the bot recommendation that you have created.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the bot recommendation was created.

    • transcriptSourceSetting (dict) --

      The object representing the Amazon S3 bucket containing the transcript, as well as the associated metadata.

      • s3BucketTranscriptSource (dict) --

        Indicates the setting of the Amazon S3 bucket where the transcript is stored.

        • s3BucketName (string) --

          The name of the bucket containing the transcript and the associated metadata.

        • pathFormat (dict) --

          The object that contains a path format that will be applied when Amazon Lex reads the transcript file in the bucket you provide. Specify this object if you only want Lex to read a subset of files in your Amazon S3 bucket.

          • objectPrefixes (list) --

            A list of Amazon S3 prefixes that points to sub-folders in the Amazon S3 bucket. Specify this list if you only want Lex to read the files under this set of sub-folders.

            • (string) --
        • transcriptFormat (string) --

          The format of the transcript content. Currently, Genie only supports the Amazon Lex transcript format.

        • transcriptFilter (dict) --

          The object that contains the filter which will be applied when Amazon Lex reads through the Amazon S3 bucket. Specify this object if you want Amazon Lex to read only a subset of the Amazon S3 bucket based on the filter you provide.

          • lexTranscriptFilter (dict) --

            The object representing the filter that Amazon Lex will use to select the appropriate transcript when the transcript format is the Amazon Lex format.

            • dateRangeFilter (dict) --

              The object that contains a date range filter that will be applied to the transcript. Specify this object if you want Amazon Lex to only read the files that are within the date range.

              • startDateTime (datetime) --

                A timestamp indicating the start date for the date range filter.

              • endDateTime (datetime) --

                A timestamp indicating the end date for the date range filter.

        • kmsKeyArn (string) --

          The ARN of the KMS key that customer use to encrypt their Amazon S3 bucket. Only use this field if your bucket is encrypted using a customer managed KMS key.

    • encryptionSetting (dict) --

      The object representing the passwords that were used to encrypt the data related to the bot recommendation results, as well as the KMS key ARN used to encrypt the associated metadata.

      • kmsKeyArn (string) --

        The KMS key ARN used to encrypt the metadata associated with the bot recommendation.

      • botLocaleExportPassword (string) --

        The password used to encrypt the recommended bot recommendation file.

      • associatedTranscriptsPassword (string) --

        The password used to encrypt the associated transcript file.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
start_import(**kwargs)

Starts importing a bot, bot locale, or custom vocabulary from a zip archive that you uploaded to an S3 bucket.

See also: AWS API Documentation

Request Syntax

response = client.start_import(
    importId='string',
    resourceSpecification={
        'botImportSpecification': {
            'botName': 'string',
            'roleArn': 'string',
            'dataPrivacy': {
                'childDirected': True|False
            },
            'idleSessionTTLInSeconds': 123,
            'botTags': {
                'string': 'string'
            },
            'testBotAliasTags': {
                'string': 'string'
            }
        },
        'botLocaleImportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string',
            'nluIntentConfidenceThreshold': 123.0,
            'voiceSettings': {
                'voiceId': 'string',
                'engine': 'standard'|'neural'
            }
        },
        'customVocabularyImportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        }
    },
    mergeStrategy='Overwrite'|'FailOnConflict'|'Append',
    filePassword='string'
)
Parameters
  • importId (string) --

    [REQUIRED]

    The unique identifier for the import. It is included in the response from the CreateUploadUrl operation.

  • resourceSpecification (dict) --

    [REQUIRED]

    Parameters for creating the bot, bot locale or custom vocabulary.

    • botImportSpecification (dict) --

      Parameters for importing a bot.

      • botName (string) -- [REQUIRED]

        The name that Amazon Lex should use for the bot.

      • roleArn (string) -- [REQUIRED]

        The Amazon Resource Name (ARN) of the IAM role used to build and run the bot.

      • dataPrivacy (dict) -- [REQUIRED]

        By default, data stored by Amazon Lex is encrypted. The DataPrivacy structure provides settings that determine how Amazon Lex handles special cases of securing the data for your bot.

        • childDirected (boolean) -- [REQUIRED]

          For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

      • idleSessionTTLInSeconds (integer) --

        The time, in seconds, that Amazon Lex should keep information about a user's conversation with the bot.

        A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Lex deletes any data provided before the timeout.

        You can specify between 60 (1 minute) and 86,400 (24 hours) seconds.

      • botTags (dict) --

        A list of tags to add to the bot. You can only add tags when you import a bot. You can't use the UpdateBot operation to update tags. To update tags, use the TagResource operation.

        • (string) --
          • (string) --
      • testBotAliasTags (dict) --

        A list of tags to add to the test alias for a bot. You can only add tags when you import a bot. You can't use the UpdateAlias operation to update tags. To update tags on the test alias, use the TagResource operation.

        • (string) --
          • (string) --
    • botLocaleImportSpecification (dict) --

      Parameters for importing a bot locale.

      • botId (string) -- [REQUIRED]

        The identifier of the bot to import the locale to.

      • botVersion (string) -- [REQUIRED]

        The version of the bot to import the locale to. This can only be the DRAFT version of the bot.

      • localeId (string) -- [REQUIRED]

        The identifier of the language and locale that the bot will be used in. The string must match one of the supported locales. All of the intents, slot types, and slots used in the bot must have the same locale. For more information, see Supported languages.

      • nluIntentConfidenceThreshold (float) --

        Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent , AMAZON.KendraSearchIntent , or both when returning alternative intents. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot.

        For example, suppose a bot is configured with the confidence threshold of 0.80 and the AMAZON.FallbackIntent . Amazon Lex returns three alternative intents with the following confidence scores: IntentA (0.70), IntentB (0.60), IntentC (0.50). The response from the PostText operation would be:

        • AMAZON.FallbackIntent
        • IntentA
        • IntentB
        • IntentC
      • voiceSettings (dict) --

        Defines settings for using an Amazon Polly voice to communicate with a user.

        • voiceId (string) -- [REQUIRED]

          The identifier of the Amazon Polly voice to use.

        • engine (string) --

          Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the engineparameter of the SynthesizeSpeechoperation in the Amazon Polly developer guide .

          If you do not specify a value, the default is standard .

    • customVocabularyImportSpecification (dict) --

      Provides the parameters required for importing a custom vocabulary.

      • botId (string) -- [REQUIRED]

        The identifier of the bot to import the custom vocabulary to.

      • botVersion (string) -- [REQUIRED]

        The version of the bot to import the custom vocabulary to.

      • localeId (string) -- [REQUIRED]

        The identifier of the local to import the custom vocabulary to. The value must be en_GB .

  • mergeStrategy (string) --

    [REQUIRED]

    The strategy to use when there is a name conflict between the imported resource and an existing resource. When the merge strategy is FailOnConflict existing resources are not overwritten and the import fails.

  • filePassword (string) -- The password used to encrypt the zip archive that contains the resource definition. You should always encrypt the zip archive to protect it during transit between your site and Amazon Lex.
Return type

dict

Returns

Response Syntax

{
    'importId': 'string',
    'resourceSpecification': {
        'botImportSpecification': {
            'botName': 'string',
            'roleArn': 'string',
            'dataPrivacy': {
                'childDirected': True|False
            },
            'idleSessionTTLInSeconds': 123,
            'botTags': {
                'string': 'string'
            },
            'testBotAliasTags': {
                'string': 'string'
            }
        },
        'botLocaleImportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string',
            'nluIntentConfidenceThreshold': 123.0,
            'voiceSettings': {
                'voiceId': 'string',
                'engine': 'standard'|'neural'
            }
        },
        'customVocabularyImportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        }
    },
    'mergeStrategy': 'Overwrite'|'FailOnConflict'|'Append',
    'importStatus': 'InProgress'|'Completed'|'Failed'|'Deleting',
    'creationDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • importId (string) --

      A unique identifier for the import.

    • resourceSpecification (dict) --

      The parameters used when importing the resource.

      • botImportSpecification (dict) --

        Parameters for importing a bot.

        • botName (string) --

          The name that Amazon Lex should use for the bot.

        • roleArn (string) --

          The Amazon Resource Name (ARN) of the IAM role used to build and run the bot.

        • dataPrivacy (dict) --

          By default, data stored by Amazon Lex is encrypted. The DataPrivacy structure provides settings that determine how Amazon Lex handles special cases of securing the data for your bot.

          • childDirected (boolean) --

            For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

        • idleSessionTTLInSeconds (integer) --

          The time, in seconds, that Amazon Lex should keep information about a user's conversation with the bot.

          A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Lex deletes any data provided before the timeout.

          You can specify between 60 (1 minute) and 86,400 (24 hours) seconds.

        • botTags (dict) --

          A list of tags to add to the bot. You can only add tags when you import a bot. You can't use the UpdateBot operation to update tags. To update tags, use the TagResource operation.

          • (string) --
            • (string) --
        • testBotAliasTags (dict) --

          A list of tags to add to the test alias for a bot. You can only add tags when you import a bot. You can't use the UpdateAlias operation to update tags. To update tags on the test alias, use the TagResource operation.

          • (string) --
            • (string) --
      • botLocaleImportSpecification (dict) --

        Parameters for importing a bot locale.

        • botId (string) --

          The identifier of the bot to import the locale to.

        • botVersion (string) --

          The version of the bot to import the locale to. This can only be the DRAFT version of the bot.

        • localeId (string) --

          The identifier of the language and locale that the bot will be used in. The string must match one of the supported locales. All of the intents, slot types, and slots used in the bot must have the same locale. For more information, see Supported languages.

        • nluIntentConfidenceThreshold (float) --

          Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent , AMAZON.KendraSearchIntent , or both when returning alternative intents. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot.

          For example, suppose a bot is configured with the confidence threshold of 0.80 and the AMAZON.FallbackIntent . Amazon Lex returns three alternative intents with the following confidence scores: IntentA (0.70), IntentB (0.60), IntentC (0.50). The response from the PostText operation would be:

          • AMAZON.FallbackIntent
          • IntentA
          • IntentB
          • IntentC
        • voiceSettings (dict) --

          Defines settings for using an Amazon Polly voice to communicate with a user.

          • voiceId (string) --

            The identifier of the Amazon Polly voice to use.

          • engine (string) --

            Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the engineparameter of the SynthesizeSpeechoperation in the Amazon Polly developer guide .

            If you do not specify a value, the default is standard .

      • customVocabularyImportSpecification (dict) --

        Provides the parameters required for importing a custom vocabulary.

        • botId (string) --

          The identifier of the bot to import the custom vocabulary to.

        • botVersion (string) --

          The version of the bot to import the custom vocabulary to.

        • localeId (string) --

          The identifier of the local to import the custom vocabulary to. The value must be en_GB .

    • mergeStrategy (string) --

      The strategy used when there was a name conflict between the imported resource and an existing resource. When the merge strategy is FailOnConflict existing resources are not overwritten and the import fails.

    • importStatus (string) --

      The current status of the import. When the status is Complete the bot, bot alias, or custom vocabulary is ready to use.

    • creationDateTime (datetime) --

      The date and time that the import request was created.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
stop_bot_recommendation(**kwargs)

Stop an already running Bot Recommendation request.

See also: AWS API Documentation

Request Syntax

response = client.stop_bot_recommendation(
    botId='string',
    botVersion='string',
    localeId='string',
    botRecommendationId='string'
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot containing the bot recommendation to be stopped.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot containing the bot recommendation.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the bot recommendation to stop. The string must match one of the supported locales. For more information, see Supported languages

  • botRecommendationId (string) --

    [REQUIRED]

    The unique identifier of the bot recommendation to be stopped.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'botRecommendationStatus': 'Processing'|'Deleting'|'Deleted'|'Downloading'|'Updating'|'Available'|'Failed'|'Stopping'|'Stopped',
    'botRecommendationId': 'string'
}

Response Structure

  • (dict) --

    • botId (string) --

      The unique identifier of the bot containing the bot recommendation that is being stopped.

    • botVersion (string) --

      The version of the bot containing the recommendation that is being stopped.

    • localeId (string) --

      The identifier of the language and locale of the bot response to stop. The string must match one of the supported locales. For more information, see Supported languages

    • botRecommendationStatus (string) --

      The status of the bot recommendation. If the status is Failed, then the reasons for the failure are listed in the failureReasons field.

    • botRecommendationId (string) --

      The unique identifier of the bot recommendation that is being stopped.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
tag_resource(**kwargs)

Adds the specified tags to the specified resource. If a tag key already exists, the existing value is replaced with the new value.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    resourceARN='string',
    tags={
        'string': 'string'
    }
)
Parameters
  • resourceARN (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the bot, bot alias, or bot channel to tag.

  • tags (dict) --

    [REQUIRED]

    A list of tag keys to add to the resource. If a tag key already exists, the existing value is replaced with the new value.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Exceptions

  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ValidationException
untag_resource(**kwargs)

Removes tags from a bot, bot alias, or bot channel.

See also: AWS API Documentation

Request Syntax

response = client.untag_resource(
    resourceARN='string',
    tagKeys=[
        'string',
    ]
)
Parameters
  • resourceARN (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the resource to remove the tags from.

  • tagKeys (list) --

    [REQUIRED]

    A list of tag keys to remove from the resource. If a tag key does not exist on the resource, it is ignored.

    • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Exceptions

  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ValidationException
update_bot(**kwargs)

Updates the configuration of an existing bot.

See also: AWS API Documentation

Request Syntax

response = client.update_bot(
    botId='string',
    botName='string',
    description='string',
    roleArn='string',
    dataPrivacy={
        'childDirected': True|False
    },
    idleSessionTTLInSeconds=123,
    botType='Bot'|'BotNetwork',
    botMembers=[
        {
            'botMemberId': 'string',
            'botMemberName': 'string',
            'botMemberAliasId': 'string',
            'botMemberAliasName': 'string',
            'botMemberVersion': 'string'
        },
    ]
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot to update. This identifier is returned by the CreateBot operation.

  • botName (string) --

    [REQUIRED]

    The new name of the bot. The name must be unique in the account that creates the bot.

  • description (string) -- A description of the bot.
  • roleArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of an IAM role that has permissions to access the bot.

  • dataPrivacy (dict) --

    [REQUIRED]

    Provides information on additional privacy protections Amazon Lex should use with the bot's data.

    • childDirected (boolean) -- [REQUIRED]

      For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

  • idleSessionTTLInSeconds (integer) --

    [REQUIRED]

    The time, in seconds, that Amazon Lex should keep information about a user's conversation with the bot.

    A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Lex deletes any data provided before the timeout.

    You can specify between 60 (1 minute) and 86,400 (24 hours) seconds.

  • botType (string) -- The type of the bot to be updated.
  • botMembers (list) --

    The list of bot members in the network associated with the update action.

    • (dict) --

      A bot that is a member of a network of bots.

      • botMemberId (string) -- [REQUIRED]

        The unique ID of a bot that is a member of this network of bots.

      • botMemberName (string) -- [REQUIRED]

        The unique name of a bot that is a member of this network of bots.

      • botMemberAliasId (string) -- [REQUIRED]

        The alias ID of a bot that is a member of this network of bots.

      • botMemberAliasName (string) -- [REQUIRED]

        The alias name of a bot that is a member of this network of bots.

      • botMemberVersion (string) -- [REQUIRED]

        The version of a bot that is a member of this network of bots.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botName': 'string',
    'description': 'string',
    'roleArn': 'string',
    'dataPrivacy': {
        'childDirected': True|False
    },
    'idleSessionTTLInSeconds': 123,
    'botStatus': 'Creating'|'Available'|'Inactive'|'Deleting'|'Failed'|'Versioning'|'Importing'|'Updating',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'botType': 'Bot'|'BotNetwork',
    'botMembers': [
        {
            'botMemberId': 'string',
            'botMemberName': 'string',
            'botMemberAliasId': 'string',
            'botMemberAliasName': 'string',
            'botMemberVersion': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • botId (string) --

      The unique identifier of the bot that was updated.

    • botName (string) --

      The name of the bot after the update.

    • description (string) --

      The description of the bot after the update.

    • roleArn (string) --

      The Amazon Resource Name (ARN) of the IAM role used by the bot after the update.

    • dataPrivacy (dict) --

      The data privacy settings for the bot after the update.

      • childDirected (boolean) --

        For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

    • idleSessionTTLInSeconds (integer) --

      The session timeout, in seconds, for the bot after the update.

    • botStatus (string) --

      Shows the current status of the bot. The bot is first in the Creating status. Once the bot is read for use, it changes to the Available status. After the bot is created, you can use the DRAFT version of the bot.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the bot was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the date and time that the bot was last updated.

    • botType (string) --

      The type of the bot that was updated.

    • botMembers (list) --

      The list of bot members in the network that was updated.

      • (dict) --

        A bot that is a member of a network of bots.

        • botMemberId (string) --

          The unique ID of a bot that is a member of this network of bots.

        • botMemberName (string) --

          The unique name of a bot that is a member of this network of bots.

        • botMemberAliasId (string) --

          The alias ID of a bot that is a member of this network of bots.

        • botMemberAliasName (string) --

          The alias name of a bot that is a member of this network of bots.

        • botMemberVersion (string) --

          The version of a bot that is a member of this network of bots.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
update_bot_alias(**kwargs)

Updates the configuration of an existing bot alias.

See also: AWS API Documentation

Request Syntax

response = client.update_bot_alias(
    botAliasId='string',
    botAliasName='string',
    description='string',
    botVersion='string',
    botAliasLocaleSettings={
        'string': {
            'enabled': True|False,
            'codeHookSpecification': {
                'lambdaCodeHook': {
                    'lambdaARN': 'string',
                    'codeHookInterfaceVersion': 'string'
                }
            }
        }
    },
    conversationLogSettings={
        'textLogSettings': [
            {
                'enabled': True|False,
                'destination': {
                    'cloudWatch': {
                        'cloudWatchLogGroupArn': 'string',
                        'logPrefix': 'string'
                    }
                }
            },
        ],
        'audioLogSettings': [
            {
                'enabled': True|False,
                'destination': {
                    's3Bucket': {
                        'kmsKeyArn': 'string',
                        's3BucketArn': 'string',
                        'logPrefix': 'string'
                    }
                }
            },
        ]
    },
    sentimentAnalysisSettings={
        'detectSentiment': True|False
    },
    botId='string'
)
Parameters
  • botAliasId (string) --

    [REQUIRED]

    The unique identifier of the bot alias.

  • botAliasName (string) --

    [REQUIRED]

    The new name to assign to the bot alias.

  • description (string) -- The new description to assign to the bot alias.
  • botVersion (string) -- The new bot version to assign to the bot alias.
  • botAliasLocaleSettings (dict) --

    The new Lambda functions to use in each locale for the bot alias.

    • (string) --
      • (dict) --

        Specifies settings that are unique to a locale. For example, you can use different Lambda function depending on the bot's locale.

        • enabled (boolean) -- [REQUIRED]

          Determines whether the locale is enabled for the bot. If the value is false , the locale isn't available for use.

        • codeHookSpecification (dict) --

          Specifies the Lambda function that should be used in the locale.

          • lambdaCodeHook (dict) -- [REQUIRED]

            Specifies a Lambda function that verifies requests to a bot or fulfills the user's request to a bot.

            • lambdaARN (string) -- [REQUIRED]

              The Amazon Resource Name (ARN) of the Lambda function.

            • codeHookInterfaceVersion (string) -- [REQUIRED]

              The version of the request-response that you want Amazon Lex to use to invoke your Lambda function.

  • conversationLogSettings (dict) --

    The new settings for storing conversation logs in Amazon CloudWatch Logs and Amazon S3 buckets.

    • textLogSettings (list) --

      The Amazon CloudWatch Logs settings for logging text and metadata.

      • (dict) --

        Defines settings to enable text conversation logs.

        • enabled (boolean) -- [REQUIRED]

          Determines whether conversation logs should be stored for an alias.

        • destination (dict) -- [REQUIRED]

          Defines the Amazon CloudWatch Logs destination log group for conversation text logs.

          • cloudWatch (dict) -- [REQUIRED]

            Defines the Amazon CloudWatch Logs log group where text and metadata logs are delivered.

            • cloudWatchLogGroupArn (string) -- [REQUIRED]

              The Amazon Resource Name (ARN) of the log group where text and metadata logs are delivered.

            • logPrefix (string) -- [REQUIRED]

              The prefix of the log stream name within the log group that you specified

    • audioLogSettings (list) --

      The Amazon S3 settings for logging audio to an S3 bucket.

      • (dict) --

        Settings for logging audio of conversations between Amazon Lex and a user. You specify whether to log audio and the Amazon S3 bucket where the audio file is stored.

        • enabled (boolean) -- [REQUIRED]

          Determines whether audio logging in enabled for the bot.

        • destination (dict) -- [REQUIRED]

          The location of audio log files collected when conversation logging is enabled for a bot.

          • s3Bucket (dict) -- [REQUIRED]

            The Amazon S3 bucket where the audio log files are stored. The IAM role specified in the roleArn parameter of the CreateBot operation must have permission to write to this bucket.

            • kmsKeyArn (string) --

              The Amazon Resource Name (ARN) of an AWS Key Management Service (KMS) key for encrypting audio log files stored in an S3 bucket.

            • s3BucketArn (string) -- [REQUIRED]

              The Amazon Resource Name (ARN) of an Amazon S3 bucket where audio log files are stored.

            • logPrefix (string) -- [REQUIRED]

              The S3 prefix to assign to audio log files.

  • sentimentAnalysisSettings (dict) --

    Determines whether Amazon Lex will use Amazon Comprehend to detect the sentiment of user utterances.

    • detectSentiment (boolean) -- [REQUIRED]

      Sets whether Amazon Lex uses Amazon Comprehend to detect the sentiment of user utterances.

  • botId (string) --

    [REQUIRED]

    The identifier of the bot with the updated alias.

Return type

dict

Returns

Response Syntax

{
    'botAliasId': 'string',
    'botAliasName': 'string',
    'description': 'string',
    'botVersion': 'string',
    'botAliasLocaleSettings': {
        'string': {
            'enabled': True|False,
            'codeHookSpecification': {
                'lambdaCodeHook': {
                    'lambdaARN': 'string',
                    'codeHookInterfaceVersion': 'string'
                }
            }
        }
    },
    'conversationLogSettings': {
        'textLogSettings': [
            {
                'enabled': True|False,
                'destination': {
                    'cloudWatch': {
                        'cloudWatchLogGroupArn': 'string',
                        'logPrefix': 'string'
                    }
                }
            },
        ],
        'audioLogSettings': [
            {
                'enabled': True|False,
                'destination': {
                    's3Bucket': {
                        'kmsKeyArn': 'string',
                        's3BucketArn': 'string',
                        'logPrefix': 'string'
                    }
                }
            },
        ]
    },
    'sentimentAnalysisSettings': {
        'detectSentiment': True|False
    },
    'botAliasStatus': 'Creating'|'Available'|'Deleting'|'Failed',
    'botId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • botAliasId (string) --

      The identifier of the updated bot alias.

    • botAliasName (string) --

      The updated name of the bot alias.

    • description (string) --

      The updated description of the bot alias.

    • botVersion (string) --

      The updated version of the bot that the alias points to.

    • botAliasLocaleSettings (dict) --

      The updated Lambda functions to use in each locale for the bot alias.

      • (string) --

        • (dict) --

          Specifies settings that are unique to a locale. For example, you can use different Lambda function depending on the bot's locale.

          • enabled (boolean) --

            Determines whether the locale is enabled for the bot. If the value is false , the locale isn't available for use.

          • codeHookSpecification (dict) --

            Specifies the Lambda function that should be used in the locale.

            • lambdaCodeHook (dict) --

              Specifies a Lambda function that verifies requests to a bot or fulfills the user's request to a bot.

              • lambdaARN (string) --

                The Amazon Resource Name (ARN) of the Lambda function.

              • codeHookInterfaceVersion (string) --

                The version of the request-response that you want Amazon Lex to use to invoke your Lambda function.

    • conversationLogSettings (dict) --

      The updated settings for storing conversation logs in Amazon CloudWatch Logs and Amazon S3 buckets.

      • textLogSettings (list) --

        The Amazon CloudWatch Logs settings for logging text and metadata.

        • (dict) --

          Defines settings to enable text conversation logs.

          • enabled (boolean) --

            Determines whether conversation logs should be stored for an alias.

          • destination (dict) --

            Defines the Amazon CloudWatch Logs destination log group for conversation text logs.

            • cloudWatch (dict) --

              Defines the Amazon CloudWatch Logs log group where text and metadata logs are delivered.

              • cloudWatchLogGroupArn (string) --

                The Amazon Resource Name (ARN) of the log group where text and metadata logs are delivered.

              • logPrefix (string) --

                The prefix of the log stream name within the log group that you specified

      • audioLogSettings (list) --

        The Amazon S3 settings for logging audio to an S3 bucket.

        • (dict) --

          Settings for logging audio of conversations between Amazon Lex and a user. You specify whether to log audio and the Amazon S3 bucket where the audio file is stored.

          • enabled (boolean) --

            Determines whether audio logging in enabled for the bot.

          • destination (dict) --

            The location of audio log files collected when conversation logging is enabled for a bot.

            • s3Bucket (dict) --

              The Amazon S3 bucket where the audio log files are stored. The IAM role specified in the roleArn parameter of the CreateBot operation must have permission to write to this bucket.

              • kmsKeyArn (string) --

                The Amazon Resource Name (ARN) of an AWS Key Management Service (KMS) key for encrypting audio log files stored in an S3 bucket.

              • s3BucketArn (string) --

                The Amazon Resource Name (ARN) of an Amazon S3 bucket where audio log files are stored.

              • logPrefix (string) --

                The S3 prefix to assign to audio log files.

    • sentimentAnalysisSettings (dict) --

      Determines whether Amazon Lex will use Amazon Comprehend to detect the sentiment of user utterances.

      • detectSentiment (boolean) --

        Sets whether Amazon Lex uses Amazon Comprehend to detect the sentiment of user utterances.

    • botAliasStatus (string) --

      The current status of the bot alias. When the status is Available the alias is ready for use.

    • botId (string) --

      The identifier of the bot with the updated alias.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the bot was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the date and time that the bot was last updated.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
update_bot_locale(**kwargs)

Updates the settings that a bot has for a specific locale.

See also: AWS API Documentation

Request Syntax

response = client.update_bot_locale(
    botId='string',
    botVersion='string',
    localeId='string',
    description='string',
    nluIntentConfidenceThreshold=123.0,
    voiceSettings={
        'voiceId': 'string',
        'engine': 'standard'|'neural'
    }
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot that contains the locale.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot that contains the locale to be updated. The version can only be the DRAFT version.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale to update. The string must match one of the supported locales. For more information, see Supported languages.

  • description (string) -- The new description of the locale.
  • nluIntentConfidenceThreshold (float) --

    [REQUIRED]

    The new confidence threshold where Amazon Lex inserts the AMAZON.FallbackIntent and AMAZON.KendraSearchIntent intents in the list of possible intents for an utterance.

  • voiceSettings (dict) --

    The new Amazon Polly voice Amazon Lex should use for voice interaction with the user.

    • voiceId (string) -- [REQUIRED]

      The identifier of the Amazon Polly voice to use.

    • engine (string) --

      Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the engineparameter of the SynthesizeSpeechoperation in the Amazon Polly developer guide .

      If you do not specify a value, the default is standard .

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'localeName': 'string',
    'description': 'string',
    'nluIntentConfidenceThreshold': 123.0,
    'voiceSettings': {
        'voiceId': 'string',
        'engine': 'standard'|'neural'
    },
    'botLocaleStatus': 'Creating'|'Building'|'Built'|'ReadyExpressTesting'|'Failed'|'Deleting'|'NotBuilt'|'Importing'|'Processing',
    'failureReasons': [
        'string',
    ],
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'recommendedActions': [
        'string',
    ]
}

Response Structure

  • (dict) --

    • botId (string) --

      The identifier of the bot that contains the updated locale.

    • botVersion (string) --

      The version of the bot that contains the updated locale.

    • localeId (string) --

      The language and locale of the updated bot locale.

    • localeName (string) --

      The updated locale name for the locale.

    • description (string) --

      The updated description of the locale.

    • nluIntentConfidenceThreshold (float) --

      The updated confidence threshold for inserting the AMAZON.FallbackIntent and AMAZON.KendraSearchIntent intents in the list of possible intents for an utterance.

    • voiceSettings (dict) --

      The updated Amazon Polly voice to use for voice interaction with the user.

      • voiceId (string) --

        The identifier of the Amazon Polly voice to use.

      • engine (string) --

        Indicates the type of Amazon Polly voice that Amazon Lex should use for voice interaction with the user. For more information, see the engineparameter of the SynthesizeSpeechoperation in the Amazon Polly developer guide .

        If you do not specify a value, the default is standard .

    • botLocaleStatus (string) --

      The current status of the locale. When the bot status is Built the locale is ready for use.

    • failureReasons (list) --

      If the botLocaleStatus is Failed , the failureReasons field lists the errors that occurred while building the bot.

      • (string) --
    • creationDateTime (datetime) --

      A timestamp of the date and time that the locale was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the date and time that the locale was last updated.

    • recommendedActions (list) --

      Recommended actions to take to resolve an error in the failureReasons field.

      • (string) --

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
update_bot_recommendation(**kwargs)

Updates an existing bot recommendation request.

See also: AWS API Documentation

Request Syntax

response = client.update_bot_recommendation(
    botId='string',
    botVersion='string',
    localeId='string',
    botRecommendationId='string',
    encryptionSetting={
        'kmsKeyArn': 'string',
        'botLocaleExportPassword': 'string',
        'associatedTranscriptsPassword': 'string'
    }
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot containing the bot recommendation to be updated.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot containing the bot recommendation to be updated.

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale of the bot recommendation to update. The string must match one of the supported locales. For more information, see Supported languages

  • botRecommendationId (string) --

    [REQUIRED]

    The unique identifier of the bot recommendation to be updated.

  • encryptionSetting (dict) --

    [REQUIRED]

    The object representing the passwords that will be used to encrypt the data related to the bot recommendation results, as well as the KMS key ARN used to encrypt the associated metadata.

    • kmsKeyArn (string) --

      The KMS key ARN used to encrypt the metadata associated with the bot recommendation.

    • botLocaleExportPassword (string) --

      The password used to encrypt the recommended bot recommendation file.

    • associatedTranscriptsPassword (string) --

      The password used to encrypt the associated transcript file.

Return type

dict

Returns

Response Syntax

{
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'botRecommendationStatus': 'Processing'|'Deleting'|'Deleted'|'Downloading'|'Updating'|'Available'|'Failed'|'Stopping'|'Stopped',
    'botRecommendationId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'transcriptSourceSetting': {
        's3BucketTranscriptSource': {
            's3BucketName': 'string',
            'pathFormat': {
                'objectPrefixes': [
                    'string',
                ]
            },
            'transcriptFormat': 'Lex',
            'transcriptFilter': {
                'lexTranscriptFilter': {
                    'dateRangeFilter': {
                        'startDateTime': datetime(2015, 1, 1),
                        'endDateTime': datetime(2015, 1, 1)
                    }
                }
            },
            'kmsKeyArn': 'string'
        }
    },
    'encryptionSetting': {
        'kmsKeyArn': 'string',
        'botLocaleExportPassword': 'string',
        'associatedTranscriptsPassword': 'string'
    }
}

Response Structure

  • (dict) --

    • botId (string) --

      The unique identifier of the bot containing the bot recommendation that has been updated.

    • botVersion (string) --

      The version of the bot containing the bot recommendation that has been updated.

    • localeId (string) --

      The identifier of the language and locale of the bot recommendation to update. The string must match one of the supported locales. For more information, see Supported languages

    • botRecommendationStatus (string) --

      The status of the bot recommendation.

      If the status is Failed, then the reasons for the failure are listed in the failureReasons field.

    • botRecommendationId (string) --

      The unique identifier of the bot recommendation to be updated.

    • creationDateTime (datetime) --

      A timestamp of the date and time that the bot recommendation was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the date and time that the bot recommendation was last updated.

    • transcriptSourceSetting (dict) --

      The object representing the Amazon S3 bucket containing the transcript, as well as the associated metadata.

      • s3BucketTranscriptSource (dict) --

        Indicates the setting of the Amazon S3 bucket where the transcript is stored.

        • s3BucketName (string) --

          The name of the bucket containing the transcript and the associated metadata.

        • pathFormat (dict) --

          The object that contains a path format that will be applied when Amazon Lex reads the transcript file in the bucket you provide. Specify this object if you only want Lex to read a subset of files in your Amazon S3 bucket.

          • objectPrefixes (list) --

            A list of Amazon S3 prefixes that points to sub-folders in the Amazon S3 bucket. Specify this list if you only want Lex to read the files under this set of sub-folders.

            • (string) --
        • transcriptFormat (string) --

          The format of the transcript content. Currently, Genie only supports the Amazon Lex transcript format.

        • transcriptFilter (dict) --

          The object that contains the filter which will be applied when Amazon Lex reads through the Amazon S3 bucket. Specify this object if you want Amazon Lex to read only a subset of the Amazon S3 bucket based on the filter you provide.

          • lexTranscriptFilter (dict) --

            The object representing the filter that Amazon Lex will use to select the appropriate transcript when the transcript format is the Amazon Lex format.

            • dateRangeFilter (dict) --

              The object that contains a date range filter that will be applied to the transcript. Specify this object if you want Amazon Lex to only read the files that are within the date range.

              • startDateTime (datetime) --

                A timestamp indicating the start date for the date range filter.

              • endDateTime (datetime) --

                A timestamp indicating the end date for the date range filter.

        • kmsKeyArn (string) --

          The ARN of the KMS key that customer use to encrypt their Amazon S3 bucket. Only use this field if your bucket is encrypted using a customer managed KMS key.

    • encryptionSetting (dict) --

      The object representing the passwords that were used to encrypt the data related to the bot recommendation results, as well as the KMS key ARN used to encrypt the associated metadata.

      • kmsKeyArn (string) --

        The KMS key ARN used to encrypt the metadata associated with the bot recommendation.

      • botLocaleExportPassword (string) --

        The password used to encrypt the recommended bot recommendation file.

      • associatedTranscriptsPassword (string) --

        The password used to encrypt the associated transcript file.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
update_export(**kwargs)

Updates the password used to protect an export zip archive.

The password is not required. If you don't supply a password, Amazon Lex generates a zip file that is not protected by a password. This is the archive that is available at the pre-signed S3 URL provided by the DescribeExport operation.

See also: AWS API Documentation

Request Syntax

response = client.update_export(
    exportId='string',
    filePassword='string'
)
Parameters
  • exportId (string) --

    [REQUIRED]

    The unique identifier Amazon Lex assigned to the export.

  • filePassword (string) -- The new password to use to encrypt the export zip archive.
Return type

dict

Returns

Response Syntax

{
    'exportId': 'string',
    'resourceSpecification': {
        'botExportSpecification': {
            'botId': 'string',
            'botVersion': 'string'
        },
        'botLocaleExportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        },
        'customVocabularyExportSpecification': {
            'botId': 'string',
            'botVersion': 'string',
            'localeId': 'string'
        }
    },
    'fileFormat': 'LexJson'|'TSV',
    'exportStatus': 'InProgress'|'Completed'|'Failed'|'Deleting',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • exportId (string) --

      The unique identifier Amazon Lex assigned to the export.

    • resourceSpecification (dict) --

      A description of the type of resource that was exported, either a bot or a bot locale.

      • botExportSpecification (dict) --

        Parameters for exporting a bot.

        • botId (string) --

          The identifier of the bot assigned by Amazon Lex.

        • botVersion (string) --

          The version of the bot that was exported. This will be either DRAFT or the version number.

      • botLocaleExportSpecification (dict) --

        Parameters for exporting a bot locale.

        • botId (string) --

          The identifier of the bot to create the locale for.

        • botVersion (string) --

          The version of the bot to export.

        • localeId (string) --

          The identifier of the language and locale to export. The string must match one of the locales in the bot.

      • customVocabularyExportSpecification (dict) --

        The parameters required to export a custom vocabulary.

        • botId (string) --

          The identifier of the bot that contains the custom vocabulary to export.

        • botVersion (string) --

          The version of the bot that contains the custom vocabulary to export.

        • localeId (string) --

          The locale of the bot that contains the custom vocabulary to export.

    • fileFormat (string) --

      The file format used for the files that define the resource. The TSV format is required to export a custom vocabulary only; otherwise use LexJson format.

    • exportStatus (string) --

      The status of the export. When the status is Completed the export archive is available for download.

    • creationDateTime (datetime) --

      The date and time that the export was created.

    • lastUpdatedDateTime (datetime) --

      The date and time that the export was last updated.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
update_intent(**kwargs)

Updates the settings for an intent.

See also: AWS API Documentation

Request Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Parameters

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Return type
dict
Returns

Response Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Response Structure

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
update_resource_policy(**kwargs)

Replaces the existing resource policy for a bot or bot alias with a new one. If the policy doesn't exist, Amazon Lex returns an exception.

See also: AWS API Documentation

Request Syntax

response = client.update_resource_policy(
    resourceArn='string',
    policy='string',
    expectedRevisionId='string'
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

  • policy (string) --

    [REQUIRED]

    A resource policy to add to the resource. The policy is a JSON structure that contains one or more statements that define the policy. The policy must follow the IAM syntax. For more information about the contents of a JSON policy document, see IAM JSON policy reference.

    If the policy isn't valid, Amazon Lex returns a validation exception.

  • expectedRevisionId (string) --

    The identifier of the revision of the policy to update. If this revision ID doesn't match the current revision ID, Amazon Lex throws an exception.

    If you don't specify a revision, Amazon Lex overwrites the contents of the policy with the new values.

Return type

dict

Returns

Response Syntax

{
    'resourceArn': 'string',
    'revisionId': 'string'
}

Response Structure

  • (dict) --

    • resourceArn (string) --

      The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

    • revisionId (string) --

      The current revision of the resource policy. Use the revision ID to make sure that you are updating the most current version of a resource policy when you add a policy statement to a resource, delete a resource, or update a resource.

Exceptions

  • LexModelsV2.Client.exceptions.ResourceNotFoundException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.InternalServerException
  • LexModelsV2.Client.exceptions.ThrottlingException
update_slot(**kwargs)

Updates the settings for a slot.

See also: AWS API Documentation

Request Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Parameters

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Return type
dict
Returns

Response Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Response Structure

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException
update_slot_type(**kwargs)

Updates the configuration of an existing slot type.

See also: AWS API Documentation

Request Syntax

response = client.update_slot_type(
    slotTypeId='string',
    slotTypeName='string',
    description='string',
    slotTypeValues=[
        {
            'sampleValue': {
                'value': 'string'
            },
            'synonyms': [
                {
                    'value': 'string'
                },
            ]
        },
    ],
    valueSelectionSetting={
        'resolutionStrategy': 'OriginalValue'|'TopResolution'|'Concatenation',
        'regexFilter': {
            'pattern': 'string'
        },
        'advancedRecognitionSetting': {
            'audioRecognitionStrategy': 'UseSlotValuesAsCustomVocabulary'
        }
    },
    parentSlotTypeSignature='string',
    botId='string',
    botVersion='string',
    localeId='string',
    externalSourceSetting={
        'grammarSlotTypeSetting': {
            'source': {
                's3BucketName': 'string',
                's3ObjectKey': 'string',
                'kmsKeyArn': 'string'
            }
        }
    },
    compositeSlotTypeSetting={
        'subSlots': [
            {
                'name': 'string',
                'slotTypeId': 'string'
            },
        ]
    }
)
Parameters
  • slotTypeId (string) --

    [REQUIRED]

    The unique identifier of the slot type to update.

  • slotTypeName (string) --

    [REQUIRED]

    The new name of the slot type.

  • description (string) -- The new description of the slot type.
  • slotTypeValues (list) --

    A new list of values and their optional synonyms that define the values that the slot type can take.

    • (dict) --

      Each slot type can have a set of values. Each SlotTypeValue represents a value that the slot type can take.

      • sampleValue (dict) --

        The value of the slot type entry.

        • value (string) -- [REQUIRED]

          The value that can be used for a slot type.

      • synonyms (list) --

        Additional values related to the slot type entry.

        • (dict) --

          Defines one of the values for a slot type.

          • value (string) -- [REQUIRED]

            The value that can be used for a slot type.

  • valueSelectionSetting (dict) --

    The strategy that Amazon Lex should use when deciding on a value from the list of slot type values.

    • resolutionStrategy (string) -- [REQUIRED]

      Determines the slot resolution strategy that Amazon Lex uses to return slot type values. The field can be set to one of the following values:

      • OriginalValue - Returns the value entered by the user, if the user value is similar to the slot value.
      • TopResolution - If there is a resolution list for the slot, return the first value in the resolution list as the slot type value. If there is no resolution list, null is returned.

      If you don't specify the valueSelectionStrategy, the default is OriginalValue.

    • regexFilter (dict) --

      A regular expression used to validate the value of a slot.

      • pattern (string) -- [REQUIRED]

        A regular expression used to validate the value of a slot.

        Use a standard regular expression. Amazon Lex supports the following characters in the regular expression:

        • A-Z, a-z
        • 0-9
        • Unicode characters ("u<Unicode>")

        Represent Unicode characters with four digits, for example "u0041" or "u005A".

        The following regular expression operators are not supported:

        • Infinite repeaters: *, +, or {x,} with no upper bound.
        • Wild card (.)
    • advancedRecognitionSetting (dict) --

      Provides settings that enable advanced recognition settings for slot values.

      • audioRecognitionStrategy (string) --

        Enables using the slot values as a custom vocabulary for recognizing user utterances.

  • parentSlotTypeSignature (string) -- The new built-in slot type that should be used as the parent of this slot type.
  • botId (string) --

    [REQUIRED]

    The identifier of the bot that contains the slot type.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot that contains the slot type. Must be DRAFT .

  • localeId (string) --

    [REQUIRED]

    The identifier of the language and locale that contains the slot type. The string must match one of the supported locales. For more information, see Supported languages.

  • externalSourceSetting (dict) --

    Provides information about the external source of the slot type's definition.

    • grammarSlotTypeSetting (dict) --

      Settings required for a slot type based on a grammar that you provide.

      • source (dict) --

        The source of the grammar used to create the slot type.

        • s3BucketName (string) -- [REQUIRED]

          The name of the S3 bucket that contains the grammar source.

        • s3ObjectKey (string) -- [REQUIRED]

          The path to the grammar in the S3 bucket.

        • kmsKeyArn (string) --

          The Amazon KMS key required to decrypt the contents of the grammar, if any.

  • compositeSlotTypeSetting (dict) --

    Specifications for a composite slot type.

    • subSlots (list) --

      Subslots in the composite slot.

      • (dict) --

        Subslot type composition.

        • name (string) -- [REQUIRED]

          Name of a constituent sub slot inside a composite slot.

        • slotTypeId (string) -- [REQUIRED]

          The unique identifier assigned to a slot type. This refers to either a built-in slot type or the unique slotTypeId of a custom slot type.

Return type

dict

Returns

Response Syntax

{
    'slotTypeId': 'string',
    'slotTypeName': 'string',
    'description': 'string',
    'slotTypeValues': [
        {
            'sampleValue': {
                'value': 'string'
            },
            'synonyms': [
                {
                    'value': 'string'
                },
            ]
        },
    ],
    'valueSelectionSetting': {
        'resolutionStrategy': 'OriginalValue'|'TopResolution'|'Concatenation',
        'regexFilter': {
            'pattern': 'string'
        },
        'advancedRecognitionSetting': {
            'audioRecognitionStrategy': 'UseSlotValuesAsCustomVocabulary'
        }
    },
    'parentSlotTypeSignature': 'string',
    'botId': 'string',
    'botVersion': 'string',
    'localeId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'lastUpdatedDateTime': datetime(2015, 1, 1),
    'externalSourceSetting': {
        'grammarSlotTypeSetting': {
            'source': {
                's3BucketName': 'string',
                's3ObjectKey': 'string',
                'kmsKeyArn': 'string'
            }
        }
    },
    'compositeSlotTypeSetting': {
        'subSlots': [
            {
                'name': 'string',
                'slotTypeId': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    • slotTypeId (string) --

      The unique identifier of the updated slot type.

    • slotTypeName (string) --

      The updated name of the slot type.

    • description (string) --

      The updated description of the slot type.

    • slotTypeValues (list) --

      The updated values that the slot type provides.

      • (dict) --

        Each slot type can have a set of values. Each SlotTypeValue represents a value that the slot type can take.

        • sampleValue (dict) --

          The value of the slot type entry.

          • value (string) --

            The value that can be used for a slot type.

        • synonyms (list) --

          Additional values related to the slot type entry.

          • (dict) --

            Defines one of the values for a slot type.

            • value (string) --

              The value that can be used for a slot type.

    • valueSelectionSetting (dict) --

      The updated strategy that Amazon Lex uses to determine which value to select from the slot type.

      • resolutionStrategy (string) --

        Determines the slot resolution strategy that Amazon Lex uses to return slot type values. The field can be set to one of the following values:

        • OriginalValue - Returns the value entered by the user, if the user value is similar to the slot value.
        • TopResolution - If there is a resolution list for the slot, return the first value in the resolution list as the slot type value. If there is no resolution list, null is returned.

        If you don't specify the valueSelectionStrategy, the default is OriginalValue.

      • regexFilter (dict) --

        A regular expression used to validate the value of a slot.

        • pattern (string) --

          A regular expression used to validate the value of a slot.

          Use a standard regular expression. Amazon Lex supports the following characters in the regular expression:

          • A-Z, a-z
          • 0-9
          • Unicode characters ("u<Unicode>")

          Represent Unicode characters with four digits, for example "u0041" or "u005A".

          The following regular expression operators are not supported:

          • Infinite repeaters: *, +, or {x,} with no upper bound.
          • Wild card (.)
      • advancedRecognitionSetting (dict) --

        Provides settings that enable advanced recognition settings for slot values.

        • audioRecognitionStrategy (string) --

          Enables using the slot values as a custom vocabulary for recognizing user utterances.

    • parentSlotTypeSignature (string) --

      The updated signature of the built-in slot type that is the parent of this slot type.

    • botId (string) --

      The identifier of the bot that contains the slot type.

    • botVersion (string) --

      The version of the bot that contains the slot type. This is always DRAFT .

    • localeId (string) --

      The language and locale of the updated slot type.

    • creationDateTime (datetime) --

      The timestamp of the date and time that the slot type was created.

    • lastUpdatedDateTime (datetime) --

      A timestamp of the date and time that the slot type was last updated.

    • externalSourceSetting (dict) --

      Provides information about the external source of the slot type's definition.

      • grammarSlotTypeSetting (dict) --

        Settings required for a slot type based on a grammar that you provide.

        • source (dict) --

          The source of the grammar used to create the slot type.

          • s3BucketName (string) --

            The name of the S3 bucket that contains the grammar source.

          • s3ObjectKey (string) --

            The path to the grammar in the S3 bucket.

          • kmsKeyArn (string) --

            The Amazon KMS key required to decrypt the contents of the grammar, if any.

    • compositeSlotTypeSetting (dict) --

      Specifications for a composite slot type.

      • subSlots (list) --

        Subslots in the composite slot.

        • (dict) --

          Subslot type composition.

          • name (string) --

            Name of a constituent sub slot inside a composite slot.

          • slotTypeId (string) --

            The unique identifier assigned to a slot type. This refers to either a built-in slot type or the unique slotTypeId of a custom slot type.

Exceptions

  • LexModelsV2.Client.exceptions.ThrottlingException
  • LexModelsV2.Client.exceptions.ServiceQuotaExceededException
  • LexModelsV2.Client.exceptions.ValidationException
  • LexModelsV2.Client.exceptions.PreconditionFailedException
  • LexModelsV2.Client.exceptions.ConflictException
  • LexModelsV2.Client.exceptions.InternalServerException

Paginators

The available paginators are:

Waiters

The available waiters are:

class LexModelsV2.Waiter.BotAliasAvailable
waiter = client.get_waiter('bot_alias_available')
wait(**kwargs)

Polls LexModelsV2.Client.describe_bot_alias() every 10 seconds until a successful state is reached. An error is returned after 35 failed checks.

See also: AWS API Documentation

Request Syntax

waiter.wait(
    botAliasId='string',
    botId='string',
    WaiterConfig={
        'Delay': 123,
        'MaxAttempts': 123
    }
)
Parameters
  • botAliasId (string) --

    [REQUIRED]

    The identifier of the bot alias to describe.

  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the bot alias to describe.

  • WaiterConfig (dict) --

    A dictionary that provides parameters to control waiting behavior.

    • Delay (integer) --

      The amount of time in seconds to wait between attempts. Default: 10

    • MaxAttempts (integer) --

      The maximum number of attempts to be made. Default: 35

Returns

None

class LexModelsV2.Waiter.BotAvailable
waiter = client.get_waiter('bot_available')
wait(**kwargs)

Polls LexModelsV2.Client.describe_bot() every 10 seconds until a successful state is reached. An error is returned after 35 failed checks.

See also: AWS API Documentation

Request Syntax

waiter.wait(
    botId='string',
    WaiterConfig={
        'Delay': 123,
        'MaxAttempts': 123
    }
)
Parameters
  • botId (string) --

    [REQUIRED]

    The unique identifier of the bot to describe.

  • WaiterConfig (dict) --

    A dictionary that provides parameters to control waiting behavior.

    • Delay (integer) --

      The amount of time in seconds to wait between attempts. Default: 10

    • MaxAttempts (integer) --

      The maximum number of attempts to be made. Default: 35

Returns

None

class LexModelsV2.Waiter.BotExportCompleted
waiter = client.get_waiter('bot_export_completed')
wait(**kwargs)

Polls LexModelsV2.Client.describe_export() every 10 seconds until a successful state is reached. An error is returned after 35 failed checks.

See also: AWS API Documentation

Request Syntax

waiter.wait(
    exportId='string',
    WaiterConfig={
        'Delay': 123,
        'MaxAttempts': 123
    }
)
Parameters
  • exportId (string) --

    [REQUIRED]

    The unique identifier of the export to describe.

  • WaiterConfig (dict) --

    A dictionary that provides parameters to control waiting behavior.

    • Delay (integer) --

      The amount of time in seconds to wait between attempts. Default: 10

    • MaxAttempts (integer) --

      The maximum number of attempts to be made. Default: 35

Returns

None

class LexModelsV2.Waiter.BotImportCompleted
waiter = client.get_waiter('bot_import_completed')
wait(**kwargs)

Polls LexModelsV2.Client.describe_import() every 10 seconds until a successful state is reached. An error is returned after 35 failed checks.

See also: AWS API Documentation

Request Syntax

waiter.wait(
    importId='string',
    WaiterConfig={
        'Delay': 123,
        'MaxAttempts': 123
    }
)
Parameters
  • importId (string) --

    [REQUIRED]

    The unique identifier of the import to describe.

  • WaiterConfig (dict) --

    A dictionary that provides parameters to control waiting behavior.

    • Delay (integer) --

      The amount of time in seconds to wait between attempts. Default: 10

    • MaxAttempts (integer) --

      The maximum number of attempts to be made. Default: 35

Returns

None

class LexModelsV2.Waiter.BotLocaleBuilt
waiter = client.get_waiter('bot_locale_built')
wait(**kwargs)

Polls LexModelsV2.Client.describe_bot_locale() every 10 seconds until a successful state is reached. An error is returned after 35 failed checks.

See also: AWS API Documentation

Request Syntax

waiter.wait(
    botId='string',
    botVersion='string',
    localeId='string',
    WaiterConfig={
        'Delay': 123,
        'MaxAttempts': 123
    }
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the locale.

  • botVersion (string) --

    [REQUIRED]

    The identifier of the version of the bot associated with the locale.

  • localeId (string) --

    [REQUIRED]

    The unique identifier of the locale to describe. The string must match one of the supported locales. For more information, see Supported languages.

  • WaiterConfig (dict) --

    A dictionary that provides parameters to control waiting behavior.

    • Delay (integer) --

      The amount of time in seconds to wait between attempts. Default: 10

    • MaxAttempts (integer) --

      The maximum number of attempts to be made. Default: 35

Returns

None

class LexModelsV2.Waiter.BotLocaleCreated
waiter = client.get_waiter('bot_locale_created')
wait(**kwargs)

Polls LexModelsV2.Client.describe_bot_locale() every 10 seconds until a successful state is reached. An error is returned after 35 failed checks.

See also: AWS API Documentation

Request Syntax

waiter.wait(
    botId='string',
    botVersion='string',
    localeId='string',
    WaiterConfig={
        'Delay': 123,
        'MaxAttempts': 123
    }
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the locale.

  • botVersion (string) --

    [REQUIRED]

    The identifier of the version of the bot associated with the locale.

  • localeId (string) --

    [REQUIRED]

    The unique identifier of the locale to describe. The string must match one of the supported locales. For more information, see Supported languages.

  • WaiterConfig (dict) --

    A dictionary that provides parameters to control waiting behavior.

    • Delay (integer) --

      The amount of time in seconds to wait between attempts. Default: 10

    • MaxAttempts (integer) --

      The maximum number of attempts to be made. Default: 35

Returns

None

class LexModelsV2.Waiter.BotLocaleExpressTestingAvailable
waiter = client.get_waiter('bot_locale_express_testing_available')
wait(**kwargs)

Polls LexModelsV2.Client.describe_bot_locale() every 10 seconds until a successful state is reached. An error is returned after 35 failed checks.

See also: AWS API Documentation

Request Syntax

waiter.wait(
    botId='string',
    botVersion='string',
    localeId='string',
    WaiterConfig={
        'Delay': 123,
        'MaxAttempts': 123
    }
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot associated with the locale.

  • botVersion (string) --

    [REQUIRED]

    The identifier of the version of the bot associated with the locale.

  • localeId (string) --

    [REQUIRED]

    The unique identifier of the locale to describe. The string must match one of the supported locales. For more information, see Supported languages.

  • WaiterConfig (dict) --

    A dictionary that provides parameters to control waiting behavior.

    • Delay (integer) --

      The amount of time in seconds to wait between attempts. Default: 10

    • MaxAttempts (integer) --

      The maximum number of attempts to be made. Default: 35

Returns

None

class LexModelsV2.Waiter.BotVersionAvailable
waiter = client.get_waiter('bot_version_available')
wait(**kwargs)

Polls LexModelsV2.Client.describe_bot_version() every 10 seconds until a successful state is reached. An error is returned after 35 failed checks.

See also: AWS API Documentation

Request Syntax

waiter.wait(
    botId='string',
    botVersion='string',
    WaiterConfig={
        'Delay': 123,
        'MaxAttempts': 123
    }
)
Parameters
  • botId (string) --

    [REQUIRED]

    The identifier of the bot containing the version to return metadata for.

  • botVersion (string) --

    [REQUIRED]

    The version of the bot to return metadata for.

  • WaiterConfig (dict) --

    A dictionary that provides parameters to control waiting behavior.

    • Delay (integer) --

      The amount of time in seconds to wait between attempts. Default: 10

    • MaxAttempts (integer) --

      The maximum number of attempts to be made. Default: 35

Returns

None