SerializedMemoryConfig

SerializedMemoryConfig est le sous-ensemble sérialisable en JSON de la configuration de Memory qui se trouve dans l’enregistrement d’un Agent stocké. Au moment de l’exécution, Mastra le réhydrate en instance de Memory en résolvant les ID du stockage vectoriel et de l’embedder à partir de l’instance Mastra configurée.

Il s’agit du type utilisé par BuilderAgentDefaults.memory et par EditorAgentNamespace.create({ memory }).

Exemple d’utilisation

src/mastra/index.ts

import { MastraEditor } from '@mastra/editor'

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

Propriétés

vector?:

string | false

Identifiant du stockage vectoriel. L’instance vectorielle doit être enregistrée auprès de l’instance Mastra afin d’être résolue à partir de cet ID. Définissez la valeur sur false pour désactiver la recherche vectorielle.

embedder?:

string

ID du modèle d’embedding au format "provider/model" (par exemple, "openai/text-embedding-3-small").

embedderOptions?:

Omit<MastraEmbeddingOptions, 'telemetry'>

Options transmises à l’embedder. Les options de télémétrie sont supprimées.

options?:

SerializedMemoryOptions

Configuration des comportements de la mémoire. Omet les champs non sérialisables tels que la mémoire de travail et les fils.

SerializedMemoryOptions

readOnly?:

boolean

Traite la mémoire comme étant en lecture seule : aucun nouveau message n’est stocké.

lastMessages?:

number | false

Nombre de messages récents à inclure dans le contexte, ou false pour désactiver entièrement l’historique des messages (les messages ne sont ni chargés ni enregistrés).

semanticRecall?:

boolean | SemanticRecall

Configuration du rappel sémantique. Consultez la référence de la classe Memory pour connaître la structure complète.

generateTitle?:

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

Configuration de la génération des titres. Transmettez un objet contenant model (au format "provider/model") et éventuellement instructions.

observationalMemory?:

boolean | SerializedObservationalMemoryConfig

Extraction durable des faits. Transmettez true pour l’activer avec les valeurs par défaut, ou un objet pour remplacer les modèles Observer et Reflector, la portée et le comportement d’activation.

SerializedObservationalMemoryConfig

model?:

string

ID du modèle utilisé à la fois par l’Observer et le Reflector (par exemple, "google/gemini-2.5-flash").

scope?:

'resource' | 'thread'

Indique si la portée des observations correspond à une ressource ou à un seul fil.

activateAfterIdle?:

ObservationalMemoryActivationTTL

TTL d’inactivité avant de forcer l’activation des observations mises en mémoire tampon.

activateOnProviderChange?:

boolean

Force l’activation des observations mises en mémoire tampon lorsque le modèle de l’acteur change.

shareTokenBudget?:

boolean

Partage le budget de tokens entre les messages et les observations.

temporalMarkers?:

boolean

Conserve des marqueurs temporels intégrés pour les longues pauses entre les messages.

retrieval?:

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

Active les groupes d’observations en mode de récupération comme pointeurs durables vers l’historique brut des messages.

observation?:

SerializedObservationalMemoryObservationConfig

Configuration de l’étape Observer (modèle, seuils de tokens et mise en mémoire tampon).

reflection?:

SerializedObservationalMemoryReflectionConfig

Configuration de l’étape Reflector (modèle, seuils de tokens des observations et mise en mémoire tampon).

Voir aussi

• Classe Memory : type d’exécution dans lequel cette configuration est réhydratée.
• Observational Memory : référence complète d’Observational Memory.
• BuilderAgentDefaults : emplacement où ce type est défini comme valeur par défaut du Builder.
• Agent Builder : Memory : concept et exemples détaillés.