Resources / Memory
Memory
Agentic memory: documents cut into chunks with embeddings and metadata, searched by similarity together with keyword and metadata filters. Shared by the project or kept for one agent, kept in Etorm storage, erased when deleted.
Overview
| API | intelligence.etorm.com/v1alpha1 |
| Resource | memories (cluster-scoped inside its cluster) |
| Short names | mem |
| Available in | project clusters only |
| Status | written by a controller through /status |
Minimal example
apiVersion: intelligence.etorm.com/v1alpha1
kind: Memory
metadata:
name: example
spec:
embeddingEndpointRef:
name: "<name>"
Spec
| Field | Type | Required | Default | Allowed | Description |
embeddingEndpointRef | reference to InferenceEndpoint | yes | | | The embedding InferenceEndpoint that turns text into vectors. Cannot be changed: vectors of two models do not compare. |
scope | string (one of) | | "Shared" | Shared, Agent | Shared is for any identity with the data role; Agent is for one agent (and the project's owners). |
agentRef | object | | | | For scope Agent: the agent whose memory this is. |
agentRef.name | string | yes | | length 1 to 63 | Name of the Agent. |
defaultTtlSeconds | integer | | 0 | 0 to 31536000 | How long a document is kept unless it says otherwise; 0 keeps it. |
chunk | object | | {} | | How documents are cut. |
chunk.sizeChars | integer | | 1200 | 200 to 8000 | Characters per chunk. |
chunk.overlapChars | integer | | 200 | 0 to 2000 | Characters a chunk repeats from the one before. |
sources | list of object | | | up to 8 items | Objects to ingest from buckets of this project. Reserved: nothing is ingested from it. |
sources[].bucketRef | reference to Bucket | yes | | | The bucket. |
sources[].prefix | string | | | up to 1024 characters | Only objects whose keys start with this. |
limits | object | | {} | | Size limits. |
limits.maxChunks | integer | | 100000 | 1 to 1000000 | Chunks the memory may hold. |
Status
| Field | Type | Required | Default | Allowed | Description |
phase | string | | | | Pending, Ready or Failed. |
url | string | | | | The memory's data address. |
bucket | string | | | | Where the memory's data is kept (platform storage). |
dimensions | integer | | | | Length of the vectors. |
documents | integer | | | | Documents held. |
chunks | integer | | | | Chunks held. |
lastWriteAt | string | | | | When it last changed (RFC 3339). |
usage | object | | | | What the memory uses. |
usage.storageBytes | integer | | | | Bytes stored. |
conditions | list of object | | | | Detailed state; Ready says whether the memory accepts reads and writes. |
conditions[].type | string | | | | Aspect. |
conditions[].status | string | | | | True or False. |
conditions[].reason | string | | | | Machine-readable reason. |
conditions[].message | string | | | | Human-readable detail. |
Columns in listings
| Column | From |
|---|
| Scope | .spec.scope |
| Documents | .status.documents |
| Chunks | .status.chunks |
| Phase | .status.phase |
| Detail | .status.conditions[0].message |
All resources