TencentDB Agent Memory · 第 2 章核心概念与整体架构

文档摘要

TencentDB Agent Memory · 第 2 章核心概念与整体架构章节摘要:这是全书的地图章。本章先把「为什么需要 Agent 记忆」这件事讲透——它不是「记住对话」,而是「让下一个 Agent 少走弯路」,凡是能减少重复工作的信息都该被保存、组织、复用。接着给出项目的四类记忆资产(Chat Memory / Skill / Wiki / CodeGraph)与四个组件(记忆核心服务 / 知识服务 / 记忆中枢 / 代理层),画出它们的拓扑与职责边界,并跟踪一次「用户发问 → 记忆被召回 → 答复被沉淀」的完整控制流旅程。最后用一个对照表把 Agent Memory 与聊天历史、普通 RAG、Mem0 的差异钉死,让你明白它填补的到底是什么空缺。

TencentDB Agent Memory · 第 2 章核心概念与整体架构

章节摘要:这是全书的地图章。本章先把「为什么需要 Agent 记忆」这件事讲透——它不是「记住对话」,而是「让下一个 Agent 少走弯路」,凡是能减少重复工作的信息都该被保存、组织、复用。接着给出项目的四类记忆资产(Chat Memory / Skill / Wiki / CodeGraph)与四个组件(记忆核心服务 / 知识服务 / 记忆中枢 / 代理层),画出它们的拓扑与职责边界,并跟踪一次「用户发问 → 记忆被召回 → 答复被沉淀」的完整控制流旅程。最后用一个对照表把 Agent Memory 与聊天历史、普通 RAG、Mem0 的差异钉死,让你明白它填补的到底是什么空缺。读完本章你会拥有一张可在后续十一章里反复对照的全局地图。

学习目标

阅读完本章,你应当能够:

用一句话说清 Agent 记忆解决的真问题,并区分它与「记住对话」的差异
说出四类记忆资产各自的形态与适用场景,并解释它们为何被统一抽象
画出四个组件的拓扑图,说清谁接 Agent、谁存记忆、谁管治理、谁建知识
复述一次记忆召回的控制流旅程,指出注入与回写分别发生在哪里
用对照表向他人解释 Agent Memory 相比聊天历史 / RAG / Mem0 的独有维度

核心概念速览

一句话金句:四个组件不是四个并列功能,而是一条「接入 → 取记忆 → 建知识 → 人治理」的价值链——每个组件都只为这条链上的一个环节而存在。

子章节导航

01 为什么需要 Agent 记忆:从重复工作到经验复利

从「项目背景讲过了不该换个 Session 再讲」这一日常痛点出发,推导出记忆的目标:把已付过的学习成本变成存档,让 已有信息 → 可复用记忆资产 → 更少 Turns → 更少返工 → 更稳定结果 这条链跑通。

02 四类记忆资产总览

逐个讲清 Chat Memory(记住人和事)、Skill(积累做法)、Wiki(文档知识地图)、CodeGraph(代码知识地图)四类资产的形态、用途与区别,点明它们都被统一登记为 Memory Asset。

03 四组件拓扑与职责边界

画出代理层 / 核心服务 / 知识服务 / 记忆中枢的拓扑,逐个说清它的端口、职责与「不做的事」,划清边界避免读者把功能张冠李戴。

04 一次记忆召回的控制流旅程

跟踪一次完整的请求:Agent 发问 → 代理拦截 → 召回记忆 → 注入上下文 → 转发 LLM → 答复回写,把抽象的「记忆」落到一次具体的调用旅程上。

05 与 RAG / 聊天历史 / Mem0 的差异定位

用一个对照表把「跨会话理解用户 / 沉淀可执行经验 / 文档结构 / 代码影响 / Owner 版本 / 团队分享 / 私有 ACL」七个维度逐项对比,钉死 Agent Memory 的独有定位。

子章节之间的逻辑关系

本章是「动机 → 资产 → 组件 → 流程 → 定位」的递进链条,前四节是「是什么」,第五节用对比收束:


┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
│ 01 动机   │──▶│ 02 资产   │──▶│ 03 组件   │──▶│ 04 流程   │
│ 解决什么  │   │ 记什么    │   │ 谁来管    │   │ 怎么流转  │
└──────────┘   └──────────┘   └──────────┘   └──────────┘
                                                   │
                                                   ▼
                                          ┌────────────────┐
                                          │ 05 差异定位     │
                                          │ 与 RAG/历史/Mem0│
                                          └────────────────┘

铺垫说明:第 2 章只给「地图」,不给「施工图」。资产如何登记治理见第 3 章、如何分层见第 4 章;组件的内部实现见第 6~8 章源码精读;控制流里的注入细节见第 8 章、SDK 视角见第 9 章。本章是后续所有章节的索引页,值得反复回看。

前置知识与后续延伸

前置知识:

第 1 章已跑通三件套(非必需,但有运行环境更利于理解控制流)
了解 RAG、「向量检索」「聊天上下文」的基本概念
用过 Coding Agent,知道「会话」「工具调用」是什么

本章为后续章节奠定的基础:

四类资产与四组件的全局图,是第 3~8 章展开细节时的「定位锚」
控制流旅程,是第 8 章(Proxy 管道)与第 9 章(SDK 四步法)的骨架预告
与 RAG / Mem0 的差异表,是第 4 章(为何要分层)与第 11 章(场景价值)的论证依据

TencentDB Agent Memory · 第 2 章 核心概念与整体架构

文档摘要