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

# SerializedMemoryConfig

`SerializedMemoryConfig` 是 [`Memory`](https://mastra.zisheng.pro/zh-TW/reference/memory/memory-class) 設定中可序列化為 JSON、存在已儲存 Agent 記錄上的子集。執行階段會針對已設定的 `Mastra` 執行個體解析 vector 與 embedder ID，將其還原為 `Memory` 執行個體。

這是 [`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 識別碼。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 與執行緒等不可序列化欄位。

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

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

**options.semanticRecall** (`boolean | SemanticRecall`): 語意回憶設定。完整結構請參閱 Memory 類別參考。

**options.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 類別](https://mastra.zisheng.pro/zh-TW/reference/memory/memory-class)：此設定會還原成的執行階段型別。
- [Observational Memory](https://mastra.zisheng.pro/zh-TW/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)：概念與完整範例。