Skip to content

User ID vs Agent ID Boundary

What It Is

这页定义 user_idagent_id 的边界。

这是当前记忆系统里最容易被误解的地方之一。

Core Rule

  • agent_id 回答:谁写的
  • user_id 回答:属于谁 / 哪个知识域

Why It Matters

如果把两者混为一谈,就会出现:

  • 本该共享的知识被割裂
  • 本该隔离的知识被混在一起
  • 搜索边界不清晰
  • 追溯来源变得困难

agent_id

它主要用于:

  • 记录写入来源
  • 审计
  • 溯源

user_id

它主要用于:

  • 决定搜索边界
  • 决定知识共享域
  • 区分个人记忆和团队记忆

Practical Guidance

个人模式

  • 每个 Agent 绑定自己的 user_id
  • 适合强私域上下文

团队模式

  • 多个 Agent 使用同一个团队级 user_id
  • 适合共享知识池

混合模式

  • 日常执行使用个人 user_id
  • 稳定共识和团队方法写入团队级 user_id

这是最推荐的长期模式。

Common Mistake

误以为只要 agent_id 不同,知识就自动隔离。
实际上,真正影响共享边界的是 user_id

TeamOS · docs as code · canon=权威知识,drafts=候选区