범위

bucket과 scope는 서로 다른 경계입니다

Bucket은 저장 namespace입니다. Scope는 retrieval에 사용되는 프로젝트, 세션 또는 팀 경계입니다. 이 둘을 분리해야 하나의 계정에 여러 프로젝트를 담으면서 메모리가 서로 섞이지 않습니다.

• bucket — 에이전트 프로세스 메모리에 흔히 work로 사용하는 저장 namespace.
• scope — retrieval 시 적용되는 명시적 프로젝트/세션/팀 그룹.
• path — scope 내부의 논리적 위치이며 ILIKE 패턴으로 필터링합니다.
• team_id — 호출자가 이미 접근할 수 있는 한 팀으로 retrieval을 제한합니다.

하나의 scope 안에서 retrieval하기

결과를 한 프로젝트 경계 안에 유지하려면 search에 scope를 전달하세요. Scope는 인증된 token에 대해 검증되며, 접근 범위를 넓힐 수 없습니다.

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도 같은 경계 인수를 사용하므로, 캡처와 recall이 호출자에게 권한이 있는 프로젝트 안에 머뭅니다.

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