# 更新在线评估
<a name="update-online-evaluations"></a>

`UpdateOnlineEvaluationConfig`API 修改现有的在线评估配置，允许您更改评估器、数据源、执行设置和其他参数。此操作可以智能地处理更新，而不会中断正在运行的评估。

只有当您的评估配置处于、或`ERROR`状态时 `ACTIVE``UPDATE_FAILED`，才能进行更新。如果当前正在创建、更新或删除配置，则会收到冲突错误，应在操作完成后重试。

## 执行控制
<a name="execution-control"></a>

执行状态参数控制您的在线评估配置是否主动处理代理跟踪。了解这些状态有助于您管理评估成本和绩效。
+  **启用评估**-从 “已禁用” 更改为 “启用” 时，系统会配置服务以开始处理来自您指定数据源的跟踪。
+  **禁用评估**-从 “启用” 更改为 “禁用” 时，系统会停止处理新的跟踪，同时保留您的配置以备将来使用。

## AgentCore CLI、 AgentCore SDK 和 AWS SDK
<a name="update-online-evaluations-code-samples"></a>

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

**Example**  

1. 要 AgentCore 使用 CLI 更新在线评估配置，请直接编辑`agentcore.json`文件中的配置，然后重新部署：

   ```
   agentcore deploy
   ```

   打开`agentcore.json`，在`onlineEvalConfigs`阵列中找到配置，修改其设置，然后运行`agentcore deploy`。在您部署之前，更改不会生效。

   ```
   # Pause a running online evaluation
   agentcore pause online-eval "your_config_name"
   
   # Resume a paused online evaluation
   agentcore resume online-eval "your_config_name"
   ```
**注意**  
配置必须处于`ACTIVE``UPDATE_FAILED`、或`ERROR`生命周期状态，然后才能对其进行更新。
**注意**  
要控制评估作业是否正在运行 (`ENABLED`/`DISABLED`)，请使用`agentcore pause online-eval`和`agentcore resume online-eval`。
**注意**  
在 AgentCore 项目目录（使用创建`agentcore create`）中运行它。

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}")
   
   # update description
   eval_client.update_online_config(
       config_id=config_id,
       description="Updated description for online evaluation"
   )
   print("✅ Description updated")
   ```

1. 

   ```
   import boto3
   
   client = boto3.client('bedrock-agentcore-control')
   
   update_config_response = client.update_online_evaluation_config(
       onlineEvaluationConfigId='your_config_id',
       description="Updated description for online evaluation"
   )
   ```

1. 

   ```
   aws bedrock-agentcore-control update-online-evaluation-config \
       --online-evaluation-config-id your_config_id \
       --description "Updated description for online evaluation"
   ```

## 控制台
<a name="update-online-evaluations-console"></a>

使用控制台的编辑界面修改您的在线评估配置设置，该界面提供表单验证和指导配置选项。

 **更新在线评估配置** 

1. 打开 Amazon Bedrock AgentCore 控制台。

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

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

1. 选择以下方法之一来更新配置：
   + 选择评估配置名称以查看其详细信息，然后在详细信息页面的右上角选择**编辑**。
   + 选择评估配置使其突出显示，然后选择**评估配置**卡顶部的**编辑**。

1. 根据需要更新字段。

1. 选择 “**更新评估配置**” 以保存更改。