Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1465766489.0 KB

Starts a batch evaluation job that evaluates agent performance across multiple sessions. Batch evaluations pull agent traces from CloudWatch Logs or an existing online evaluation configuration and run specified evaluators and insights against them.

post/evaluations/batch-evaluate

Request body

batchEvaluationNamestring required

A human-readable name for a batch evaluation.

clientTokenstring

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, the service ignores the request, but does not return an error.

tagsobject

A map of tag keys and values to associate with the batch evaluation.

kmsKeyArnstring

The ARN of the KMS key used to encrypt evaluation data. If provided, customer data is encrypted at rest with the specified key.

descriptionstring

The description of the batch evaluation.

Response

Success

batchEvaluationIdstring required

The unique identifier of the created batch evaluation.

batchEvaluationArnstring required

The Amazon Resource Name (ARN) of the created batch evaluation.

batchEvaluationNamestring required

The name of the batch evaluation.

status'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'COMPLETED_WITH_ERRORS' | 'FAILED' | 'STOPPING' | 'STOPPED' | 'DELETING' required

The status of the batch evaluation.

createdAtstring date-time required

The timestamp when the batch evaluation was created.

tagsobject

The tags associated with the batch evaluation.

kmsKeyArnstring

The ARN of the KMS key used to encrypt evaluation data.

descriptionstring

The description of the batch evaluation.