Hindsight 入门：Agent 跨会话记忆到底保存了什么
Hindsight 架构：一条记忆如何进入、找回并参与回答
先画清 bank 内的数据路径，再评价相关性、时效性和隔离性。
Hindsight 架构：一条记忆如何进入、找回并参与回答知识学习CN编辑简报更新 2026-09-26
你将学会
- retain 不等于追加一行文本
- recall 会合并多路候选
- reflect 的输出契约不同
开始前需要
- Python 客户端基础
- 合成记忆测试样例和明确的部署边界
保存更正、误召回和费用，让下一次测试能重现同样的问题。
先看结论
- 写入可生成派生表示。
- 排序受多条检索路径影响。
- reflect 输出是需要核验的解释。
retain 不等于追加一行文本
README 说明 retain 会用模型提取事实、时间、实体与关系，然后规范化为搜索表示。看似简单的写入因而有模型成本，也可能把输入解释成不同含义。检查意外记忆时应保留原始语句。
世界事实与 Agent 经历在概念上走不同路径。观察汇总多条记忆，心理模型刷新固定问题的答案。若业务对时效要求高，需要测量这些派生结果何时可读。
recall 会合并多路候选
项目文档描述了语义、BM25 关键词、图关系和时间检索，再进行融合、重排和 token 限额裁剪。榜首答案不仅受存储内容影响，也取决于查询参数；测试记录要保留查询和限制条件。
日期问题和具名实体问题会触发不同检索路径。应分别测试，并加入一条互相冲突的更新。结果不对时，先核对来源和时间戳，再调整最后的提示词。
reflect 的输出契约不同
reflect 会结合 bank 内容与预设倾向生成综合回答。项目风险总结可能用得上，但如果结论会影响决策，就需要能追到原始记录。人工核对前应把它视为解释。
本次检查了记忆引擎与 Python 客户端，但没有走查每个解析器、后台任务和数据库查询。图示将未审计部分标为文档描述，不把局部源码阅读包装成完整架构审计。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
追踪一次 retain 从输入到保存证据。
- 2
分别测试语义与时间问题。
- 3
为 reflect 的结论要求原始依据。
可复制示例
text
retain -> fact extraction -> bank storage
recall -> semantic | keyword | graph | temporal -> rerank
reflect -> retrieved evidence -> synthesized answer常见问题
更新后的事实为何不一定立刻出现？
观察与心理模型可能在后台刷新，应检查操作状态和实际读取路径。
bank 能保证租户安全隔离吗？
仓库描述了隔离设计，仍要按自身威胁模型验证授权和部署控制。
资料来源
- Hindsight / README.md来源核查 2026-09-26
- Hindsight / hindsight-api-slim/hindsight_api/engine/memory_engine.py来源核查 2026-09-26