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

# AgentCore 见解：通过模式分析对代理故障进行分类
<a name="insights"></a>

**Insights 创造就业机会将于 2026 年 10 月 16 日结束**  
从 2026 年 10 月 16 日起，Amazon Bedrock AgentCore 见解不再支持创建新的批量或重复的见解。在 2026 年 10 月 30 日之前，现有的定期洞察任务将继续处理会话并生成报告。从 10 月 31 日起，现有的反复出现的见解也将停止生成报告。历史批次结果和反复出现的见解报告仍然可用。  
此更改是 Insights 重新设计的一部分。全新 Insights 体验即将推出。

**注意**  
AgentCore 见解处于公开预览阶段。功能和 API 可能会在正式发布之前发生变化。

**注意**  
在使用亚太地区（首尔）（ap-northeast-2）、亚太地区（孟买）（ap-southeast-1）或亚太地区（新加坡）（ap-southeast-1）的 AgentCore 见解时，该服务使用基岩全球跨区域推理配置文件。您的请求可能会被发送到个人资料中的任何目标 Amazon 区域。即使您没有选择加入这些区域，或者服务控制策略明确拒绝在这些区域中进行推理，也可能发生这种路由。输入提示和输出结果可能会存储在这些目标区域中，以进行滥用检测。

Amazon Bedrock AgentCore 见解会分析您的代理会话，以识别故障模式、提取用户意图并总结执行行为。Insights 通过提供超出[AgentCore 评分范围的分类分析来扩展评估](evaluations.md)范围——它可以告诉你代理失败*的原*因以及你的用户想要完成*什么*。

AgentCore 见解提供了三种分析类型：
+  **失败分析：**识别代理会话中的故障，使用详细的分类（工具错误、幻觉、错误推理、重复行为等）对其进行分类，将根本原因追溯到特定的跨度，并提供修复建议。
+  **用户意图提取：**提取用户在每个会话中尝试完成的内容，然后将相似的意图聚集在一起，向您展示代理处理的最常见用例。
+  **执行摘要：**汇总代理采取的方法和每个会话的结果，然后对相似的执行模式进行聚类以揭示您的代理通常如何解决问题。

在每个会话分析之后，服务集群会生成跨会话的结果，以显示重复出现的模式。对于故障分析，这将生成一个三级层次结构：故障类别 → 子类别 → 根本原因群集，每个群集都有受影响的会话、解释和补救建议。

## 洞察是如何触发的
<a name="insights-trigger-modes"></a>

可以通过两种方式触发洞察分析：
+  **一次通过批量评估：**致电`StartBatchEvaluation``insights`以在一定时间范围内的会话中运行分析。结果通过返回`GetBatchEvaluation`。
+  **通过群集计划重复：**`ClusteringConfig`在您的在线评估配置上配置一个或多个频率（`DAILY``WEEKLY`、或`MONTHLY`）。该服务按配置的节奏自动触发批量评估作业。您还可以在定期计划中创建自定义报告，以固定到特定的日期和时间。

Per-session 通过配置见解时，洞察分析会自动运行 CreateOnlineEvaluationConfig，但是表面模式的聚类结果只能在批量评估作业中生成。

## 从分类到优化
<a name="insights-to-optimization"></a>

AgentCore 洞察力与[AgentCore 优化](optimization.md)相结合，以结束改进循环。在洞察确定失败模式和根本原因后，您可以将这些发现输入建议 API，以生成经过改进的系统提示来解决已分类的问题。这会将诊断输出转化为可操作的配置更改：

1.  **分类：**运行见解以确定反复出现的故障类别和根本原因。

1.  **生成建议：**`StartRecommendation`使用您当前的系统提示呼叫，然后将其指向相同的代理跟踪。该服务会生成推荐的系统提示符，并说明其更改内容。

1.  **验证：**使用[A/B 测试](ab-testing.md)将原始配置和推荐配置与实时流量进行比较。