List evaluators

The ListEvaluators API returns a paginated list of all custom evaluators in your account and Region, including both your custom evaluators and built-in evaluators. Built-in evaluators are returned first.

Filtering: The API supports pagination through nextToken and maxResults parameters (1-100 results per page). Each evaluator summary includes type (Builtin or Custom), status, level, and lock state.

Summary information: Returns essential metadata including ARN, name, description, evaluation level, creation and update timestamps, and current lock status for quick overview and selection.

Code samples for Starter Toolkit, AgentCore SDK, and AWS SDK

The following code samples demonstrate how to list evaluators using different development approaches. Choose the method that best fits your development environment and preferences.

AgentCore CLI

agentcore eval evaluator list

AgentCore SDK

from bedrock_agentcore_starter_toolkit import Evaluation

eval_client = Evaluation()

available_evaluators = eval_client.list_evaluators()

AWS SDK

import boto3

client = boto3.client('bedrock-agentcore-control')

list_configs_response = client.list_evaluators(maxResults=20)

AWS CLI

aws bedrock-agentcore-control list-evaluators \
    --max-results 20

Console

Use the console to view and manage your custom evaluators through a visual interface that displays evaluator details in an organized table format.