VolcengineVolcengine ADK
记忆长期记忆

Redis(redis)

redis 后端(RedisLTMBackend)使用 Redis 作为向量存储,按用户隔离索引(veadk-ltm/{index}/{user_id})。记忆经 embedding 后写入,检索时按相似度(cosine)召回。

何时使用

  • 已有 Redis 且开启了 RediSearch 模块;
  • 希望用 Redis 作为低延迟的向量检索后端。

依赖

pip install "veadk-python[extensions]"

Redis 需支持 RediSearch(向量检索)能力。

配置

Redis 连接用 RedisConfig 读取,环境变量前缀 DATABASE_REDIS_;embedding 用 MODEL_EMBEDDING_*

配置项环境变量默认值说明
hostDATABASE_REDIS_HOST""Redis 主机。
portDATABASE_REDIS_PORT6379端口。
usernameDATABASE_REDIS_USERNAMENone用户名(可选)。
passwordDATABASE_REDIS_PASSWORD""密码。
dbDATABASE_REDIS_DB0数据库编号。

用法

from veadk import Agent
from veadk.memory.long_term_memory import LongTermMemory

ltm = LongTermMemory(backend="redis", index="ltm_demo")
agent = Agent(name="demo", long_term_memory=ltm)

向量维度取自 embedding 配置(MODEL_EMBEDDING_DIM),距离度量为 cosine。索引会为每个用户单独创建。

本页导航