View a markdown version of this page

更新在线评估 - Amazon Bedrock AgentCore
执行控制AgentCore CLI、 AgentCore SDK 和代码示例 Amazon SDK控制台
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

更新在线评估

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

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

执行控制

执行状态参数控制您的在线评估配置是否主动处理代理跟踪。了解这些状态有助于您管理评估成本和绩效。

  • 启用评估 -从 “禁用” 更改为 “启用” 时，系统会配置服务以开始处理来自指定数据源的跟踪。

  • 禁用评估 -从 “启用” 更改为 “禁用” 时，系统将停止处理新跟踪，同时保留您的配置以备将来使用。

AgentCore CLI、 AgentCore SDK 和代码示例 Amazon SDK

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

例
AgentCore CLI

  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"
    注意

    配置必须处于ACTIVEUPDATE_FAILED、或ERROR生命周期状态才能更新。

    注意

    要控制评估作业是否正在运行 (ENABLED/DISABLED)，请使用agentcore pause online-eval和agentcore resume online-eval。

    注意

    在 AgentCore 项目目录（使用创建agentcore create）中运行它。

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}")

# update description
eval_client.update_online_config(
    config_id=config_id,
    description="Updated description for online evaluation"
)
print("✅ Description updated")
Amazon SDK

  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"
)
Amazon CLI

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

控制台

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

更新在线评估配置

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

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

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

  4. 选择以下方法之一来更新配置：

    • 选择评估配置名称以查看其详细信息，然后在详细信息页面的右上角选择编辑。

    • 选择评估配置使其突出显示，然后选择评估配置卡顶部的 “编辑”。

  5. 根据需要更新字段。

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