作用域

Bucket 和 scope 是不同的边界

Bucket 是存储 namespace。Scope 是用于 retrieval 的项目、会话或团队边界。将两者分开，才能让一个 account 保存多个项目而不让它们的 memory 相互渗漏。

• bucket — 存储 namespace，通常作为 agent process memory 的 work。
• scope — 在 retrieval 时应用的明确 project/session/team 分组。
• path — scope 内的逻辑位置，通过 ILIKE pattern 过滤。
• team_id — 将 retrieval 限制在 caller 已经可以访问的一个 team 内。

在一个 scope 内 retrieval

在 search 中传入 scope，让结果保持在一个项目边界内。Scope 会根据 authenticated token 验证，不能扩大 access。

GET /v1/memories/search?query=MCP%20token%20context&scope=memory-os&memory_type=semantic&limit=5
X-API-Key: <your-assigned-api-key>

从 SDK 指定 scope

TypeScript client 使用同样的边界参数，因此 capture 和 recall 会留在 caller 获得授权的项目内。

const search = await client.search('MCP token context', {
  scope: 'memory-os',
  memoryType: 'semantic',
  candidateCount: 20,
  explain: true,
});