Hindsight 记忆可视化：3 个视图看清 Agent 记住的东西

Hindsight 记忆可视化3 个视图看清 Agent 记住的东西【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight先从一个真实的排查场景说起用户问它上次为什么没记住我的部署环境你只能反复跑 recall、翻提示词却始终说不清那个 memory bank 里到底形成了什么样的结构——哪些实体连在了一起哪些事实孤零零地躺着。这类记忆问题往往是结构性的靠单条召回结果很难看出来。Hindsight 的记忆可视化能力就是为此设计的在控制平面Control Plane里你可以把整个 bank 渲染成一张可缩放、可交互的关系图直接检查记忆的拓扑结构而不是猜测。启动服务并进入可视化界面最短路径只有三步一条命令启动服务docker run -p 8888:8888 -p 9999:9999 -it --name hindsight vectorize/hindsight浏览器打开http://localhost:9999这是控制平面 UI 的入口API 在 8888 端口。在顶栏选中一个 bank左侧导航就出现了 Home、Memories、Entities 等页签——可视化功能分布在其中。按什么顺序读这三张图打开界面后建议按先看形态、再看类型、最后看细节的顺序读Home 页顶部有一张全局概览星图节点按事实类型着色——world紫、experience粉、observation靛蓝、entity青。注意这张图默认只取 200 个节点它是扫一眼有没有大 hub、有没有孤岛的仪表盘不是完整图。Memories 页默认就是星座视图Constellation View提供 table / timeline / constellation 三种模式切换。这里能看到全量记忆节点连线按关系类型着色语义蓝、时间青绿、实体琥珀、因果紫节点越亮代表连接数越多hub 一眼可见。Entities 页显示实体共现图Co-occurrence Graph回答的是另一个问题——哪些实体经常一起出现在同一条记忆里而不仅是类型化的关联关系。看到什么算正常有几团彼此独立、内部密集的簇簇间少量连线说明结构健康。如果整张图挤在中间一团或者全是孤点先别急着下结论——悬停任意节点会弹出文本、关联实体、时间、标签与证据数点进去还能打开完整记忆详情。图给你地图悬停细节才给你地面真相。稳定布局为什么每次打开长得一样很重要这套星图最容易被忽略、但最实用的机制是确定性布局节点位置由 id 哈希推导同一个 bank 每次打开位置都一致。这意味着你可以把它当前后对比工具用——比如收紧retain_mission让保留规则少抓废话之后重开同一个 bank问三个问题噪声 hub 变弱了吗目标簇变密了吗之前断开的区域连上了吗如果布局每次随机重排这类对比就无从谈起。参数与取舍调图之前确认什么实体共现图有两个值得调的参数对应控制平面的/api/entities/graph端点底层是getEntityGraph请求limit返回的实体数量上限界面默认取 2000大 bank 下适当调低可以先看骨架。min_count实体参与共现的最小次数默认 1。提高到 2 能滤掉只出现过一次的低频噪声看稳定的组合关系。Memories 页的星座视图还支持按 scope标签组聚类相同标签集合的节点会被包进半透明的色块里每个标签组一种颜色方便判断某类 observation 是否成团。边界与常见坑图只给人看不改召回。Constellation View 不会让 agent 检索得更好它不替代限定好范围的 bank 和可靠的提取规则。密集的图不等于好的记忆。过度提取泛化实体时图会看起来更丰满检索却更不精准。用图提出假设再用 recall 验证。孤立区域可能是数据问题。如果某簇没形成可能是源材料缺少时间信号、retain 任务写得太宽泛、或实体归一化没做好而不是界面没画出来。高扇出实体要谨慎。连接一切的万能 hub可能真是组织性概念也可能相当于记忆里的停用词下结论前先悬停看它挂的记忆。首页概览星图有 200 节点上限超过这个规模的 bank 要看全貌请切到 Memories 页。这套可视化适合正在调试结构性记忆问题、或需要向同事解释agent 到底记了什么的新手和开发者。想往深处走可以看官方对星座视图的介绍 hindsight-docs/blog/2026-04-16-constellation-view.md或对照保留策略文档 hindsight-docs/docs/developer/retain.md把图和提取规则结合起来用收益最大。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考