本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
开始批量评估
启动批量评估,针对多个代理会话运行评估器。该服务从 CloudWatch 日志中发现会话,针对每个会话运行每个评估器,并生成汇总结果。
代码示例
例
请求参数
| 参数 | Type | 必需 | 描述 |
|---|---|---|---|
|
|
字符串 |
是 |
批量评估作业的名称。模式:以字母、字母数字和下划线开头,最多 48 个字符。 |
|
|
对象 |
是 |
在哪里可以找到代理会话。使用代理的服务名称和确切的日志组名称或日志组名称前缀指定 |
|
|
列表 |
是 |
评估人员名单。每个条目都有一个 |
|
|
对象 |
否 |
包含 |
|
|
对象 |
否 |
每个会话结果和分数指标的可选 CloudWatch 目的地。指定 a |
|
|
字符串 |
否 |
等效性标记。如果您使用相同的客户端令牌重试请求,该服务将返回现有任务,而不是创建新任务。 |
会话来源
该dataSourceConfig参数指定服务发现代理会话的 CloudWatch 日志位置。
必填字段
| 字段 | Type | 说明 |
|---|---|---|
|
|
字符串列表(正好是 1) |
用于识别您的代理在中的痕迹的服务名称 CloudWatch。公约: |
|
|
字符串列表 (1—5) |
选择输入日志组的一种方法。指定存储代理遥测数据的确切 CloudWatch 日志组名称。与 |
|
|
字符串列表 (1—5) |
选择输入日志组的一种方法。该服务会发现名称以其中一个前缀开头的每个日志组的会话,因此系统会自动选取新创建的匹配日志组。与 |
请仅指定logGroupNames或中的一个logGroupNamePrefixes。在这两种情况下,serviceNames都需要在所选日志组中识别代理的跟踪。
如果您使用logGroupNamePrefixes来匹配 Amazon Bedrock AgentCore 运行时日志组,请确保您的运行时将跨度发送到代理自己的日志组。对于仍在使用共享aws/spans日志组的代理,请在运行时UNIFIED_TRACES_DESTINATION_ENABLED=true进行设置。有关更多信息,请参阅 Amazon Bedrock AgentCore 运行时中托管的代理的跨度目标。
# Match input log groups by prefix instead of exact names dataSourceConfig={ "cloudWatchLogs": { "logGroupNamePrefixes": ["/aws/bedrock-agentcore/runtimes/MyAgent-"], "serviceNames": ["MyAgent.DEFAULT"] } }
可选字段
| 字段 | Type | 说明 |
|---|---|---|
|
|
字符串列表 |
仅评估这些特定的会话 ID。省略时,该服务会发现日志组中的所有会话。 |
|
|
ISO 8601 日期时间 |
筛选在此时间之后创建的会话。 |
|
|
ISO 8601 日期时间 |
筛选在此时间之前创建的会话。 |
结果输出
默认情况下,批量评估结果将转到由服务管理的专用日志组。outputConfig.cloudWatchConfig用于控制每个会话结果的写入位置以及哪些 CloudWatch 指标命名空间接收评估分数。
选择写入结果的位置
-
DEDICATED_LOG_GROUP(默认)-将结果写入专用的结果日志组。如果您未设置logGroupName,则该服务会为您管理群组。要使用自己的群组,请设置logGroupName(参见使用自定义输出日志组)。 -
SOURCE_LOG_GROUP— 将结果写回读取代理跟踪的同一个日志组。当你使用这个值时,不要设置logGroupName。
使用自定义输出日志组
对于DEDICATED_LOG_GROUP,设置logGroupName为将结果写入您选择的日志组。现有日志组按原样使用;如果不存在,则服务会创建该日志组,这需要执行角色授权logs:CreateLogGroup。除了服务管理的默认组外,该名称不能位于服务预留/aws/bedrock-agentcore/evaluations/命名空间下。
# Write results back to the trace source log group outputConfig={ "cloudWatchConfig": { "resultDestination": "SOURCE_LOG_GROUP" } } # Write results to a custom dedicated log group outputConfig={ "cloudWatchConfig": { "resultDestination": "DEDICATED_LOG_GROUP", "logGroupName": "/my/team/batch-evaluation-results" } }
将指标发布到自定义命名空间
设置metricsNamespace为在自己的 CloudWatch 命名空间下发布分数指标,而不是Bedrock-AgentCore/Evaluations。该值不能以此开头AWS/。
outputConfig={ "cloudWatchConfig": { "metricsNamespace": "MyTeam/Evaluations" } }
响应
| 字段 | Type | 说明 |
|---|---|---|
|
|
字符串 |
批量评估的唯一标识符。 |
|
|
字符串 |
批量评估的 ARN。 |
|
|
字符串 |
你指定的名字。 |
|
|
字符串 |
初始状态。其中之一: |
|
|
列表 |
使用的评估人员。 |
|
|
Timestamp |
创建任务的时间。 |
|
|
对象 |
CloudWatch 每个会话结果和分数指标的目的地。 |
错误
| 错误 | HTTP 状态 | 说明 |
|---|---|---|
|
|
400 |
请求参数无效。检查字段限制和必填字段。 |
|
|
403 |
权限不足。验证 IAM 策略。 |
|
|
409 |
已经存在具有相同客户令牌且参数不同的批量评估。 |
|
|
429 |
超出请求速率。使用指数回退进行重试。 |
|
|
500 |
Service-side 错误。重试请求。 |