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

# SerializedMemoryConfig

`SerializedMemoryConfig` は、保存された Agent レコードに格納される、JSON でシリアライズ可能な [`Memory`](https://mastra.zisheng.pro/ja/reference/memory/memory-class) 設定のサブセットです。ランタイムは、設定済みの `Mastra` インスタンスに対して vector ID と 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`): ベクトルストアの識別子。この ID から解決できるよう、vector インスタンスを Mastra インスタンスに登録する必要があります。ベクトル検索を無効にするには false に設定します。

**embedder** (`string`): "provider/model" 形式の Embedding モデル 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`): コンテキストに含める最近のメッセージ数。メッセージ履歴を完全に無効にするには 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'`): 観察のスコープをリソースまたは単一スレッドのどちらにするか。

**activateAfterIdle** (`ObservationalMemoryActivationTTL`): バッファされた観察を強制的にアクティベートするまでの非アクティブ TTL。

**activateOnProviderChange** (`boolean`): Actor モデルが変更されたとき、バッファされた観察を強制的にアクティベートします。

**shareTokenBudget** (`boolean`): メッセージと観察の間で Token 予算を共有します。

**temporalMarkers** (`boolean`): メッセージ間に長い中断があった場合、インラインの時間間隔マーカーを永続化します。

**retrieval** (`boolean | { vector?: boolean; scope?: 'thread' | 'resource' }`): 生のメッセージ履歴への永続的なポインタとして、取得モードの観察グループを有効にします。

**observation** (`SerializedObservationalMemoryObservationConfig`): Observer Step の設定（モデル、Token しきい値、バッファリング）。

**reflection** (`SerializedObservationalMemoryReflectionConfig`): Reflector Step の設定（モデル、観察 Token のしきい値、バッファリング）。

## 関連項目

- [Memory クラス](https://mastra.zisheng.pro/ja/reference/memory/memory-class)：この設定から復元されるランタイム型。
- [Observational Memory](https://mastra.zisheng.pro/ja/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)：概念と実用例。