View a markdown version of this page

更新在线评估 - Amazon Bedrock AgentCore
执行控制AgentCore CLI、 AgentCore SDK 和 AWS SDK控制台

更新在线评估

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

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

执行控制

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

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

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

AgentCore CLI、 AgentCore SDK 和 AWS 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")
AWS 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"
)
AWS CLI

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

控制台

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

更新在线评估配置

  1. 打开 Amazon Bedrock AgentCore 控制台。

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

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

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

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

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

  5. 根据需要更新字段。

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