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

# SerializedMemoryConfig

`SerializedMemoryConfig` est le sous-ensemble sérialisable en JSON de la configuration de [`Memory`](https://mastra.zisheng.pro/fr/reference/memory/memory-class) 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`](https://agent-builder.mastra.ai/reference/builder-agent-defaults) et par `EditorAgentNamespace.create({ memory })`.

## Exemple d’utilisation

```typescript
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.

**options.readOnly** (`boolean`): Traite la mémoire comme étant en lecture seule : aucun nouveau message n’est stocké.

**options.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).

**options.semanticRecall** (`boolean | SemanticRecall`): Configuration du rappel sémantique. Consultez la référence de la classe Memory pour connaître la structure complète.

**options.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](https://mastra.zisheng.pro/fr/reference/memory/memory-class) : type d’exécution dans lequel cette configuration est réhydratée.
- [Observational Memory](https://mastra.zisheng.pro/fr/reference/memory/observational-memory) : référence complète d’Observational Memory.
- [BuilderAgentDefaults](https://agent-builder.mastra.ai/reference/builder-agent-defaults) : emplacement où ce type est défini comme valeur par défaut du Builder.
- [Agent Builder : Memory](https://agent-builder.mastra.ai/memory) : concept et exemples détaillés.