本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
创建在线评估
CreateOnlineEvaluationConfigAPI 创建了一个新的在线评估配置,该配置可使用实时流量持续监控您的代理的表现。此异步操作告诉服务对正常操作期间生成的代理跟踪进行评估。
要创建在线评估,请提供唯一的配置名称,选择要监控的内容,选择最多 25 个评估者,并提供 IAM 服务角色 ARN 以供执行。数据源可以是 CloudWatch 日志(按确切的日志组名称或日志组名称前缀选择),也可以是代理端点。必需的enableOnCreate参数控制初始配置executionStatus:在中true启动配置ENABLED,然后在中false启动配置DISABLED。
执行状态控制
该executionStatus参数决定评估任务是否主动处理跟踪:
-
已启用-评估作业持续运行,处理传入的跟踪并生成评估结果。
-
已禁用-评估配置存在,但作业已暂停。未处理或评估任何痕迹。
您可以使用 CLI 控制执行状态:
# Pause a running online evaluation agentcore pause online-eval "your_config_name" # Resume a paused online evaluation agentcore resume online-eval "your_config_name"
选择输入日志组
如果您的数据源是 CloudWatch Logs,请完全dataSourceConfig.cloudWatchLogs按照以下方式之一进行配置:
-
logGroupNames— 提供日志组名称的明确列表。 -
logGroupNamePrefixes— 提供 1—5 个日志组名称前缀。该服务会评估来自名称以其中一个前缀开头的任何日志组的跟踪,包括稍后创建的匹配日志组。
无论哪种情况,都要进行设置,serviceNames使服务可以在所选日志组中识别代理的跟踪。
如果您使用logGroupNamePrefixes匹配 Amazon Bedrock AgentCore 运行时日志组,请确保您的运行时将跨度发送到代理自己的日志组。对于仍在使用共享aws/spans日志组的代理,请在运行时UNIFIED_TRACES_DESTINATION_ENABLED=true进行设置。有关更多信息,请参阅 Amazon Bedrock AgentCore 运行时中托管的代理的 Span 目标。
# Match input log groups by prefix instead of exact names dataSourceConfig={ "cloudWatchLogs": { "logGroupNamePrefixes": ["/aws/agentcore/my-agent-"], "serviceNames": ["my_agent.DEFAULT"] } }
有关结果和分数指标的写入位置(包括专用日志组、自定义日志组和源日志组)的更多信息,请参阅结果和输出。
评估者保护
当您创建executionStatus设置为的评估配置时ENABLED,系统会自动锁定您选择的所有自定义赋值器。锁定后:
-
不允许修改-您无法更新评估者的配置、提示或设置。如果需要进行更改,请克隆一个新的赋值器。
-
不允许删除-当任何评估作业正在使用赋值器(正在运行)时,您无法将其删除。
AgentCore CLI、 AgentCore SDK 和 Amazon SDK
以下代码示例演示了如何使用不同的开发方法创建在线评估配置。选择最适合您的开发环境和偏好的方法。
例
控制台
您可以使用 Amazon Bedrock AgentCore 控制台的可视界面创建在线评估配置。此方法提供指导表单和验证,以帮助您配置评估设置。
创建 AgentCore 在线评估
-
打开 Amazon Bedrock AgentCore 控制台。
-
在左侧导航窗格中,选择 “评估”。
-
选择创建评估配置。
-
(可选)在评估名称中,输入在线评估配置的名称。
-
(可选)要在创建评估配置后将其启用,请选中评估名称下方的复选框。
-
(可选)在评估配置描述中,输入 AgentCore 评估配置的描述。
-
(可选)对于会话空闲超时,请输入介于 1 到 60 分钟之间的持续时间。默认为 15 分钟。
-
-
对于数据源,请选择以下选项之一:
-
使用代理端点定义-选择您之前在 AgentCore Runtime 上创建的代理,或者通过选择代理来创建新代理。然后,从代理中选择一个端点。
-
选择一个 CloudWatch 日志组-最多选择 10 个日志组。输入您的代理为了便于观测而使用的服务名称。对于托管在 AgentCore Runtime 上的代理,服务名称遵循以下格式<agent-runtime-name>。 <agent-runtime-endpoint-name>。对于在运行 AgentCore 时之外运行的代理,服务名称是在 OTEL_RESOURCE_ATTRIBUTIES 环境变量中配置的。
-
-
对于评估者,每个评估配置最多可选择 25 个赋值器,包括内置和自定义赋值器。
-
(可选)对于筛选器,最多添加 5 个过滤器以确定要评估哪些会话。
-
(可选)对于采样,选择介于 0.01% 和 100% 之间的百分比以控制评估的会话百分比。默认值为 10%。
-
对于 Amazon Bedrock IAM 角色,请选择以下选项之一:
注意
如果您的账户中启用了角色管理器,则会为您 AgentCore 附加角色,此处描述的角色选择步骤将替换为 “自定义” 选项。要使用其它角色,请选择自定义。有关更多信息,请参阅《IAM 用户指南》中的 IAM 角色创建。
-
使用现有角色-选择已具有所需权限的 IAM 服务角色。
-
创建新角色-创建新的 IAM 服务角色。
-
-
选择创建评估配置以创建 AgentCore 在线评估配置。