尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

agentmemory demo 命令实战:从示例会话到语义召回的全过程

agentmemory demo 命令实战:从示例会话到语义召回的全过程 agentmemory demo 命令实战从示例会话到语义召回的全过程【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemoryagentmemory 是为 AI 编码智能体打造的持久记忆系统Persistent Memory而它的demo命令是体验记忆召回的最佳入口一条命令种子化 3 个真实感编码会话再自动执行语义搜索30 秒内就能亲眼看到搜数据库性能优化却命中了 N1 查询修复记录这种关键词匹配做不到的智能召回。本文带你完整走完这条 demo 链路。为什么先跑 demo 命令而不是直接上手大多数记忆系统的卖点都靠文档描述但你很难直观感受语义召回和关键词搜索的区别。agentmemory 的设计者显然想通了这一点——README.md 的 Quick Start 章节直接把demo作为官方验收步骤agentmemory demo --serve—— seed sample sessions watch recall find them种子化示例会话并观看召回命中它们也就是说demo 命令不只是一个演示脚本它是官方推荐的安装成功验证 功能教学二合一工具。对新手而言跑通它就等于确认了记忆服务器、索引、搜索三条链路全部正常。一键启动demo --serve 到底做了什么最省事的用法是一条命令搞定一切npx agentmemory/agentmemory demo --serve加--serve时命令内部会依次完成四件事逻辑位于 src/cli.ts 的startServerForDemo与runDemo启动 iii-engine 引擎若本机未运行则拉起并等待 15 秒内就绪启动 agentmemory 记忆服务器REST 服务监听localhost:3111viewer 面板在localhost:3113执行演示主体种子化会话 跑搜索下文拆解自动清理退出演示结束即停掉本次拉起的服务器不留后台进程。如果你更喜欢自己控制服务生命周期也可以双终端操作——终端 1 跑npx agentmemory/agentmemory常驻服务器终端 2 跑不带--serve的agentmemory demo。若服务器没启动demo 会直接报错并提示你如何启动不会静默失败。拆解演示数据3 个会话、6 条观察记录demo 的种子数据由 src/cli.ts 中的buildDemoSessions构造全部是贴近真实开发场景的内容落在一个独立演示项目/tmp/agentmemory-demo下会话主题模拟的工具活动Session 1JWT 鉴权搭建用jose库写中间件为 Edge 兼容放弃 jsonwebtoken、补充 12 个 token 测试并跑通Session 2数据库迁移调试在 Prisma schema 中发现 N1 查询问题加include后查询从 450ms 降到 28msSession 3限流中间件新增 100 req/min 默认限流开发用内存存储、生产用 Redis每条观察记录都会通过POST /agentmemory/observe接口写入携带工具名、输入、输出——这和 12 个自动捕获钩子在真实使用中干的事完全一致。区别只是 demo 帮你手工回放了一遍。种子化完成后demo 会连续发出 3 条smart-search查询jwt auth middleware→ 命中 Session 1关键词层面就能命中database performance optimization→命中 Session 2 的 N1 修复查询词与记忆文本零重叠纯靠语义rate limiting→ 命中 Session 3。第二条查询就是整个 demo 的高光时刻没有任何字面词命中 N1 记录语义向量把它捞了上来。语义召回背后混合搜索的三重信号demo 之所以能跨词汇找到答案靠的是 agentmemory 的混合检索架构详见 README.md 的 Search 章节与 src/functions/smart-search.ts检索流作用何时生效BM25词干化关键词匹配 同义词扩展始终开启无需任何配置Vector稠密向量的余弦相似度配置了 embedding 提供程序Graph知识图谱实体匹配与遍历查询中检测到实体时三路结果用 RRFk60融合排序并按会话去重每会话最多 3 条。⚠️ 一个容易踩的坑纯 BM25 模式下database performance optimization 这条查询会返回 0 条结果。demo 脚本对此有诚实处理——只有真正命中了才会宣称语义召回成功否则提示你需要配置 embedding 提供程序OPENAI_API_KEY、GEMINI_API_KEY写入~/.agentmemory/.env或安装免费的本地模型huggingface/transformers走all-MiniLM-L6-v2后者离线且零成本。边跑边看实时 Viewer 与清理demo 结束时会打印 Viewer 地址默认http://localhost:3113。打开后你能在仪表盘上看到会话数、记忆数、图节点数实时增长切到 Sessions / Timeline 标签还能回放演示会话的完整时间线——这是 src/viewer/ 提供的本地实时面板。跑完想还原环境demo 输出里自带清理命令curl -X DELETE http://localhost:3111/agentmemory/sessions?project/tmp/agentmemory-demo小结demo 命令验证的完整链路步骤验证的能力种子化 3 会话观察记录写入 → LLM 压缩 → 结构化记忆3 条 smart-searchBM25 向量 图谱混合召回与 RRF 融合Viewer 实时刷新会话回放、状态监控:3113--serve自动启停引擎生命周期管理跑通 demo 后下一步就是把你的编码智能体接进来agentmemory connect agent配置 MCP配合 17 个技能让智能体知道何时调用记忆。更多命令参考 README.md 的 Quick Start 与 API 章节。【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemory创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表