Périmètres

Bucket et périmètre constituent des frontières distinctes

Le bucket est l'espace de noms du stockage. Le périmètre correspond à la frontière de projet, de session ou d'équipe appliquée lors de l'extraction. Leur séparation stricte permet à un même compte d'héberger plusieurs projets sans que leurs mémoires n'interfèrent entre elles.

• bucket — espace de noms de stockage, généralement work pour la mémoire de traitement des agents.
• scope — regroupement explicite par projet, session ou équipe appliqué au moment de l'extraction.
• path — emplacement logique au sein d'un périmètre, filtré au moyen d'un motif ILIKE.
• team_id — restreint l'extraction à une équipe à laquelle l'appelant a déjà accès.

Extraire au sein d'un même périmètre

Transmettez scope lors d'une recherche afin de confiner les résultats à la frontière d'un seul projet. Le périmètre est validé par rapport au jeton authentifié ; il ne peut pas étendre les privilèges d'accès.

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

Gérer le périmètre depuis le SDK

Le client TypeScript accepte les mêmes paramètres de frontière, assurant que la capture et le rappel restent circonscrits au projet pour lequel l'appelant est dûment autorisé.

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