LexModelsV2 / Client / start_test_set_generation

start_test_set_generation

LexModelsV2.Client.start_test_set_generation(**kwargs)

The action to start the generation of test set.

See also: AWS API Documentation

Request Syntax

response = client.start_test_set_generation(
    testSetName='string',
    description='string',
    storageLocation={
        's3BucketName': 'string',
        's3Path': 'string',
        'kmsKeyArn': 'string'
    },
    generationDataSource={
        'conversationLogsDataSource': {
            'botId': 'string',
            'botAliasId': 'string',
            'localeId': 'string',
            'filter': {
                'startTime': datetime(2015, 1, 1),
                'endTime': datetime(2015, 1, 1),
                'inputMode': 'Speech'|'Text'
            }
        }
    },
    roleArn='string',
    testSetTags={
        'string': 'string'
    }
)

Parameters:

• testSetName (string) –

  [REQUIRED]

  The test set name for the test set generation request.

• description (string) – The test set description for the test set generation request.

• storageLocation (dict) –

  [REQUIRED]

  The Amazon S3 storage location for the test set generation.

  • s3BucketName (string) – [REQUIRED]

    The name of the Amazon S3 bucket in which the test set is stored.

  • s3Path (string) – [REQUIRED]

    The path inside the Amazon S3 bucket where the test set is stored.

  • kmsKeyArn (string) –

    The Amazon Resource Name (ARN) of an Amazon Web Services Key Management Service (KMS) key for encrypting the test set.

• generationDataSource (dict) –

  [REQUIRED]

  The data source for the test set generation.

  • conversationLogsDataSource (dict) –

    Contains information about the bot from which the conversation logs are sourced.

    • botId (string) – [REQUIRED]

      The bot Id from the conversation logs.

    • botAliasId (string) – [REQUIRED]

      The bot alias Id from the conversation logs.

    • localeId (string) – [REQUIRED]

      The locale Id of the conversation log.

    • filter (dict) – [REQUIRED]

      The filter for the data source of the conversation log.

      • startTime (datetime) – [REQUIRED]

        The start time for the conversation log.

      • endTime (datetime) – [REQUIRED]

        The end time for the conversation log.

      • inputMode (string) – [REQUIRED]

        The selection to filter by input mode for the conversation logs.

• roleArn (string) –

  [REQUIRED]

  The roleARN used for any operation in the test set to access resources in the Amazon Web Services account.

• testSetTags (dict) –

  A list of tags to add to the test set. You can only add tags when you import/generate a new test set. You can’t use the UpdateTestSet operation to update tags. To update tags, use the TagResource operation.

  • (string) –

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'testSetGenerationId': 'string',
    'creationDateTime': datetime(2015, 1, 1),
    'testSetGenerationStatus': 'Generating'|'Ready'|'Failed'|'Pending',
    'testSetName': 'string',
    'description': 'string',
    'storageLocation': {
        's3BucketName': 'string',
        's3Path': 'string',
        'kmsKeyArn': 'string'
    },
    'generationDataSource': {
        'conversationLogsDataSource': {
            'botId': 'string',
            'botAliasId': 'string',
            'localeId': 'string',
            'filter': {
                'startTime': datetime(2015, 1, 1),
                'endTime': datetime(2015, 1, 1),
                'inputMode': 'Speech'|'Text'
            }
        }
    },
    'roleArn': 'string',
    'testSetTags': {
        'string': 'string'
    }
}

Response Structure

• (dict) –

  • testSetGenerationId (string) –

    The unique identifier of the test set generation to describe.

  • creationDateTime (datetime) –

    The creation date and time for the test set generation.

  • testSetGenerationStatus (string) –

    The status for the test set generation.

  • testSetName (string) –

    The test set name used for the test set generation.

  • description (string) –

    The description used for the test set generation.

  • storageLocation (dict) –

    The Amazon S3 storage location for the test set generation.

    • s3BucketName (string) –

      The name of the Amazon S3 bucket in which the test set is stored.

    • s3Path (string) –

      The path inside the Amazon S3 bucket where the test set is stored.

    • kmsKeyArn (string) –

      The Amazon Resource Name (ARN) of an Amazon Web Services Key Management Service (KMS) key for encrypting the test set.

  • generationDataSource (dict) –

    The data source for the test set generation.

    • conversationLogsDataSource (dict) –

      Contains information about the bot from which the conversation logs are sourced.

      • botId (string) –

        The bot Id from the conversation logs.

      • botAliasId (string) –

        The bot alias Id from the conversation logs.

      • localeId (string) –

        The locale Id of the conversation log.

      • filter (dict) –

        The filter for the data source of the conversation log.

        • startTime (datetime) –

          The start time for the conversation log.

        • endTime (datetime) –

          The end time for the conversation log.

        • inputMode (string) –

          The selection to filter by input mode for the conversation logs.

  • roleArn (string) –

    The roleARN used for any operation in the test set to access resources in the Amazon Web Services account.

  • testSetTags (dict) –

    A list of tags that was used for the test set that is being generated.

    • (string) –

      • (string) –

Exceptions

• LexModelsV2.Client.exceptions.ThrottlingException

• LexModelsV2.Client.exceptions.ServiceQuotaExceededException

• LexModelsV2.Client.exceptions.ValidationException

• LexModelsV2.Client.exceptions.ConflictException

• LexModelsV2.Client.exceptions.ResourceNotFoundException

• LexModelsV2.Client.exceptions.InternalServerException