表格存储：架构与技术选型

系统架构

记忆存储服务采用全托管 Serverless 架构，用户通过 API 与服务交互，底层资源由平台自动管理。数据流转过程如下：

1. 调用 AddMemories 接口，传入对话消息（messages）或纯文本（text)。

2. 系统将原始消息保存为短期记忆。

3. 系统从消息中提取可检索的长期记忆单元，并持久化存储到表格存储。

4. 调用 SearchMemories 接口时，服务结合语义检索和文本检索能力，并支持 Rerank 排序，返回相关长期记忆。

数据模型

记忆库的数据按以下实体组织。

记忆写入

记忆服务支持以下两种方式写入记忆：

• 对话消息写入：通过 AddMemories 接口传入 messages 数组。服务保存原始消息为短期记忆，并从中提取长期记忆单元。

• 文本写入：通过 AddMemories 接口传入 text 字段，直接提交纯文本内容。服务从文本中提取可检索的长期记忆。

写入时需指定 Scope 信息，其中 appId 必填，tenantId、agentId、runId 为空时自动补为 __default__。写入不允许使用通配符 *。

记忆检索

SearchMemories 支持使用自然语言检索长期记忆。服务结合语义检索和文本检索能力，并支持 Rerank 排序，默认启用 Rerank。

检索时 appId 和 tenantId 为必填字段，agentId 和 runId 可使用通配符 * 扩大检索范围。

元数据

长期记忆支持附加元数据（metadata)。元数据可用于存储业务自定义信息，例如记忆来源、标签和优先级等。元数据随记忆单元一起存储，检索结果中会返回对应的元数据字段。

请求审计

服务记录记忆库请求，可通过 ListMemoryStoreRequests 查询请求日志。审计记录包含操作类型、响应状态、延迟和失败原因等字段，适用于排查写入、检索和管理操作中的问题。

Scope 多租户

Scope 用于表示记忆数据的归属和隔离边界。记忆服务使用 appId / tenantId / agentId / runId 四级 Scope。

Scope 的层级为：

appId > tenantId > agentId > runId

核心规则：

• 写入时，appId 必填，其他字段为空时补为 __default__。写入不允许使用通配符 *。

• 检索长期记忆时，appId 和 tenantId 必填，agentId 和 runId 可使用 * 实现跨 Agent 或跨会话检索。

• 查询短期记忆时，四个字段均为必填且不允许通配符。

检索示例：

• agentId=""、runId=""：检索该租户下所有 Agent、所有会话的记忆。

• agentId="sales_assistant"、runId="*"：检索该租户下指定 Agent 的所有会话记忆。

适用性评估

推荐使用的场景：

• 智能客服、销售助手、企业助手等对话型应用。

• 需要跨会话记住用户偏好、配置和历史选择的个人助理。

• 多 Agent 协作场景下的共享记忆管理。

• 需要保留原始会话记录并支持审计排查的 Agent 应用。

• 需要在大规模租户和大量记忆数据下保持稳定检索性能的生产系统。

需要评估的场景：

• 对记忆写入实时性要求极高的场景（记忆提取是异步过程，存在处理延迟）。

• 需要自定义记忆提取策略的场景（当前为系统自动提取）。

不推荐的场景：

• 纯结构化数据查询（建议使用表格存储宽表模型或关系型数据库）。

• 仅需简单的上下文窗口管理、不需要持久化记忆（可直接使用 LLM 的上下文窗口）。

性能评测结果

从检索准确率、检索延时和存储规模三个维度对表格存储记忆服务进行了评测，并与业界主流记忆方案 Mem0 进行了对比。

上述数据用于展示服务能力边界，实际效果会受到数据规模、查询方式、网络环境、模型配置和业务数据分布影响。以下是各维度的详细评测。