Get evaluator

The GetEvaluator API retrieves complete details of a specific custom or built-in evaluator including its configuration, status, and lock state.

Lock status: The response includes lockedForModification indicating whether the evaluator is in use by an enabled evaluation configuration. Locked evaluators cannot be modified.

Use this API to inspect evaluator settings, verify configuration changes, and check availability for modification or deletion.

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

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

AgentCore CLI

agentcore eval evaluator get --evaluator-id 'your_evaluator_id'

AgentCore SDK

from bedrock_agentcore_starter_toolkit import Evaluation

eval_client = Evaluation()

eval_client.get_evaluator(evaluator_id="your_evaluator_id")

AWS SDK

import boto3

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

list_configs_response = client.get_evaluator(evaluatorId='your_evaluator_id')

AWS CLI

aws bedrock-agentcore-control get-evaluator \
    --evaluator-id 'your_evaluator_id'

Console

View detailed information about a specific custom evaluator, including its configuration, status, and usage history through the console interface.