View a markdown version of this page

获取在线评估 - Amazon Bedrock AgentCore
生命周期状态AgentCore SDK 的代码示例和 AWS SDK控制台

获取在线评估

GetOnlineEvaluationConfigAPI 检索现有在线评估配置的完整详细信息和当前状态。此同步操作返回完整配置，包括数据源、赋值器、执行状态和操作元数据。

使用此 API 监控配置的生命周期状态（ACTIVE、、CREATING、CREATE_FAILED、UPDATING、UPDATE_FAILEDDELETING、或ERROR），检查当前的执行状态（ENABLED或DISABLED），并检索所有配置参数，包括评估者列表、数据源设置和输出目标。

生命周期状态

在线评估配置上的status字段报告其生命周期状态，该executionStatus字段与控制评估任务是否正在主动处理跟踪的字段是分开的。

  • ACTIVE— 配置已完全配置完毕，随时可以使用。

  • CREATING— 正在配置配置。请等待它过渡到，ACTIVE然后再进行更新或删除。

  • CREATE_FAILED— 创建未成功完成。您无法更新处于这种状态的配置；DeleteOnlineEvaluationConfig请调用将其删除，然后创建一个新配置。

  • UPDATING— 更新正在进行中。等待操作完成后再进行其他更改。

  • UPDATE_FAILED— 最新更新不适用。您可以通过UpdateOnlineEvaluationConfig再次调用来重试，也可以使用DeleteOnlineEvaluationConfig删除配置。

  • DELETING— 正在删除配置。

  • ERROR— 出现问题，需要您采取措施。检查该failureReason字段以确定问题。常见原因包括 IAM 角色访问权限不足、缺少日志组权限和超出服务配额。修复问题后，请UpdateOnlineEvaluationConfig致电重试或DeleteOnlineEvaluationConfig删除配置。

AgentCore SDK 的代码示例和 AWS SDK

以下代码示例演示了如何使用不同的开发方法获取在线评估配置的详细信息。选择最适合您的开发环境和偏好的方法。

例
AgentCore SDK

  1. from bedrock_agentcore_starter_toolkit import Evaluation

# Initialize the evaluation client
eval_client = Evaluation()

config_id = "config-abc123"
print(f"\nUsing config_id: {config_id}")

config_details = eval_client.get_online_config(config_id)
# Display configuration details
print(f"Config Name: {config_details['onlineEvaluationConfigName']}")
print(f"Config ID: {config_details['onlineEvaluationConfigId']}")
print(f"Status: {config_details['status']}")
AWS SDK

  1. import boto3

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

response = client.get_online_evaluation_config(
    onlineEvaluationConfigId='your_config_id'
)
AWS CLI

  1. aws bedrock-agentcore-control get-online-evaluation-config \
    --online-evaluation-config-id your_config_id

控制台

您可以通过控制台界面查看有关特定在线评估配置的详细信息。

要获取在线评估配置的详细信息

  1. 打开 Amazon Bedrock AgentCore 控制台。

  2. 在导航窗格中，选择 “评估”。

  3. 在评估配置卡中，查看列出您创建的评估配置的表。

  4. 要查看特定评估配置的信息，请选择配置名称以查看其详细信息。