由于 trendforge.devlive.top 访问受限,请切换到 trendforge.devlive.org 域名

学习路径指南
难度等级
入门
预计时长
2-3小时
适合人群
对AI Agent开发感兴趣的TypeScript/Node.js初学者,希望为Agent构建本地化、持久化记忆能力的开发者

学习目标:能够成功安装并运行TencentDB Agent Memory系统,理解其四级流水线架构,并能为单个Agent或团队设置基础的记忆存储与检索功能。

前置知识

Node.js基础 了解

项目基于Node.js运行,需要了解如何安装Node.js和使用npm/yarn等包管理器。

TypeScript基础 了解

项目主要使用TypeScript编写,了解基本语法有助于理解代码结构和配置。

命令行基础 熟悉

安装和启动服务需要在终端中执行命令。

AI Agent概念 了解

理解什么是AI Agent及其会话、上下文、工作流等基本概念,能更好地理解项目的用途。

学习步骤

1

环境准备与安装

30分钟

检查并安装Node.js环境

访问Node.js官网下载并安装LTS版本。在终端运行`node -v`和`npm -v`验证安装成功。

建议使用nvm(Node Version Manager)来管理Node.js版本,方便切换。

克隆项目仓库

在终端中运行 `git clone https://github.com/TencentCloud/TencentDB-Agent-Memory.git`,将项目克隆到本地。

确保Git已安装。

安装项目依赖并启动服务

进入项目目录,根据README指引,运行启动命令(如`npm run start:all`或类似命令)来一次性启动`memory-core`、`memory-hub`和`proxy`三个服务。

首次安装可能需要较长时间下载依赖。请确保终端输出没有报错,并留意控制台输出的访问地址(如http://localhost:8125)。

访问管理面板

在浏览器中打开README中提到的面板地址(例如:http://localhost:8125),确认服务已成功运行并能访问。

如果无法访问,检查防火墙设置或确认服务端口是否被占用。

2

核心概念理解

30-45分钟

阅读项目概述与‘它是什么’部分

精读README中“What is TencentDB Agent Memory?”部分,理解项目要解决的“Agent重复学习”核心痛点,以及四级流水线(收集、提炼、向量化、检索)的基本原理。

重点关注“记忆”在这里的含义:不仅是对话历史,还包括提炼出的技能、文档知识等资产。

了解四大记忆资产类型

通过README中的描述和表格,分别了解:1. **Chat Memory**(对话记忆),2. **Skill**(技能库),3. **Wiki**(文档知识库),4. **CodeGraph**(代码知识图谱)是什么,以及它们解决什么问题。

对比表格中的“标准RAG”列,能更清楚地看出本项目的特色。

理解Memory Hub控制面板的作用

浏览README中“Memory Hub Is Not a Display Board — It's a Control Panel”部分,了解面板在团队管理、资产库管理、Agent装备和知识构建中的核心角色。

此时可以一边看文档,一边在已打开的http://localhost:8125面板中浏览,对照理解。

3

首次上手实践

60-90分钟

在面板中创建团队和Agent

根据README中“One Play Style”部分的指引,在Memory Hub面板中创建你的第一个团队(Team)和一个或多个Agent角色(如“开发者”、“研究员”)。

先从简单的单人团队开始,重点是熟悉操作流程。

体验冷启动:导入现有资产

尝试使用面板的“Cold Start”功能,导入一些简单的现有资产: 1. **导入一个小型文档或Markdown文件**到Wiki。 2. **导入一个包含TypeScript文件的小型项目文件夹**到CodeGraph。 观察面板中是否自动生成了对应的结构化页面或索引。

从一个简单的README.md或一个包含几个.ts文件的项目开始,避免第一次导入过于庞大的数据。

进行一次简单的对话并观察记忆提取

在面板中或通过配置的代理客户端(如Claude Code),与一个已“装备”了导入资产的Agent进行一次简短对话,询问与你导入的文档或代码相关的问题。对话结束后,回到面板的“Chat Memory”和“Skill”部分,查看是否有对话记忆或技能被自动提取出来。

对话可以设计得简单些,例如:“根据刚才导入的文档,总结一下核心要点。”或“这个代码项目的主要入口函数是什么?”

为Agent装备记忆资产

在面板的“Agent Loadout”部分,尝试将之前导入的Wiki页面或CodeGraph条目手动绑定到某个Agent上,模拟为Agent“装备”特定知识。

观察装备后,再与该Agent对话时,其回答是否更能基于你提供的上下文。

4

总结与进阶探索

15-30分钟

回顾与整理

回顾整个流程:从安装、理解概念、到创建团队、导入资产、进行对话并观察记忆的生成与使用。思考这个系统如何能帮助你自己的AI Agent项目。

可以简单地用文字记录下你的操作步骤和遇到的问题。

查阅安装与迁移文档

根据README指引,浏览`INSTALL.md`(或`INSTALLCN.md`)文档,了解更复杂的部署方式(如独立部署Memory Hub)、停机清理、端口配置等,以及数据迁移工具的使用,为后续深入使用做准备。

这部分文档目前只需快速浏览,知道有这些进阶功能和文档存在即可。

推荐资源

INSTALL.md / INSTALLCN.md 必看

详细的安装、部署、配置和清理指南,是解决安装问题的权威来源。

README.md 必看

项目概述、核心功能介绍、快速开始指南和团队玩法示例,是理解项目价值的第一入口。

Discord社区 (discord.gg/dJQM6mKMF) 推荐

与其他开发者交流、提问和获取最新动态的官方社区。

Node.js/TypeScript官方教程 可选

如果对Node.js或TypeScript不熟悉,可以查阅官方基础教程。

学习路径常见错误

1

启动服务失败,端口被占用。

检查终端输出的错误信息。如果是端口冲突(如8125),可以查找并关闭占用该端口的进程,或者查阅INSTALL.md看是否支持配置其他端口。

2

安装依赖时网络超时或失败。

尝试更换npm镜像源(如使用淘宝镜像`npm config set registry https://registry.npmmirror.com`),或使用稳定的网络环境。

3

导入大型代码仓库或文档库导致面板卡顿或处理极慢。

首次学习时,请使用小型、精简的测试数据进行练习。理解系统对大型数据的索引和处理需要时间。

4

不清楚对话后记忆存在哪里,感觉系统没有反应。

对话后,主动到Memory Hub面板的“Chat Memory”、“Skill”等对应分类下查找和刷新。记忆的提取和向量化需要一点处理时间。

5

混淆了不同记忆资产(Chat Memory, Skill, Wiki)的用途和适用场景。

回到“核心概念理解”阶段,重新阅读README中的对比表格和描述,并结合自己的实践体验来区分它们。

学习路径下一步步骤

完成基础学习后,可以探索以下方向:1. 深入研究四级流水线的具体实现,尝试自定义处理逻辑。2. 在面板中精细管理资产的版本、状态和访问权限(Private/Team/ACL)。3. 尝试搭建一个多Agent协作的模拟场景,观察记忆资产如何在团队间流动。4. 阅读源码,特别是`memory-core`部分,理解本地向量存储和检索的具体实现。5. 关注项目更新日志,特别是“Team Memory Beta”的进展。

助手