前提条件
已通过注册账号及开通服务页面操作完成注册账号及开通服务。
子账号授权参考子账号管理。
创建记忆库
- 在记忆库控制台,或调用 CreateCollection 接口,创建一个新的记忆库。
- 创建时可选择:
- 使用内置记忆抽取模板(推荐首次使用)
- 自定义记忆抽取逻辑(适合有个性化需求的场景)


写入原始数据
调用 AddSession 接口,向上一步已创建的记忆库,写入 session 数据,系统将根据记忆库的记忆抽取配置(事件规则、画像规则)对这些消息进行处理和存储,形成结构化的记忆事件,并可能更新关联的画像。
注意:
- 调用 AddSession 接口时,若使用相同的 session_id,系统将覆盖该会话中产生的用户画像和事件。建议使用 UUID 动态生成 session_id,确保每次会话独立;只有在确实需要覆盖时才重复使用。
查看记忆
写入完成后,可以在控制台查看系统抽取的记忆:



检索记忆
完成数据写入后,可以先在控制台进行记忆检索测试。
提示:
- 为减少不必要的开销,记忆库默认在写入数据后才开始构建索引。
- 索引构建约需 3–5 分钟。因此,建议写入数据后稍等再检索。
- 索引创建完成后,每次新增会话到可检索之间的延迟约 15 秒。

在生产环境中,请调用 SearchMemory 接口完成检索。
- 检索事件:需填写 user_id 或 assistant_id,也可以两者同时填写。建议每轮对话都进行检索。
- 检索画像:只能填写 user_id 或 assistant_id,且二者不可同时填写。通常在会话开始时进行一次检索即可。