Escopos

Bucket e escopo são limites diferentes

Bucket é o namespace de armazenamento. Escopo é o limite de projeto, sessão ou equipe usado na recuperação. Mantê-los separados permite que uma conta contenha vários projetos sem que suas memórias se misturem.

• bucket — namespace de armazenamento, geralmente work para a memória do processo do agente.
• scope — agrupamento explícito de projeto/sessão/equipe aplicado no momento da recuperação.
• path — localização lógica dentro de um escopo, filtrada com um padrão ILIKE.
• team_id — restringe a recuperação a uma equipe à qual o chamador já tenha acesso.

Recupere dentro de um escopo

Passe o escopo em uma busca para manter os resultados dentro do limite de um projeto. O escopo é validado em relação ao token autenticado; ele não pode ampliar o acesso.

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

Escopo pelo SDK

O cliente TypeScript recebe os mesmos argumentos de limite, portanto a captura e a recuperação permanecem dentro do projeto para o qual o chamador está autorizado.

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