分析轨迹特征

适用范围与前提条件

当前页面提供工具、技能、记忆和文件四类特征。使用前需确认当前环境已开放相应特征加工与查询能力，且资源中已有事件数据。

查询事件

1. 打开目标 SessionStore，选择“轨迹特征”。

2. 设置时间范围，先选择“特征列表”查看事件。

3. 按需要设置类型、Agent、模型和状态，或在查询框输入检索条件。

4. 使用查询框时单击“查询 / 分析”；结构化筛选项变更会触发更新。

5. 在结果中打开事件，查看详情与证据。

以下示例用于查找一个工具的事件，要求当前数据具备对应字段。

event_type:"tool" AND agent_tool_name:"search_order"

查询某条轨迹的事件可使用：

trajectory_id:"demo-trajectory-001"

说明：特征字段与轨迹列表字段并不完全相同。例如工具事件名称使用 agent_tool_name，轨迹中的工具集合使用 tool_names。请先查看“事件 JSON”或查询分析属性，核对实际字段。特征中的 Agent 表示事件所属节点，不一定是轨迹的代表 Agent。

切换结果组织方式

特征列表支持以下组织方式。

汇总结果可按事件数、失败数等方式排序。明细和汇总均可分页，当前提供 20、50、100 条的每页选项。

候选筛选项旁的计数与正式结果可能采用不同范围，不应作为精确总量。判断匹配事件数时，以提交查询后的结果为准。

查看日志视图

需要检查事件记录的具体字段时，切换到“日志视图”，确认时间范围和查询条件后重新查询。这里查询的是加工后的特征事件，不是应用的 Raw 原始日志；事件存在多个版本时，日志条数可能与特征列表的去重事件数不同。

不同展示方式可能保留各自的查询状态，切换后请重新核对条件。

查看聚合报表

切换到“聚合报表”，查看当前时间和筛选条件下的事件统计，例如总事件、关联轨迹、工具事件、失败事件，以及类型、状态、工具、Agent、模型和文件等分布。

报表统计不是对当前可见列表页简单求和。排名图可能只显示前若干项，未出现的对象不代表没有事件。

注意以下范围差异：

• 趋势以事件记录时间组织，不应直接当作业务动作实际发生时间的分布。

• 从分组结果下钻后再切换报表，请重新核对筛选条件，不要假设分组限定自动成为报表条件。

• 当前报表不提供仪表盘模板选择或编辑，不要将其当作可自由编排的完整仪表盘。

从事件查看执行证据

1. 在事件列表中打开一条事件。

2. 在“详情”中查看事件类型、名称、状态和相关标识。

3. 在“证据”中查看可用内容，并按页面提供的入口定位执行步骤或打开原始轨迹。

4. 需要核对完整字段时，查看“事件 JSON”。

同一次工具调用可能同时关联文件、技能或记忆事件。可以结合关联事件理解一次操作，但不能将它们全部相加后当成工具调用次数。

事件证据需要对应版本的轨迹记录。若页面提示证据缺失、目标版本不存在或无权访问，不应使用另一个较新版本替代后得出历史结论。

正确理解事件状态和更新

特征查询先在当前时间和条件中筛选，再对命中的事件选择较新的版本。例如按错误状态查询时，可能命中一条后来已经恢复的历史错误记录。排查“当前是否仍失败”时，请进一步核对更新记录和对应证据。

列表为空或请求失败

列表为空时，先清除筛选并扩大到合理时间范围，再确认是否启用了相应事件加工。技能、记忆等事件没有出现，不能直接证明应用没有相关行为。

如果页面明确报不存在或权限错误，应先处理资源和权限问题，不能将请求失败理解为零事件。报表也不应使用空结果来代替未成功完成的统计。