# 获取在线评估
<a name="get-online-evaluations"></a>

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

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

## 生命周期状态
<a name="lifecycle-status"></a>

在线评估配置上的`status`字段报告其生命周期状态，该`executionStatus`字段与控制评估任务是否正在主动处理跟踪的字段是分开的。
+  `ACTIVE`— 配置已完全配置完毕，随时可以使用。
+  `CREATING`— 正在配置配置。请等待它过渡到，`ACTIVE`然后再进行更新或删除。
+  `CREATE_FAILED`— 创建未成功完成。您无法更新处于这种状态的配置；`DeleteOnlineEvaluationConfig`请调用将其删除，然后创建一个新配置。
+  `UPDATING`— 更新正在进行中。等待操作完成后再进行其他更改。
+  `UPDATE_FAILED`— 最新更新不适用。您可以通过`UpdateOnlineEvaluationConfig`再次调用来重试，也可以使用`DeleteOnlineEvaluationConfig`删除配置。
+  `DELETING`— 正在删除配置。
+  `ERROR`— 出现问题，需要您采取措施。检查该`failureReason`字段以确定问题。常见原因包括 IAM 角色访问权限不足、缺少日志组权限和超出服务配额。修复问题后，请`UpdateOnlineEvaluationConfig`致电重试或`DeleteOnlineEvaluationConfig`删除配置。

## AgentCore SDK 的代码示例和 AWS SDK
<a name="get-online-evaluation-code-samples"></a>

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

**Example**  

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']}")
   ```

1. 

   ```
   import boto3
   
   client = boto3.client('bedrock-agentcore-control')
   
   response = client.get_online_evaluation_config(
       onlineEvaluationConfigId='your_config_id'
   )
   ```

1. 

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

## 控制台
<a name="get-online-evaluation-console"></a>

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

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

1. 打开 Amazon Bedrock AgentCore 控制台。

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

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

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