多用户 / 多 Agent 隔离

如果你的产品同时被多个用户、Agent、项目或业务场景使用，记忆需要有清楚的边界。

项目边界划分了不同产品或业务空间；
用户边界划分了同一项目下，不同用户的个人记忆；
Agent / 应用边界划分了同一用户在多个 Agent / 应用中产生的不同记忆；
会话上下文标记每条记忆来自哪一次对话或任务；
项目中共享的知识可以放入知识库或公共记忆，供有权限的用户使用。

1. 项目边界：创建项目并使用 API Key

如果你还未注册云服务，可以先登录 MemOS 控制台，新用户会有一个默认项目；如果你需要隔离不同的产品或业务空间，请在控制台创建新项目。

每个项目都有自己的 API Key 列表，启用项目时，传入对应的 API Key，即可使用该项目下的记忆内容。前往 API Key 页面，快速获取接口密钥。

关于项目创建、切换和接口密钥管理，详见项目配置。

2. 不同用户记忆：使用不同的`user_id`

每个用户都需要对应唯一的 user_id，同一个用户在不同的入口或应用中，可以继续使用相同的 user_id，这样 MemOS 才能形成连续的长期记忆。

写入用户 A 的记忆：

{
  "user_id": "memos_user_A",
  "messages": [
    { "role": "user", "content": "我喜欢吃辣。" }
  ]
}

检索用户 B 的记忆：

{
  "user_id": "memos_user_B",
  "query": "帮我推荐美食"
}

这次检索只会在用户 B 的个人记忆中查找，不会检索到用户 A 的记忆。即使两个用户来自同一个项目，与同一个 Agent 对话，使用不同的 user_id 时，记忆边界依旧保持清晰。

群聊中的多用户记忆：传入 `user_id` 列表 NEW

当多个用户在同一会话中对话时，user_id 支持传入 list，MemOS 会为每个参与者抽取和维护记忆。

{
  "user_id": ["memos_user_1", "memos_user_2"],
  "agent_id": "memos_agent",
  "messages": [
    { "role": "user", "role_id": "memos_user_1", "role_name": "张三", "content": "下周二的方案评审，大家时间合适吗？" },
    { "role": "user", "role_id": "memos_user_2", "role_name": "李四", "content": "我可以，下午两点怎么样？" },
    { "role": "assistant", "role_id": "memos_agent", "content": "已记录，下周二下午两点方案评审。" }
  ]
}

通过 role_id 和 role_name 标识每条消息的发言人，记忆文本中可区分谁说了什么。

更多群聊使用方法，详见群聊。

3. 多 Agent 隔离：使用 `agent_id`

如果同一个用户使用多个 Agent，例如客服助手、健康助手、代码助手，你需要为不同 Agent 设置不同的 agent_id。

添加与健康助手的对话消息时，传入"agent_id": "health_assistant"：

{
  "user_id": "memos_user_123",
  "agent_id": "health_assistant",
  "messages": [
    { "role": "user", "content": "我今天跑了 5 公里，膝盖有点酸。" }
  ]
}

检索记忆时，使用filter过滤对应 Agent 的记忆内容：

{
  "user_id": "memos_user_123",
  "query": "根据我最近的运动情况给些建议",
  "filter": {
    "and": [
      { "agent_id": "health_assistant" }
    ]
  }
}

这样做的好处是：用户的长期记忆仍然属于同一个人，不会被拆散；同时，不同 Agent 产生的记忆也可以在检索时按需筛选。

更多记忆过滤的方法，详见记忆过滤器（filter）。

为 Agent 创建独立记忆 NEW

在控制台创建或修改项目时开启「为 Agent 创建独立记忆」开关，可以让每个 Agent 拥有自己的记忆。

更好地维护 AI 角色的经历、认知和状态；
支持多个用户共用同一 Agent 的场景，例如：家庭共用智能助手、企业群聊助手等。

开启该功能后：

添加消息时，MemOS 会分别抽取并更新用户和 Agent 的记忆；
检索记忆时，支持以 agent_id 为主体，检索 Agent 的独立记忆；
Agent 可积累自己的长期记忆，在不同用户、不同会话中，保持角色的连续性。

该功能默认关闭，此时 agent_id 仍可用于过滤和标记，但不会为 Agent 创建独立的记忆实例。

4. 当前会话：使用 `conversation_id`

为了让 MemOS 更好地理解上下文内容，添加用户消息时可传入会话标识 conversation_id，表示这条消息属于哪一次对话或任务；不传时系统自动生成。

{
  "user_id": "memos_user_123",
  "conversation_id": "order_refund_001",
  "messages": [
    { "role": "user", "content": "我想咨询退款进度。" },
    {"role": "assistant", "content": "退款仍在处理中，预计24小时内到账。"}
  ]
}

检索记忆时，conversation_id 不是强制过滤条件。传入它可以明确当前所在会话，让本会话相关记忆获得更高权重；不传时，系统仍会在该用户的历史记忆中检索。

5. 共享知识：放入知识库或公共记忆

不是所有内容都应该写入某个用户的个人记忆，项目文档、制度、产品手册、SOP 等公共知识，更适合放入知识库或公共记忆。

知识库

对于项目文档、制度和产品手册，通常需要创建知识库并上传文档（完整操作见知识库）；检索时，在用户记忆之外传入 knowledgebase_ids，让回答同时参考项目级知识。

{
  "user_id": "memos_user_123",
  "query": "结合我的情况和公司制度，判断这笔费用能不能报销",
  "knowledgebase_ids": ["kb_finance_policy"]
}

公共记忆

公共记忆适合保存项目公告、团队经验、通用规则等轻量信息。如果一条消息需要被项目下所有用户共享，可以在写入时开启 allow_public，让它进入项目级公共记忆。

{
  "user_id": "memos_user_123",
  "allow_public": true,
  "messages": [
    { "role": "user", "content": "本季度报销截止时间是 6 月 25 日。" }
  ]
}

检索记忆时，用户个人记忆与公共记忆会被共同检索并召回相关内容。

记忆种类

时间感知