agentmemory:解决编码代理记忆难题,多特性优势显著,还支持多方面扩展与开发
核心特性编码代理通常会话结束后遗忘信息用户需重新介绍技术栈而 agentmemory 基于 iii 引擎构建为多种客户端提供持久内存解决此问题。其核心特性包括自动记忆与上下文注入、多代理支持、高效检索与成本节约、会话回放、多语言与多平台支持。例如自动记忆与上下文注入能让代理记住之前会话设置无需重新解释在 Retrieval Accuracy 测试中表现出色还能显著节省令牌成本。技术细节agentmemory 的技术细节包含记忆管道、4 层记忆整合、检索方式和嵌入提供者。记忆管道通过 PostToolUse 钩子触发经过多步骤最终在 BM25 和向量中索引4 层记忆整合受人类大脑启发记忆会随时间衰减等检索方式采用三重流检索并融合支持多种嵌入提供者。工具与资源提供 51 个工具包括核心工具和扩展工具满足不同记忆管理需求还有 6 个资源和 3 个提示以及 4 个技能用于搜索记忆、保存到长期记忆等操作。安装与配置启动服务器使用 npx agentmemory/agentmemory不同代理有不同集成方式一般需在配置文件添加 MCP 服务器配置信息Windows 用户有多种安装方式可选。诊断与维护若 npx agentmemory/agentmemory 失败可用 --verbose 选项查看引擎错误信息常见失败模式包括引擎启动失败、端口冲突等。使用 npx agentmemory/agentmemory upgrade 命令更新本地运行时但可能会修改工作区和更新依赖项等。扩展功能通过 iii worker add 命令可为 agentmemory 添加新功能如实现多实例内存同步、定期生命周期管理、持久重试等。环境变量配置可在 ~/.agentmemory/.env 文件中配置环境变量涵盖 LLM 提供者、嵌入提供者等多方面。REST API在端口 3111 上有 107 个端点默认绑定到 127.0.0.1受保护端点和网状同步端点有相应认证要求关键端点包括健康检查和混合搜索等。开发与测试开发使用 npm run dev 进行热重载开发构建使用 npm run build 进行生产构建测试使用 npm test 运行 800 个测试约 1.7s使用 npm run test:integration 进行 API 测试需运行服务。前提条件使用 agentmemory 需要 Node.js 20以及 iii - engine 或 Docker遵循 Apache - 2.0 许可证。