SerializedMemoryConfig

SerializedMemoryConfig 是 Memory 設定中可序列化為 JSON、存在已儲存 Agent 記錄上的子集。執行階段會針對已設定的 Mastra 執行個體解析 vector 與 embedder ID，將其還原為 Memory 執行個體。

這是 BuilderAgentDefaults.memory 與 EditorAgentNamespace.create({ memory }) 使用的型別。

使用範例

src/mastra/index.ts

import { MastraEditor } from '@mastra/editor'

new MastraEditor({
  builder: {
    enabled: true,
    configuration: {
      agent: {
        memory: {
          observationalMemory: true,
          options: { lastMessages: 50 },
        },
      },
    },
  },
})

屬性

vector?:

string | false

Vector store 識別碼。Vector 執行個體必須向 Mastra 執行個體註冊，才能從此 ID 解析。設為 false 可停用向量搜尋。

embedder?:

string

格式為 "provider/model" 的 embedding 模型 ID（例如 "openai/text-embedding-3-small"）。

embedderOptions?:

Omit<MastraEmbeddingOptions, 'telemetry'>

傳給 embedder 的選項。Telemetry 選項會移除。

options?:

SerializedMemoryOptions

Memory 行為設定。省略 working memory 與執行緒等不可序列化欄位。

SerializedMemoryOptions

readOnly?:

boolean

將 Memory 視為唯讀，不儲存新訊息。

lastMessages?:

number | false

要納入 context 的最近訊息數量；設為 false 則完全停用訊息歷程記錄（不載入或儲存訊息）。

semanticRecall?:

boolean | SemanticRecall

語意回憶設定。完整結構請參閱 Memory 類別參考。

generateTitle?:

boolean | { model: ModelRouterModelId; instructions?: string }

標題產生設定。傳入包含 model（"provider/model" 格式）和選用 instructions 的物件。

observationalMemory?:

boolean | SerializedObservationalMemoryConfig

長期事實擷取。傳入 true 以預設值啟用，或傳入物件覆寫 Observer／Reflector 模型、範圍和啟用行為。

SerializedObservationalMemoryConfig

model?:

string

Observer 與 Reflector 共用的模型 ID（例如 "google/gemini-2.5-flash"）。

scope?:

'resource' | 'thread'

Observation 的範圍是資源或單一執行緒。

activateAfterIdle?:

ObservationalMemoryActivationTTL

強制啟用已緩衝 observation 前的閒置 TTL。

activateOnProviderChange?:

boolean

Actor 模型變更時，強制啟用已緩衝的 observation。

shareTokenBudget?:

boolean

在訊息與 observation 之間共用 token 預算。

temporalMarkers?:

boolean

針對訊息之間的長時間停頓，保存行內時間間隔標記。

retrieval?:

boolean | { vector?: boolean; scope?: 'thread' | 'resource' }

啟用擷取模式的 observation 群組，作為指向原始訊息歷程記錄的永久指標。

observation?:

SerializedObservationalMemoryObservationConfig

Observer 步驟設定（模型、token 門檻、緩衝）。

reflection?:

SerializedObservationalMemoryReflectionConfig

Reflector 步驟設定（模型、observation token 門檻、緩衝）。

相關內容

• Memory 類別：此設定會還原成的執行階段型別。
• Observational Memory：完整的 Observational Memory 參考。
• BuilderAgentDefaults：此型別固定為 Builder 預設值的位置。
• Agent Builder：Memory：概念與完整範例。