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