SuperAPI AI 工具集

TencentDB-Agent-Memory

TencentDB Agent Memory 是面向 AI Agent 的团队级记忆中枢,将对话、文档和代码转化为四类可复用的记忆资产:Chat Memory(聊天记忆)、Skill(技能)、LLM-Wiki(知识库)和 Code-Graph(代码图谱),并支持在多个 Agent 与框架之间进行治理、共享和装备。它通过一个 Proxy 实现零代码集成,Agent 只需将 base URL 指向 Proxy 即可接入,无需插件、钩子或 MCP 服务器。项目提供 Memory Hub 面板用于创建团队和 Agent、审核与分配记忆资产,支持私有、团队和受限三种可见性,以及基于用户、角色和 Agent 的 ACL 权限控制。记忆资产与 Agent 框架解耦,可跨框架迁移和共享,帮助团队减少重复工作,让新 Agent 快速继承已有经验。当前版本为 v2.0.0,采用 MIT 许可证。

访问官网

工具介绍

TencentDB Agent Memory 是腾讯云开源的团队级 AI Agent 记忆中枢,旨在解决使用 Agent 时重复解释项目上下文、重复阅读文档、重复发现工作流的问题。它把对话、文档和代码转化为四类可复用的记忆资产,并在多个 Agent 和框架之间进行治理、共享和装备。

用途

项目从实际问题出发:如果项目上下文已经解释过,就不应该在新会话中重复;如果文档已经读过,每个 Agent 就不应该从第一页重新开始;已经有效的工作流不应该下次重新发现。这里的“记忆”不只是记住对话,而是任何能帮助下一个 Agent 避免重复劳动的信息,都应该被保存、组织和复用。

主要能力

  1. 四类记忆资产

    • Chat Memory(聊天记忆):保留偏好、事实、决策和交互历史。每个 Agent 创建时自动获得自己的记忆。原始对话按 L0 对话 → L1 原子 → L2 场景 → L3 人格逐层提炼。
    • Skill(技能):Agent 完成复杂工作后,可从对话和工具调用中提取并管理可复用技能,按需导入指定 Agent 的上下文。技能具有版本、资源文件、触发边界、执行步骤和验证规则。个人技能默认私有,审核后可共享给团队并分配给其他 Agent。
    • LLM-Wiki(知识库):将产品文档、设计规范和运维手册转化为带链接图的结构化页面。灵感来自 Karpathy 的 LLM 知识库理念。
    • Code-Graph(代码图谱):索引代码符号、文件、调用关系和影响路径。Agent 可以搜索、阅读、检查调用者/被调用者,并在修改代码前进行影响分析。
  2. 自动资产提取:从对话和任务中提取 Chat Memory 和 Skill;将文档和代码转化为 Wiki 和 CodeGraph;然后统一管理、审核和路由。

  3. 可移植与多 Agent 兼容:记忆资产与 Agent 框架解耦,可跨框架移动,由多个 Agent 和团队成员共享维护。

  4. 冷启动友好:可导入现有文档、代码库和 Agent 对话会话。新 Agent 团队可以从已有经验开始,而不是从零学习。

  5. 团队记忆面板:在 Memory Hub 中创建团队和 Agent;审核、共享和装备记忆资产。集中管理所有权、版本、状态、可见性、使用次数和 Agent 绑定。可见性分为 private(严格属于所有者)、team(所有团队成员可见)和 restricted(通过 User / Role / Agent ACL 精确授权)。角色分为全局 System Admin 和团队级 Admin、Member,资产所有权通过 Owner 跟踪。

使用方式

  • 安装:可一键启动三个服务(memory-core + memory-hub + proxy),然后打开面板 http://localhost:8125 。完整安装文档见 INSTALL.md(中文:INSTALL_CN.md)。MongoDB 存储后端为实验性,默认关闭。
  • 集成:一个 Proxy,协议不变,零代码集成——将 Agent 的 base URL 指向 Proxy 即可,无需插件、钩子或 MCP 服务器。各客户端具体配置步骤见 INSTALL.md。未支持的 Agent 可参考通用集成指南自行适配。
  • 数据迁移:从旧版本(v1.x / v0.x)迁移到 v2.0.0+ 可使用数据迁移工具(v2 → v3),新安装可跳过。
  • 冷启动:在面板中直接导入现有代码库(CodeGraph 自动索引)、文档和文件(Wiki 自动生成结构化页面和链接图)、过往 Agent 对话会话(自动提取 Skill 和 Chat Memory)。

适用场景

  • 一人公司构建不断成长的 Agent 团队:创建团队,招募不同角色的 Agent,为每个 Agent 装备其实际需要的记忆资产,让经验持续积累。
  • 团队共享经验而不共享隐私:新 Chat Memory 和 Skill 默认私有,共享是显式操作。可将“发布技能”分配给发布 Agent,“架构 Wiki”分配给所有开发 Agent,CodeGraph 分配给编码和审查 Agent。
  • 减少重复工作:让团队走过的路成为下一个 Agent 的起跑线。

技术实现

  1. 记忆分层增长:对话先保存为 L0,再通过异步管道提炼为多级粒度。生成和检索都分层:通常 L2/L3 提供快速上下文引导;需要具体事实时,BM25 + 向量检索 + RRF 回退到 L1/L0。结果受条目数、字符预算和超时限制,防止记忆淹没上下文窗口。
  2. 记忆是 Agent 的装备而非全局提示:Chat Memory、Skill、Wiki、CodeGraph 统一注册为 Memory Assets。Memory Hub 使用固定绑定 + ACL 决定某个 Agent 可使用哪些资产:先按 Team、User、Agent 和可见性缩小权限范围,再根据当前查询检索。
  3. 知识按需调用:文档组织为可搜索的 Wiki 页面,支持链接图下钻;代码库索引为包含文件、符号和调用关系的 CodeGraph 资产。Agent 先通过 /v3/tools/list 发现能力,再用 /v3/tools/call 读取相关页面、源代码或影响路径。

限制

  • Wiki 和 CodeGraph 异步构建,达到 ready 状态需要一定处理时间。
  • CodeGraph 目前优先支持公共 HTTPS 仓库;私有仓库和 SSH 凭据支持仍在完善。
  • Hub 支持手动资产绑定;全自动记忆路由仍在迭代中。
  • MongoDB 存储后端为实验性,默认关闭。
  • 当前版本 v2.0.0,下一版本 v2.0.1 计划包括零配置冷启动、更快的 Wiki 生成、用户/团队自定义提示、Skill 导出和 Codex(IDE Plan 模式)支持。

相关文档

  • 路线图(ROADMAP.md,中文:ROADMAP_CN.md)
  • 完整安装指南(INSTALL.md,中文:INSTALL_CN.md)
  • 数据迁移工具(v2 → v3)
  • 知识 OpenAPI
  • API 文档:Memory Core v3 API、Memory Knowledge v3 API、Memory Proxy v3 API、Memory Panel API
  • 贡献指南(CONTRIBUTING.md)

项目采用 MIT 许可证。