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

APIintelligence.etorm.com/v1alpha1
Resourcememories (cluster-scoped inside its cluster)
Short namesmem
Available inproject clusters only
Statuswritten by a controller through /status

Minimal example

apiVersion: intelligence.etorm.com/v1alpha1
kind: Memory
metadata:
  name: example
spec:
  embeddingEndpointRef:
    name: "<name>"

Spec

FieldTypeRequiredDefaultAllowedDescription
embeddingEndpointRefreference to InferenceEndpointyesThe embedding InferenceEndpoint that turns text into vectors. Cannot be changed: vectors of two models do not compare.
scopestring (one of)"Shared"Shared, AgentShared is for any identity with the data role; Agent is for one agent (and the project's owners).
agentRefobjectFor scope Agent: the agent whose memory this is.
agentRef.namestringyeslength 1 to 63Name of the Agent.
defaultTtlSecondsinteger00 to 31536000How long a document is kept unless it says otherwise; 0 keeps it.
chunkobject{}How documents are cut.
chunk.sizeCharsinteger1200200 to 8000Characters per chunk.
chunk.overlapCharsinteger2000 to 2000Characters a chunk repeats from the one before.
sourceslist of objectup to 8 itemsObjects to ingest from buckets of this project. Reserved: nothing is ingested from it.
sources[].bucketRefreference to BucketyesThe bucket.
sources[].prefixstringup to 1024 charactersOnly objects whose keys start with this.
limitsobject{}Size limits.
limits.maxChunksinteger1000001 to 1000000Chunks the memory may hold.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestringPending, Ready or Failed.
urlstringThe memory's data address.
bucketstringWhere the memory's data is kept (platform storage).
dimensionsintegerLength of the vectors.
documentsintegerDocuments held.
chunksintegerChunks held.
lastWriteAtstringWhen it last changed (RFC 3339).
usageobjectWhat the memory uses.
usage.storageBytesintegerBytes stored.
conditionslist of objectDetailed state; Ready says whether the memory accepts reads and writes.
conditions[].typestringAspect.
conditions[].statusstringTrue or False.
conditions[].reasonstringMachine-readable reason.
conditions[].messagestringHuman-readable detail.

Columns in listings

ColumnFrom
Scope.spec.scope
Documents.status.documents
Chunks.status.chunks
Phase.status.phase
Detail.status.conditions[0].message

All resources