> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-HK/llms.txt

# SerializedMemoryConfig

`SerializedMemoryConfig` 是 [`Memory`](https://mastra.zisheng.pro/zh-HK/reference/memory/memory-class) 設定中可序列化為 JSON 的子集，儲存於已保存的 agent 記錄上。runtime 會根據已設定的 `Mastra` instance 解析 vector 及 embedder ID，將其還原為 `Memory` instance。

這是 [`BuilderAgentDefaults.memory`](https://agent-builder.mastra.ai/reference/builder-agent-defaults) 及 `EditorAgentNamespace.create({ memory })` 所使用的類型。

## 使用範例

```typescript
import { MastraEditor } from '@mastra/editor'

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

## 屬性

**vector** (`string | false`): Vector store 識別碼。必須在 Mastra instance 中註冊該 vector instance，才能透過此 ID 解析。設為 false 可停用 vector search。

**embedder** (`string`): 格式為 "provider/model" 的 embedding model ID（例如 "openai/text-embedding-3-small"）。

**embedderOptions** (`Omit<MastraEmbeddingOptions, 'telemetry'>`): 傳遞至 embedder 的選項。Telemetry 選項會被移除。

**options** (`SerializedMemoryOptions`): Memory 行為的設定。當中不包括 working memory 及 threads 等不可序列化的欄位。

**options.readOnly** (`boolean`): 將 memory 視為唯讀——不會儲存新訊息。

**options.lastMessages** (`number | false`): 要加入 context 的近期訊息數目；設為 false 則完全停用訊息記錄（不會載入或儲存訊息）。

**options.semanticRecall** (`boolean | SemanticRecall`): Semantic recall 設定。完整結構請參閱 Memory class 參考資料。

**options.generateTitle** (`boolean | { model: ModelRouterModelId; instructions?: string }`): 標題產生設定。傳入包含 model（格式為 "provider/model"）及可選 instructions 的 object。

**observationalMemory** (`boolean | SerializedObservationalMemoryConfig`): 長期事實擷取。傳入 true 可使用預設值啟用，或傳入 object 以覆寫 observer／reflector model、scope 及啟用行為。

## `SerializedObservationalMemoryConfig`

**model** (`string`): Observer 及 Reflector 共用的 model ID（例如 "google/gemini-2.5-flash"）。

**scope** (`'resource' | 'thread'`): 指定 observations 的 scope 是 resource 還是單一 thread。

**activateAfterIdle** (`ObservationalMemoryActivationTTL`): 強制啟用已緩衝 observation 前的閒置 TTL。

**activateOnProviderChange** (`boolean`): 當 actor model 變更時，強制啟用已緩衝的 observations。

**shareTokenBudget** (`boolean`): 讓訊息與 observations 共用 token 預算。

**temporalMarkers** (`boolean`): 當訊息之間相隔較長時間時，保留 inline 時間間隔標記。

**retrieval** (`boolean | { vector?: boolean; scope?: 'thread' | 'resource' }`): 啟用 retrieval mode observation groups，作為指向原始訊息記錄的持久指標。

**observation** (`SerializedObservationalMemoryObservationConfig`): Observer 步驟設定（model、token threshold、buffering）。

**reflection** (`SerializedObservationalMemoryReflectionConfig`): Reflector 步驟設定（model、observation token threshold、buffering）。

## 相關資料

- [Memory class](https://mastra.zisheng.pro/zh-HK/reference/memory/memory-class)：此設定在 runtime 中還原成的類型。
- [Observational memory](https://mastra.zisheng.pro/zh-HK/reference/memory/observational-memory)：完整的 observational memory 參考資料。
- [BuilderAgentDefaults](https://agent-builder.mastra.ai/reference/builder-agent-defaults)：此類型被指定為 Builder 預設值的位置。
- [Agent Builder：Memory](https://agent-builder.mastra.ai/memory)：概念及實作範例。