Bucket y scope son límites diferentes
Bucket es el namespace de almacenamiento. scope es el límite de proyecto, sesión o equipo que se usa para la recuperación. Mantenerlos separados permite que una cuenta tenga varios proyectos sin que sus memorias se mezclen.
- bucket — namespace de almacenamiento, usado habitualmente para la memoria del proceso del agente.
- scope — agrupación explícita de proyecto/sesión/equipo aplicada en el momento de la recuperación.
- path — ubicación lógica dentro de un scope, filtrada con un patrón ILIKE.
- team_id — restringe la recuperación a un equipo al que el llamante ya puede acceder.
Recuperar dentro de un scope
Pase scope en una búsqueda para mantener los resultados dentro del límite de un proyecto. scope se valida contra el token autenticado y no puede ampliar el acceso.
GET /v1/memories/search?query=MCP%20token%20context&scope=memory-os&memory_type=semantic&limit=5
X-API-Key: <your-assigned-api-key>Scope desde el SDK
El cliente de TypeScript usa los mismos argumentos de límite, de modo que la captura y la recuperación permanecen dentro del proyecto para el que el caller está autorizado.
const search = await client.search('MCP token context', {
scope: 'memory-os',
memoryType: 'semantic',
candidateCount: 20,
explain: true,
});Flujos de roles
Usuario de ChatGPT
Dale a ChatGPT acceso duradero a tus preferencias de XMemo, datos de proyecto, decisiones y TODOs sin pegar fichas bearer en un chat.
Guarde una nota de preferencia sintética o de proyecto, inicie un nuevo chat y luego pida a ChatGPT que la recuerde a través de XMemo antes de continuar el trabajo.
Copiloto / Codex desarrollador
Lleve decisiones de repo, convenciones de codificación, notas de corrección de errores e historial de tareas entre los agentes IDE y CLI.
Grabe una decisión de base de código o corrección de errores, y luego pida al siguiente agente IDE o CLI que recuerde el contexto XMemo relevante antes de editarlo.
Equipo / propietario del piloto de la empresa
Evalúe la memoria compartida con controles de cuenta, atribución de origen, flujos de trabajo export/delete y pruebas de configuración seguras para los revisores.
Haga que un miembro piloto guarde una memoria sintética del equipo, confirme la atribución de origen en XMemo, luego revise delete/export y las rutas de soporte.
Fuente: Controles de Memory Console