创建记忆库与查询用户

本页说明如何创建记忆库、理解详情页结构，并用正确的终端用户 ID 和渠道定位记录。

进入记忆库列表

进入 资源 > 低代码 > 记忆库，或在资源库地址中选择 type=memory。列表页可以按创建者和状态筛选，搜索现有资源，并通过右上角 资源 按钮创建记忆库。

图 1：记忆库资源列表。列表展示资源名称、描述、类型、创建者、编辑时间和操作入口。

列表中的“导入”是资源库的通用入口；是否支持某种记忆库导入格式，应以当前页面实际提供的后续表单为准。不要假定数据库或知识库文件可以直接导入为长期记忆。

创建记忆库

点击 资源 > 记忆库，填写名称和描述后确认。

图 2：创建记忆库。名称用于后续挂载和节点选择，描述用于说明数据用途与边界。

名称规则

• 必填，最多 20 个字符。
• 只能使用英文字母、数字和下划线。
• 必须以英文字母开头。
• 推荐使用稳定、能表达用途的名称，例如 customer_memory、after_sales_memory。

页面会阻止空名称、超长名称和不符合规则的字符。虽然详情页允许改名，但频繁修改会增加项目配置和问题排查的认知成本。

描述规则

描述最多 500 个字符。建议至少写清：

• 面向哪类终端用户和业务场景。
• 记忆来自哪些渠道。
• 允许保存哪些类型的信息。
• 禁止保存哪些敏感信息。
• 主要由哪些项目、智能体或工作流使用。

示例：

保存企业客服终端用户明确确认的表达偏好、产品使用事实和服务事件；不保存密码、支付信息和未经确认的敏感推断。

详情页结构

创建完成后会进入记忆库详情页。

图 3：详情页由资源信息、用户与渠道筛选、用户区域和记忆存储区组成。

区域	功能	使用提醒
名称、编辑、已存条数	查看和修改资源信息	编辑后的名称仍需遵守创建规则
用户 ID 搜索	定位具体终端用户	输入完整、可信的用户 ID 后回车
渠道多选	选择 AIOS、API、Chat SDK、Web SDK	多选会合并读取各渠道结果
计费明细参考	查看当前环境的计费说明入口	实际规则以租户套餐和页面提示为准
刷新	重新加载资源信息和记录	写入后未立即显示时可刷新核对
删除	删除整个记忆库	页面无明确回收站时按不可恢复处理

查询终端用户

在顶部输入终端用户 ID，按回车执行查询。ID 应来自可信运行身份，例如：

• AIOS 站内登录用户映射。
• API 鉴权通过后的业务用户 ID。
• Chat SDK 或 Web SDK 会话中稳定的用户标识。

搜索具体用户后，左侧会显示该用户，右侧标题显示“当前渠道 / 用户 ID”，并启用 新增记忆。清空搜索框后回到所选渠道下的“全部用户”视图，此时可以审阅记录，但不能新增未归属用户的记忆。

选择渠道

渠道	常见入口	身份要求
AIOS	平台站内智能体、工作台	站内账号与终端用户 ID 映射稳定
API	服务端集成	先鉴权，再从服务端上下文取得用户 ID
Chat SDK	嵌入式聊天客户端	SDK 会话用户标识不可多人共用
Web SDK	网页嵌入入口	匿名标识不能错误复用于不同登录用户

详情页默认选择四个渠道。多选用于同时查看多个渠道中的记录，并不表示这些渠道的数据已经合并成一条。人工新增时，多选渠道还会产生多条独立记录，具体规则见管理记忆记录。

搜索不到记录时

按以下顺序排查：

1. 当前工作空间和记忆库是否正确。
2. 用户 ID 是否有多余空格、大小写或环境前缀差异。
3. 是否选中了记录实际产生的渠道。
4. API、SDK 与站内入口是否采用同一套用户映射规则。
5. 记录是否被编辑、删除或按保留策略清理。
6. 工作流运行是否携带了真实用户和渠道上下文。

“同一个显示名称”不代表“同一个终端用户 ID”，也不要为了查到数据而临时改用共享测试 ID。

编辑或删除记忆库

点击名称旁的编辑图标可修改名称和描述。删除图标会要求二次确认，并删除整个资源；在删除前应检查项目和工作流引用、数据保留要求以及是否仍有线上流量写入。

删除单条记录与删除整个记忆库不是一回事。记录级操作见管理记忆记录。