ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Hindsight 记忆可视化实战指南:三步看清 AI Agent 记忆网络

Hindsight 记忆可视化实战指南:三步看清 AI Agent 记忆网络 Hindsight 记忆可视化实战指南三步看清 AI Agent 记忆网络【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsightHindsight 是一个面向 AI 代理的记忆系统主打学习而不只是记住。它的记忆可视化功能把库里堆存的几十条事实变成一张可缩放、可交互的星座图记忆是节点实体与时间关系是连线不用写 SQL 就能直接看到记忆网络长什么样、检索到底在哪一环出错。下面直接看怎么用。 它到底在解决什么问题代理答错话的时候你分不清是从没存进去还是存了但没召回。记忆库涨到几万条事实后逐条翻 API 响应根本不现实。实体抽取跑完后两条记忆该连没连、不该连却连上了肉眼根本发现不了。这三个问题靠猜没有意义得有个能直接看网络结构的地方——这就是 Hindsight 控制面板里星座视图和实体视图存在的意义。⚡ 最快上手路径用 Docker 起一个带控制面板的服务8888 是 API9999 是网页端export OPENAI_API_KEYsk-xxx docker run -p 8888:8888 -p 9999:9999 \ -e HINDSIGHT_API_LLM_API_KEY$OPENAI_API_KEY \ -v hindsight-data:/home/hindsight/.pg0 \ ghcr.io/vectorize-io/hindsight:latest浏览器打开http://localhost:9999进入某个记忆库bank。首页就能看到 Memory constellation 面板想深入分析切到 Entities 视图在 relations关系图和 list表格两种模式间切换。点击任意节点打开记忆详情再用客户端跑一次 recall 对照效果from hindsight import Hindsight client Hindsight(base_urlhttp://localhost:8888) 核心能力拆解原文按视图罗列功能点这里换个角度按你要回答什么问题来分。星座视图一眼定位记忆网络的中心与孤岛缩放拖拽的画布滚轮缩放、拖动平移节点即记忆单元连线是实体、语义或时间上的关联Hover 与点击悬停查看实体的连接情况点击节点弹出记忆详情含文本、实体与时间信息按事实类型聚类着色同一类事实自动聚成一片密集区就是记忆中心孤立点就是没人连的孤儿记忆导出 SVG一键把当前网络状态存成hindsight-constellation.svg方便贴进周报或工单你得到的是不用跑任何查询就能判断网络是星型、团块还是碎片调试检索问题有了第一张地图实体关系视图从单个实体出发的溯源工具实体清单分页浏览按提及次数排序看谁才是库里真正的核心人物/对象关系模式以该实体为锚点拉出关联记忆构成的局部图看它和谁纠缠在一起时间线模式把挂在这个实体下的全部记忆按发生时间铺开矛盾的旧说法和新说法并排出现你得到的是比如查Alice 现在在哪家公司时间线会直接展示新旧两条记录谁覆盖了谁一目了然数据视图与时间线表格党也能用结构化表格不想看图就切 list 模式分页列出记忆字段支持按实体、标签过滤时间线组件同一个实体或文档下的记忆按 occurred 日期排成轴事件顺序和因果先后直接可读与 API 同源视图里看到的数据就是 recall/列表接口返回的结构程序化复现没有障碍你得到的是图看结构、表查细节、时间线定顺序三种读法各取所需 底层是怎么跑的选读可视化只是面子真正让星座图有意义的是底层的召回机制值得花一分钟了解。先说查询一条 query 进来后不会只走一条检索路而是同时拆给四路——语义相似度、BM25 关键词、图遍历、时间窗口各自独立返回一份候选。然后做融合用 RRF倒数排名融合合并四份名单同一条记忆在多路里都排得靠前分数就高相当于多路共识谁的绝对分高反而不重要。最后交给交叉编码器把 query 和每条候选当成一对做精排再叠加三个温和的修正项新近度、时间贴近度、证据数量幅度都压在 ±10% 以内保证精排结果不被次要信号带偏。类比一下四个侦探各走一路侦查开会时谁被多人独立指认谁就是头号嫌疑人。你在星座视图里看到的连线正是图遍历那一路走过的路径。️ 真实场景怎么用当代理答非所问时打开星座视图搜到相关节点看它是孤立的还是连进了网络——孤立说明 retain 时实体没关联上点开实体时间线确认正确事实是否存在、时间戳对不对若图里明明有路径那就是召回侧的问题调高 budget 再试而不是怀疑存储如果你要给记忆库做定期体检找连接数过高的枢纽节点确认它是合理的核心实体还是抽取时产生的脏数据用时间线扫一遍近期矛盾记忆检查合并策略有没有按预期工作把导出的 SVG 存档几个月后对比网络形态变化判断记忆是长结实了还是越来越碎当你要把问题甩给同事排查截图加 SVG 导出对方不用登录你的环境就能看懂网络局部结构附上节点对应的记忆 ID对方直接用列表接口复现沟通成本降到最低涉及 LLM 调用问题时控制面板的 LLM 请求视图还能看到每次调用的时间线和星座图对得上⚠️ 避坑 调优端口别混8888 返回的是 API 文档9999 才是可视化界面开错端口只会看到 JSON。大图先过滤星座图的边数随节点数超线性增长几万条记忆的库直接全量渲染会卡先用时间范围或标签筛出子集再展开。budget 决定图遍历深度多跳问题Alice 经理的团队做过什么要用 high普通对话查询用 low 就够别无脑拉满。标签词表要收口bank 配置里用枚举型标签组比自由文本聚类稳定模型换个说法图就断链了。容器重启要定 Worker ID生产环境给HINDSIGHT_API_WORKER_ID固定值否则重启后正在处理的任务会挂在旧容器名下变成僵尸。 相关资源召回架构详解hindsight-docs/docs/developer/retrieval.mdRecall API 参考hindsight-docs/docs/developer/api/recall.mdx星座视图源码hindsight-control-plane/src/components/constellation.tsx实体视图源码hindsight-control-plane/src/components/entities-view.tsx记忆网络看不见摸不着是调试代理记忆最劝退的一环。Hindsight 把这张网摊在浏览器里让你第一次能用看图的方式谈记忆问题。打开你的项目把第三步的星座图跑出来再回头看那些答错的问题答案多半就挂在某个孤立的节点上。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表