一键起三件套

一键起三件套

本节摘要:环境就绪后,第二步是用项目提供的一键脚本把三个服务同时拉起来。本节带你走完从「克隆仓库、填配置、执行脚本」到「确认三服务健康」的全过程,重点是说清 start-all.sh 这个脚本背后做了什么——它不是黑魔法,而是按依赖顺序启动记忆核心服务、知识服务、记忆中枢、代理层,并在结束时打印一行可直接复制的接入命令。读完本节你会在本地拥有一套完整的、可交互的运行环境,这不仅是本章的成果,更是后续十一章所有实验的基础。

一、一键启动的标准流程

把三件套拉起来的标准动作只有四步:

# 1. 克隆仓库并进入部署目录
git clone https://github.com/Tencent/TencentDB-Agent-Memory.git
cd TencentDB-Agent-Memory/deploy/global-images

# 2. 从示例复制一份环境配置
cp .env.example .env

# 3. 编辑配置,填入两组 LLM 参数(详见上一节)
$EDITOR .env

# 4. 一键起三件套
./start-all.sh
​

脚本结束时会打印一行可直接复制粘贴的命令,通常是给 Claude Code 这类 Agent 用的接入指令——把它记下来,下一节会用到。

关键概念:start-all.sh 做的事是「按依赖顺序拉起四个进程」。注意是四个不是三个:记忆核心服务、知识服务、记忆中枢(控制台)、代理层。前三者常被合称为「三件套」,代理层是接入面,但脚本会一并起好。

二、脚本背后的启动顺序

一键脚本不是并行启动所有服务,而是按依赖关系顺序拉起——后启动的服务依赖前面的。理解这个顺序有助于排查「某个服务没起来」的问题:

启动顺序(按依赖)
  ① 记忆核心服务 (8420)        ← 地基,记忆的存取都在这
        │ (核心就绪后)
        ▼
  ② 知识服务 (8421/8424)        ← 依赖核心做资产登记
        │ (知识就绪后)
        ▼
  ③ 记忆中枢 / 控制台 (8125)    ← 依赖核心与知识做展示
        │ (控制台就绪后)
        ▼
  ④ 代理层 (8096)              ← 依赖核心做召回与回写
        │
        ▼
  打印接入命令(含 baseURL 与密钥)
​

💡 技巧:排查启动失败时,从序号最小的服务查起——往往是地基(核心服务)没起来,导致后面连锁失败。看日志时优先看 ① 的输出。

三、确认三服务健康

启动完成后,用两种方式确认健康。第一种是打开控制台:

浏览器访问:http://localhost:8125
  能看到面板首页  → 控制台(③)健康
  面板里能看到资产列表 → 核心服务(①)健康
  能发起 Wiki 构建   → 知识服务(②)健康
​

第二种是看脚本输出的日志,每个服务启动成功都会打印监听端口与就绪标记。如果某个服务没有「ready」字样,回到上一小节的启动顺序定位。

⚠️ 注意:Wiki 与 CodeGraph 是「异步构建」的——发起构建后需要等待一段时间才会变成 ready 状态,这不是故障。判断它们是否健康,看的是「能否发起构建」而非「是否立刻 ready」。

四、停止与清理

实验告一段落时,用配套脚本停止与清理,避免端口与容器残留:

# 停止三件套(保留数据)
./stop-all.sh

# 如需彻底清理(含数据,谨慎)
# 按部署目录里的清理脚本操作,注意会删除记忆数据
​

一个常被忽略的细节是:停止后再次 start-all.sh,之前沉淀的记忆数据仍在——因为数据落在持久化存储里,不在进程内存。这一点在反复实验时很重要:你不必每次重启都重新「教」Agent。

本节要点回顾

1. 标准四步:克隆、复制配置、填两组凭证、跑 start-all.sh,结束时拿好打印的接入命令。
2. 启动顺序:核心 → 知识 → 控制台 → 代理,按依赖串行;排查失败从最早的服务查起。
3. 健康确认:浏览器开 8125 看面板,面板能看资产说明核心健康,能发起构建说明知识健康。
4. 异步构建:Wiki/CodeGraph 发起后要等 ready,不是故障;健康看「能否发起」而非「是否立刻就绪」。
5. 数据持久:停止再启动,记忆数据仍在,反复实验不必重教。

三件套已经健康运行,下一节我们把第一个 Coding Agent 接进来,完成带记忆的第一次会话。