记忆库产品介绍

更新时间:
复制 MD 格式

AgentLoop 记忆库(MemoryStore)为 AI 智能体保存可跨会话复用的事实、偏好和业务背景。您可以通过接口写入对话,也可以从 Agent 轨迹或 Dataset 持续获取输入,按策略抽取长期记忆,并在应用处理新问题时检索相关信息。例如,用户先告诉生活助手“我喜欢清淡、少辣的菜”,之后又说明“最近在控制糖分”。记忆库可以持续维护这些偏好;应用在推荐晚餐前检索该用户的相关记忆,再将结果与本次问题一起提供给智能体。

记忆库解决什么问题

场景

可以保存的记忆

使用方式

个人助手

兴趣、习惯、表达方式和长期偏好

新会话开始后检索相关背景,减少重复询问

客户服务

用户主动提供的产品使用背景、服务诉求和沟通偏好

围绕当前问题补充用户上下文

企业业务助手

客户、项目或业务对象的状态与关系

根据后续交互更新已有信息,供下一次任务参考

历史数据利用

已采集轨迹、已整理数据集中的可复用事实

筛选输入后持续抽取,避免逐条调用写入接口

记忆内容随业务交互积累,检索时按用户、应用或 Agent 等业务范围选择相关信息。对于需要追溯的事件,可采用追加方式保存;对于会变化的偏好和业务状态,可采用合并更新方式维护。

核心概念

概念

说明

记忆库

在智能体空间中创建和管理的资源,包含数据源、抽取策略、存储策略和长期记忆

数据源

记忆抽取的输入来源,包括手动写入、Agent 轨迹和 Dataset

长期记忆

从输入中提取或直接写入、供后续检索使用的内容,例如“用户偏好清淡饮食”

抽取策略

决定关注哪些事实、如何分类以及排除哪些内容

存储策略

决定追加新记忆,还是结合已有记忆进行新增、更新、合并或删除

业务范围(scope)

使用用户 ID、Agent ID、App ID、Run ID 关联记忆;检索时按提供的条件共同限定范围

策略版本

保存抽取、存储等策略配置形成的版本记录,用于追溯配置变化

召回

根据当前问题和业务范围检索相关记忆,返回给应用使用

选择数据源

数据源

适用情况

开始前需要准备

手动写入

应用能够在对话结束后主动提交消息

写入接口、记忆库 API Key,以及稳定的业务用户标识

Agent 轨迹

已将 Agent 运行数据接入 AgentLoop,希望复用组装完成的轨迹

当前智能体空间中的 Agent 轨迹,以及服务名、Agent 名称等筛选条件

Dataset

已通过数据处理将业务信息整理为结构化输入

同一智能体空间内符合 MemorySourceV1 字段要求的数据集

创建时为记忆库选择一种数据源,创建后不能修改数据源类型。Dataset 来源的库也不能更换绑定的数据集。需要改用其他来源时,创建新的记忆库。

从输入到应用使用

  1. 接收输入:应用提交对话,或记忆库从已配置的轨迹、Dataset 获取记录。

  2. 抽取事实:根据事实抽取、C 端用户画像、B 端数字孪生或自定义指令,提取需要保留的信息。

  3. 维护长期记忆:按事件追加或合并更新策略保存结果,并保留修订、来源和策略等信息。

  4. 检索相关记忆:应用或控制台使用当前问题及业务范围进行检索。

  5. 组织 Agent 上下文:应用将有用的记忆与本次问题、近期对话一起提供给智能体。

  6. 检查与调整:通过样本预览、记忆编辑、审计明细和统计报表检查结果,调整策略。

输入被接收后,抽取和写入长期记忆需要异步处理。应用应分别确认输入已接收、长期记忆已可检索,以及返回内容已加入 Agent 的请求。样本预览用于检查策略效果,不写入正式记忆。

控制台能力

入口

可以完成的工作

创建记忆库

按“数据源 → 过滤 / Schema → 策略 → 预览确认”配置新库

概览

查看基本信息、数据源、消费进度和最近错误;对轨迹、Dataset 来源暂停或恢复消费

长期记忆检索

按问题和业务范围检索,查看记忆内容、修订和来源,编辑或删除记忆

策略

配置抽取与存储规则、范围和审计选项,运行样本预览,查看策略版本历史

写入事件

对具有写入事件日志的记忆库查看输入事件

审计明细

查看抽取、存储及召回相关事件,追踪一次召回的返回情况

统计报表

查看召回次数、非空召回率、时延、抽取漏斗和零结果查询等

API Key、集成方式

创建访问凭证,获取当前地域的 HTTP API 和 Python SDK 接入示例

使用时需要关注什么

  • 标识保持一致:写入与检索使用相同的业务标识。增加多个 ID 条件后,记忆需要同时满足这些条件;跨会话查询时不要误用仅属于某一次运行的 Run ID。

  • 区分事实保留方式:事件追加适合保留过程,合并更新适合维护会变化的信息。修改策略前,先用代表性样本检查抽取结果与拟执行动作。

  • 保护人工修订:开启人工编辑保护后,自动抽取遇到人工修订内容时会保留原内容,并记录待审核变更。

  • 评估实际使用效果:检索分数、非空召回率和返回条数反映检索行为。应用还需要判断返回信息是否有用,以及智能体是否正确使用。

开始使用

首次接入请阅读记忆库使用指南。需要调整抽取范围、存储方式或保留时间时,参见配置记忆抽取与存储策略;需要追踪结果和定位问题时,参见查看记忆审计与统计。