View a markdown version of this page

获取在线评估 - 亚马逊基岩 AgentCore

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

获取在线评估

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

使用此 API 监控配置的生命周期状态(ACTIVE、、CREATING、CREATE_FAILED、UPDATINGUPDATE_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 和 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. 打开亚马逊 Bedrock AgentCore 控制台。

  2. 在导航窗格中,选择评估。

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

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