

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

# 更新评估器
<a name="update-evaluator"></a>

`UpdateEvaluator`API 修改现有自定义评估器的配置、描述或评估级别。此异步操作仅允许在未锁定的评估器上执行。

 **修改锁保护：如果任何启用的评估配置已使用评估器，则不允许**更新。

API 会立即返回更新后的元数据。使用 `GetEvaluator` API 监控评估器状态以确认更改已成功应用。

**Topics**
+ [AgentCore SDK 和 SDK 的代码示例 Amazon SDK](#update-evaluators-code-samples)
+ [控制台](#update-evaluator-console)

## AgentCore SDK 和 SDK 的代码示例 Amazon SDK
<a name="update-evaluators-code-samples"></a>

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

**Example**  

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

   ```
   agentcore deploy
   ```

   打开`agentcore.json`，在`evaluators`数组中找到评估器，修改其配置，然后运行`agentcore deploy`。在部署之前，更改不会生效。
**注意**  
如果评估器被正在运行的在线评估锁定，则必须先暂停在线评估，`agentcore pause online-eval`然后才能进行更改，或者改为克隆评估器。部署更改后，使用继续进行在线评估`agentcore resume online-eval`。
**注意**  
在 AgentCore 项目目录（使用创建`agentcore create`）中运行它。

1. 

   ```
   from bedrock_agentcore_starter_toolkit import Evaluation
   
   eval_client = Evaluation()
   
   eval_client.update_evaluator(
           evaluator_id=evaluator_id,
           description="Updated custom evaluator description"
       )
   ```

1. 

   ```
   import boto3
   
   client = boto3.client('bedrock-agentcore-control')
   
   list_configs_response = client.update_evaluator(
       evaluatorId=evaluator_id,
       description="Updated custom evaluator description"
   )
   ```

1. 

   ```
   aws bedrock-agentcore-control update-evaluator \
       --evaluator-id 'evaluator-abc123' \
       --description "Updated custom evaluator description"
   ```

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

使用控制台的编辑界面修改您的自定义评估器设置，该界面提供表单验证和引导式配置选项。

 **更新自定义评估器 ** 

1. 打开亚马逊 Bedrock AgentCore 控制台。

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

1. 选择评估配置**旁边的**自定义评估器。

1. 在**自定义评估器**卡中，查看列出您创建的自定义评估器的表格。

1. 选择以下方法之一来更新自定义评估器：
   + 选择自定义评估器名称以查看其详细信息，然后**在详细信息页面的右上角选择**编辑。
   + 选择自定义评估器使其突出显示，然后选择 “自定义评估器” 卡**顶部的 “**编辑”。
**注意**  
如果在任何在线评估中使用了评估器，则无法对其进行更新。相反，您可以复制评估器并更新克隆版本。

1. 根据需要更新字段。

1. 选择 “**更新赋值器” ** 以保存更改。