メインコンテンツへ移動

SerializedMemoryConfig

SerializedMemoryConfig は、保存された Agent レコードに格納される、JSON でシリアライズ可能な Memory 設定のサブセットです。ランタイムは、設定済みの Mastra インスタンスに対して vector ID と 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
ベクトルストアの識別子。この 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 など、シリアライズできないフィールドは除外されます。
SerializedMemoryOptions

readOnly?:

boolean
Memory を読み取り専用として扱い、新しいメッセージを保存しません。

lastMessages?:

number | false
コンテキストに含める最近のメッセージ数。メッセージ履歴を完全に無効にするには false を指定します（メッセージの読み込みも保存も行われません）。

semanticRecall?:

boolean | SemanticRecall
セマンティックリコールの設定。完全な構造については Memory クラスのリファレンスを参照してください。

generateTitle?:

boolean | { model: ModelRouterModelId; instructions?: string }
タイトル生成の設定。model（"provider/model" 形式）と任意の instructions を含むオブジェクトを渡します。

observationalMemory?:

boolean | SerializedObservationalMemoryConfig
長期間保持する事実の抽出。デフォルト設定で有効にするには true を渡し、Observer/Reflector モデル、スコープ、アクティベーション動作を上書きするにはオブジェクトを渡します。

SerializedObservationalMemoryConfig
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 のしきい値、バッファリング）。
On this page