AgentLoop 记忆库(MemoryStore)为 AI 智能体保存可跨会话复用的事实、偏好和业务背景。您可以通过接口写入对话,也可以从 Agent 轨迹或 Dataset 持续获取输入,按策略抽取长期记忆,并在应用处理新问题时检索相关信息。例如,用户先告诉生活助手“我喜欢清淡、少辣的菜”,之后又说明“最近在控制糖分”。记忆库可以持续维护这些偏好;应用在推荐晚餐前检索该用户的相关记忆,再将结果与本次问题一起提供给智能体。
记忆库解决什么问题
场景 | 可以保存的记忆 | 使用方式 |
个人助手 | 兴趣、习惯、表达方式和长期偏好 | 新会话开始后检索相关背景,减少重复询问 |
客户服务 | 用户主动提供的产品使用背景、服务诉求和沟通偏好 | 围绕当前问题补充用户上下文 |
企业业务助手 | 客户、项目或业务对象的状态与关系 | 根据后续交互更新已有信息,供下一次任务参考 |
历史数据利用 | 已采集轨迹、已整理数据集中的可复用事实 | 筛选输入后持续抽取,避免逐条调用写入接口 |
记忆内容随业务交互积累,检索时按用户、应用或 Agent 等业务范围选择相关信息。对于需要追溯的事件,可采用追加方式保存;对于会变化的偏好和业务状态,可采用合并更新方式维护。
核心概念
概念 | 说明 |
记忆库 | 在智能体空间中创建和管理的资源,包含数据源、抽取策略、存储策略和长期记忆 |
数据源 | 记忆抽取的输入来源,包括手动写入、Agent 轨迹和 Dataset |
长期记忆 | 从输入中提取或直接写入、供后续检索使用的内容,例如“用户偏好清淡饮食” |
抽取策略 | 决定关注哪些事实、如何分类以及排除哪些内容 |
存储策略 | 决定追加新记忆,还是结合已有记忆进行新增、更新、合并或删除 |
业务范围(scope) | 使用用户 ID、Agent ID、App ID、Run ID 关联记忆;检索时按提供的条件共同限定范围 |
策略版本 | 保存抽取、存储等策略配置形成的版本记录,用于追溯配置变化 |
召回 | 根据当前问题和业务范围检索相关记忆,返回给应用使用 |
选择数据源
数据源 | 适用情况 | 开始前需要准备 |
手动写入 | 应用能够在对话结束后主动提交消息 | 写入接口、记忆库 API Key,以及稳定的业务用户标识 |
Agent 轨迹 | 已将 Agent 运行数据接入 AgentLoop,希望复用组装完成的轨迹 | 当前智能体空间中的 Agent 轨迹,以及服务名、Agent 名称等筛选条件 |
Dataset | 已通过数据处理将业务信息整理为结构化输入 | 同一智能体空间内符合 |
创建时为记忆库选择一种数据源,创建后不能修改数据源类型。Dataset 来源的库也不能更换绑定的数据集。需要改用其他来源时,创建新的记忆库。
从输入到应用使用
接收输入:应用提交对话,或记忆库从已配置的轨迹、Dataset 获取记录。
抽取事实:根据事实抽取、C 端用户画像、B 端数字孪生或自定义指令,提取需要保留的信息。
维护长期记忆:按事件追加或合并更新策略保存结果,并保留修订、来源和策略等信息。
检索相关记忆:应用或控制台使用当前问题及业务范围进行检索。
组织 Agent 上下文:应用将有用的记忆与本次问题、近期对话一起提供给智能体。
检查与调整:通过样本预览、记忆编辑、审计明细和统计报表检查结果,调整策略。
输入被接收后,抽取和写入长期记忆需要异步处理。应用应分别确认输入已接收、长期记忆已可检索,以及返回内容已加入 Agent 的请求。样本预览用于检查策略效果,不写入正式记忆。
控制台能力
入口 | 可以完成的工作 |
创建记忆库 | 按“数据源 → 过滤 / Schema → 策略 → 预览确认”配置新库 |
概览 | 查看基本信息、数据源、消费进度和最近错误;对轨迹、Dataset 来源暂停或恢复消费 |
长期记忆检索 | 按问题和业务范围检索,查看记忆内容、修订和来源,编辑或删除记忆 |
策略 | 配置抽取与存储规则、范围和审计选项,运行样本预览,查看策略版本历史 |
写入事件 | 对具有写入事件日志的记忆库查看输入事件 |
审计明细 | 查看抽取、存储及召回相关事件,追踪一次召回的返回情况 |
统计报表 | 查看召回次数、非空召回率、时延、抽取漏斗和零结果查询等 |
API Key、集成方式 | 创建访问凭证,获取当前地域的 HTTP API 和 Python SDK 接入示例 |
使用时需要关注什么
标识保持一致:写入与检索使用相同的业务标识。增加多个 ID 条件后,记忆需要同时满足这些条件;跨会话查询时不要误用仅属于某一次运行的 Run ID。
区分事实保留方式:事件追加适合保留过程,合并更新适合维护会变化的信息。修改策略前,先用代表性样本检查抽取结果与拟执行动作。
保护人工修订:开启人工编辑保护后,自动抽取遇到人工修订内容时会保留原内容,并记录待审核变更。
评估实际使用效果:检索分数、非空召回率和返回条数反映检索行为。应用还需要判断返回信息是否有用,以及智能体是否正确使用。
开始使用
首次接入请阅读记忆库使用指南。需要调整抽取范围、存储方式或保留时间时,参见配置记忆抽取与存储策略;需要追踪结果和定位问题时,参见查看记忆审计与统计。