v3 严格隔离:四元组

v3 严格隔离:四元组

本节摘要:生产级运行的安全核心是「隔离」——不同团队、不同 Agent、不同用户的数据不能串。v3 数据面执行严格的隔离四元组:team_id / agent_id / user_id / session_id,任何记忆操作都必须带上这四个键,系统据此强制隔离。本节讲清四元组如何工作、它相对早期版本的安全提升、以及「漏带键」为什么会被拒绝。

一、为什么需要严格隔离:多团队多 Agent 的数据不能串

生产环境里,一套系统服务多个团队、多个 Agent、多个用户。如果不强制隔离,数据会串:

不隔离的危险
  Team A 的 Agent 查记忆 → 查到了 Team B 的记忆?
  → 跨团队数据泄漏!
  
  User A 的私有记忆 → 被 User B 召回?
  → 跨用户隐私泄漏!
  
  Agent Scout 的 Loadout → 影响到 Agent Builder?
  → 跨 Agent 串扰!
​

关键概念:多租户系统的安全底线是「数据绝不串」。v3 的严格隔离四元组就是这个底线的工程实现——所有记忆操作必须明确「这是哪个团队、哪个 Agent、哪个用户、哪个会话的」,系统据此隔离,不带就拒绝。

二、隔离四元组:team / agent / user / session

四个键各有隔离职责:

四元组的隔离职责
  team_id   → 团队隔离(Team A 看不到 Team B)
  agent_id  → Agent 隔离(Scout 的不影响 Builder)
  user_id   → 用户隔离(你的 private 别人看不到)
  session_id→ 会话隔离(不同会话的状态独立)
​

前三个(team/agent/user)通常必填,第四个(session)在某些场景可选(如不需要会话隔离的全局资产)。但绝大多数记忆操作都要带全四元组,系统据此隔离。

三、强制隔离:漏带键即拒绝

v3 的「严格」体现在:记忆操作不带四元组,直接拒绝,而非「猜测默认值」:

严格隔离的执行
  记忆操作(如 recall)
    ├─ 检查:带了 team_id? agent_id? user_id?
    ├─ 都带 → 按四元组过滤召回
    └─ 漏带 → 拒绝(返回错误,而非猜默认)
  
  → 宁可拒绝,也不「猜」 → 避免隔离漏洞
​

⚠️ 注意:这种「严格拒绝」是相对早期版本的重大安全提升。早期版本可能允许某些操作不带全键(导致潜在串扰),v3 一律要求带全。升级到 v3 时,如果你的代码有「漏带键」的调用,会开始报错——这是安全收紧的体现,要修代码补全键,而非抱怨「v3 不好用」。

四、四元组与召回的衔接

四元组与第 3 章装配过滤、第 8 章 sessionInit 直接相关:

四元组在召回里的作用
  sessionInit 确定 team/agent/task(第8章)
    → 即 team_id, agent_id
  auth/systemUser 确定 user_id(第8章)
    → 即 user_id
  会话本身有 session_id
    → 即 session_id
  
  四元组齐备 → 召回时按四元组过滤
    → 只召回「该团队、该 Agent、该用户可见、该会话相关」的记忆
    → 隔离在召回层强制执行
​

这就是为什么第 8 章 sessionInit 要「确定三元组」——它不只是为了装配精准,更是为了隔离安全。四元组不齐,召回既不精准也不安全。

五、v3 隔离的生产价值

严格四元组隔离带来的生产价值,主要体现在「多租户安全」:

v3 隔离的生产价值
  ① 多团队共存
     一套系统服务多个团队,数据严格隔离,互不干扰
  
  ② 多 Agent 共队不串
     同一团队多个 Agent,各有 Loadout,不互相串扰
  
  ③ 隐私可控
     private 资产严格隔离,user_id 限定只有 Owner 能看
  
  ④ 合规友好
     严格隔离满足数据合规要求(如企业数据不出团队)
​

💡 技巧:v3 的严格隔离让这套系统「敢用在生产多租户场景」。如果你的团队要对外提供服务(多个客户团队共用一套),v3 的隔离是必须的——早期版本的宽松隔离在生产多租户里有泄漏风险。评估能否上生产,先确认是不是 v3(或开启了严格隔离)。

本节要点回顾

1. 隔离底线:多租户数据绝不串——跨团队/用户/Agent 串扰都是安全事故。
2. 四元组:team_id/agent_id/user_id/session_id,各隔离一个维度,前三个通常必填。
3. 严格即拒绝:漏带键直接拒绝,不猜默认——v3 相对早期的重大安全提升。
4. 与召回衔接:sessionInit 定三元组 + user_id,四元组齐备召回才既精准又安全。
5. 生产价值:多团队共存、多 Agent 不串、隐私可控、合规友好——敢用于多租户生产的前提。

下一节看更具体的安全清单——API Key/CORS/凭证注入/租户隔离的生产配置。