当记忆没有生成、检索结果不符合预期，或需要了解使用情况时，可以结合记忆库的概览、审计明细和统计报表检查输入、抽取、存储与召回过程。
检查数据源是否正常消费
进入记忆库概览，检查来源类型、过滤条件、消费状态、进度和最近错误。
手动写入：先检查写入接口响应；存在写入事件日志时，通过写入事件查看输入。
Agent 轨迹：检查当前空间是否有符合服务名、Agent 名称、步数和起始时间等条件的轨迹。
Dataset：检查绑定的数据集、版本策略和过滤条件，确认字段仍符合
MemorySourceV1。
轨迹或 Dataset 来源可以通过暂停消费、恢复消费控制后续读取。页面显示库已创建或没有最近错误，并不能单独证明某条输入已经生成长期记忆；继续检查抽取和存储结果。
查看审计明细
进入目标记忆库的审计明细页签。
选择要检查的时间范围，并按事件类型筛选。
结合输入来源、记忆标识、召回事件 ID 或错误信息定位相关事件。
审计可以帮助区分：输入已进入处理、抽取未产生事实、存储执行了新增或更新、记忆被跳过或进入待审核，以及一次召回成功、失败或返回为空等情况。
审计日志与业务处理异步到达。刚完成操作时查不到记录，应结合时间范围、筛选条件和稍后的查询结果判断。
追踪一次召回
在长期记忆检索页面得到召回事件 ID 后，可以进入对应审计记录。也可以在统计报表 > 最近召回中打开单次召回明细。
重点检查：
信息 | 用途 |
查询文本和业务范围 | 确认查询是否针对预期的用户、Agent、应用或运行 |
状态、错误码和耗时 | 区分正常空结果与执行失败 |
返回条数、排名和分数 | 确认哪些记忆返回给了调用方 |
返回内容和修订 | 核对当次返回了哪个版本的记忆 |
丢弃阶段 | 开启相关记录后，分析候选在哪个环节未被保留 |
当 query 配置为仅记录 HMAC时，页面不会显示查询原文。出现审计降级或内容截断提示时，应按提示理解该条记录的完整性，不要将缺少明细解释为没有发生召回。
阅读统计报表
指标或视图 | 含义与使用方式 |
召回次数 | 按召回事件去重后的次数，结合时间范围观察请求量 |
非空召回率 | 成功召回中返回至少一条结果的比例；应结合结果质量判断 |
P95 时延 | 召回耗时的 95 分位数，用于观察高延迟情况 |
平均返回条数 | 观察每次召回返回的记忆数量 |
抽取条数 | 成功抽取的输入行数，不等同于最终新增的长期记忆条数 |
记忆总数 | 查看当前记忆规模 |
召回漏斗 | 比较候选、阈值过滤后、重排后和最终返回的数量 |
抽取漏斗 | 比较拉取、入队、抽取成功、写入及跳过或待审核的情况 |
Top 被召回记忆 | 了解哪些记忆被频繁返回 |
零召回 query | 找出反复没有结果的查询，检查范围、输入覆盖和策略 |
最近召回 | 从趋势下钻到具体请求 |
先选定同一时间范围，再比较趋势和单次请求。抽取漏斗按记忆库汇总，不应把召回类型、召回状态等筛选项误认为对抽取数据也生效。
非空召回率衡量是否返回记忆。要评估记忆是否改善了 Agent 回答，还需要检查应用是否采用返回内容，并结合实际任务效果判断。
常见排查路径
现象 | 建议检查顺序 |
没有产生新记忆 | 来源是否有数据 → 起始位置与过滤条件 → 抽取结果 → 分类或排除规则 → 存储动作 |
新信息没有覆盖旧信息 | 是否为事件追加模式 → 合并条件与允许动作 → 是否触发人工编辑保护 |
有记忆但查询为空 | 库与地域 → 业务 ID 是否一致 → 附加筛选 → 查询语句与阈值相关记录 |
非空召回率下降 | 是否新增了业务流量或查询类型 → 业务范围与记忆覆盖 → 零结果查询和单次明细 |
报表无数据 | 时间范围与筛选 → 空间关联的日志资源及访问权限 → 审计是否已经到达 |
需要调整抽取、存储或审计记录方式时，参见配置记忆抽取与存储策略。