Memory stores
A MemoryStore holds long-term memory records with provenance, recalled by hybrid full-text and vector search.
A MemoryStore holds long-term memory records with provenance, recalled by hybrid full-text and vector search. The records are Sylphx Knowledge episodes in the store's Knowledge spaces, read and written as the caller. Agents name the stores they use; a store may be shared by many agents.
Service Sylphx Agents · Resource type agents.sylphx.com/MemoryStore · Name pattern orgs/{org}/projects/{project}/envs/{env}/memory_stores/{memory_store} · Shape spec_status
Fields
| Field | Type | What it is |
|---|---|---|
name | string | orgs/{org}/projects/{project}/envs/{env}/memory_stores/{memory_store}. |
uid | string | mst_<cell><ulid>; never reused. Output only. |
meta | ResourceMeta | Resource metadata. |
spec | MemoryStoreSpec | Desired state. Required. |
status | MemoryStoreStatus | Observed state. Output only. |
Methods
Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.
| Method | Call | What it does |
|---|---|---|
GET | get | Gets a memory store. |
GET | list | Lists memory stores. |
POST | create | Creates a memory store. |
PATCH | update | Updates a memory store. |
DELETE | delete | Deletes a memory store. A store an agent names is refused with RESOURCE_IN_USE; a store with memories is refused with INVALID_STATE unless force is set, which deletes them too. |
get
Gets a memory store.
GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores/memory-store · scope agents:read · effect read · Request, response and examples
list
Lists memory stores.
GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores · scope agents:read · effect read · paginated · Request, response and examples
create
Creates a memory store.
POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores · scope agents:write · effect write · Request, response and examples
update
Updates a memory store.
PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores/memory-store · scope agents:write · effect write · Request, response and examples
delete
Deletes a memory store. A store an agent names is refused with RESOURCE_IN_USE; a store with memories is refused with INVALID_STATE unless force is set, which deletes them too.
DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/memory_stores/memory-store · scope agents:write · effect destructive · Request, response and examples