List online evaluations

The ListOnlineEvaluationConfigs API retrieves a paginated list of all online evaluation configurations in your account and Region. This synchronous operation uses the POST method and returns summary information for each configuration.

The response includes an array of evaluation configuration summaries containing the configuration ARN, ID, name, description, lifecycle status (Creating, Active, Updating, or Deleting), execution status (ENABLED or DISABLED), creation and update timestamps, and any failure reasons.

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

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

AgentCore CLI

agentcore eval online list

AgentCore SDK

from bedrock_agentcore_starter_toolkit import Evaluation

# Initialize the evaluation client
eval_client = Evaluation()

# List all online evaluation configurations, optionally filtered by agent.
configs= eval_client.list_online_configs()
agent_config_list = configs.get('onlineEvaluationConfigs', [])
print(f"Found {len(agent_config_list)} configuration(s) for this agent")
for cfg in agent_config_list:
    print(f"  • {cfg['onlineEvaluationConfigName']}")
    print(f"    ID: {cfg['onlineEvaluationConfigId']}")
    print(f"    Status: {cfg['status']}")

AWS SDK

import boto3

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

list_configs_response = client.list_online_evaluation_configs(maxResults=20)

AWS CLI

aws bedrock-agentcore-control list-online-evaluation-configs \
    --max-results 20

Console

You can view and manage your online evaluation configurations through a visual interface that displays configuration details in an organized table format.