Geltungsbereiche

Bucket und Scope sind unterschiedliche Grenzen

Ein Bucket ist der Speichernamensraum. Ein Scope ist die für Abrufe genutzte Projekt-, Sitzungs- oder Teamgrenze. Ihre Trennung ermöglicht es einem Konto, mehrere Projekte zu verwalten, ohne dass deren Erinnerungen ineinander übergehen.

• bucket — Speichernamensraum, typischerweise work für den Prozessspeicher von Agenten.
• scope — explizite Projekt-, Sitzungs- oder Teamgruppierung beim Abruf.
• path — logischer Speicherort innerhalb eines Scopes, gefiltert über ein ILIKE-Muster.
• team_id — beschränkt den Abruf auf ein Team, auf das der Aufrufer bereits Zugriff hat.

Innerhalb eines Scopes abrufen

Übergeben Sie bei einer Suche den Scope, um Ergebnisse auf eine Projektgrenze zu beschränken. Der Scope wird gegen das authentifizierte Token validiert; er kann den Zugriff nicht erweitern.

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

Scope über das SDK angeben

Der TypeScript-Client akzeptiert dieselben Grenzargumente, sodass Erfassung und Abruf innerhalb des Projekts bleiben, für das der Aufrufer autorisiert ist.

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