接入记忆库（长期记忆）--实时音视频-火山引擎

文档中心

实时音视频

请输入

进阶功能

接入记忆库（长期记忆）

通过将历史对话记录等关键信息存储在火山记忆库，可使智能体具备跨会话的长期记忆能力。当用户提问时，系统会从记忆库中检索相关记忆，并将「用户问题 + 过渡语（若已配置）+ 所有被采纳的记忆」拼接成一个更丰富的上下文交由 LLM 处理，从而生成更个性化和精准的回复。

若需智能体回溯并参考最近 N 轮历史对话记录来回复（即短期记忆），可配置上下文。具体操作，请参见上下文管理。

应用场景

社交与陪伴：让虚拟角色记住用户的偏好和表达习惯，提升互动的连贯性和真实感。
教育陪练：动态跟踪学习进度，记录知识点掌握情况，实现因材施教。
智能硬件：通过记忆能力提升产品个性化和温度感，不再局限于固定功能。

计费说明

记忆库为付费资源，会根据您的实际使用量进行独立计费。详细计费规则和价格，请参见记忆库计费。

工作原理

当接入并启用火山记忆库后，每一轮对话的处理流程会变为：

用户的语音问题被 ASR 转换为文本。
系统根据配置的 filter 规则从记忆库中检索与当前用户问题相关的记忆。
系统为每一条召回的记忆计算一个“置信度分数”，并根据设定的阈值（Score）判断是否要采纳记忆：
- 若置信度分数 ≥ 置信度阈值：该记忆被采纳。
- 若置信度分数 < 置信度阈值：该记忆被丢弃。
最后，系统将 用户问题 + 过渡语（若已配置） + 所有被采纳的记忆 拼接成一个新的、更丰富的上下文，送给 LLM 进行处理并生成回复。

实现步骤

准备工作

获取与智能体的历史对话记录。具体操作，请参见实时字幕（对话记录）。

步骤 1：创建并填充记忆库

创建记忆库并定义规则：在火山引擎向量数据库（VikingDB）控制台，创建一个事件规则的记忆库。具体操作，请参见创建记忆库。
向记忆库中添加记忆：具体操作，可参见添加记忆。

成功添加记忆后，可在控制台查看记忆详情。具体操作请参见查看记忆详情。

步骤 2：为服务授权访问记忆库

为了让实时对话式 AI 服务能够访问你的记忆库，你需要为服务角色 VoiceChatRoleForRTC 添加对向量数据库（VikingDB）的访问权限。

登录火山引擎访问控制（IAM）控制台。
在左侧导航栏中，选择 角色管理，搜索并找到 VoiceChatRoleForRTC，单击操作栏的添加权限。
在权限策略列表中，搜索并勾选 MLPlatformVikingDBFullAccess 和 VikingdbFullAccess 两个权限。
单击提交完成授权。

步骤 3：配置 StartVoiceChat 接口

调用 StartVoiceChat 接口时，在 Config 对象中配置 MemoryConfig 参数。

完整参数及说明，参见对应接口文档：新版 StartVoiceChat（2025-06-01）、旧版 StartVoiceChat（2024-12-01）。

{
  "Config": {
    "MemoryConfig": {
      "Enable": true,                       // 必填：设置为 ture                            
      "Provider": "volc",                  // 必填：固定值
      "ProviderParams": {
        "collection_name": "customer_service_memory", // 必填：步骤 1 创建的记忆库名称
        "limit": 3,
        "filter": {
          "user_id": ["current_user_id"],     // user_id 和 assistant_id 至少填一个
          // "assistant_id": ["assistant_123"],     
          "memory_type": ["order_event"] // 步骤 1 在 VikingDB 的事件规则定义
        },
        "transition_words": "根据您的历史记录："
      },
      "Score": 0.7 // 召回的记忆的置信度阈值，低于该分数的记忆内容将被丢弃
    },
    // ... ASRConfig, TTSConfig, LLMConfig
  }
}

最近更新时间：2025.12.26 00:14:43

这个页面对您有帮助吗？

有用

无用