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

# 직렬화된 Memory 구성

`SerializedMemoryConfig`JSON 직렬화 가능한 하위 집합입니다.[`Memory`](https://mastra.zisheng.pro/ko/reference/memory/memory-class)저장된 Agent 기록에 있는 구성입니다. 런타임은 이를 다시 수화합니다.`Memory`구성된 인스턴스에 대해 벡터 및 임베더 ID를 확인하여 인스턴스`Mastra`사례.

[`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로 벡터 인스턴스를 확인할 수 있도록 해당 인스턴스가 Mastra 인스턴스에 등록되어 있어야 합니다. 벡터 검색을 비활성화하려면 false로 설정하세요.

**embedder** (`string`): "provider/model" 형식의 임베딩 Model ID입니다(예: "openai/text-embedding-3-small").

**embedderOptions** (`Omit<MastraEmbeddingOptions, 'telemetry'>`): 임베더에 전달되는 옵션입니다. 텔레메트리 옵션은 제거됩니다.

**options** (`SerializedMemoryOptions`): Memory 동작을 위한 구성입니다. 작업 Memory 및 스레드처럼 직렬화할 수 없는 필드는 제외됩니다.

**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를 전달하고, 관찰자/성찰자 Model, 범위 및 활성화 동작을 재정의하려면 객체를 전달합니다.

## `SerializedObservationalMemoryConfig`

**model** (`string`): Observer와 Reflector가 모두 사용하는 Model ID입니다(예: "google/gemini-2.5-flash").

**scope** (`'resource' | 'thread'`): 관찰 범위를 리소스 또는 단일 스레드로 지정할지 여부입니다.

**activateAfterIdle** (`ObservationalMemoryActivationTTL`): 버퍼링된 관찰을 강제로 활성화하기 전까지의 비활성 TTL입니다.

**activateOnProviderChange** (`boolean`): 행위자 Model이 변경될 때 버퍼링된 관찰을 강제로 활성화합니다.

**shareTokenBudget** (`boolean`): 메시지와 관찰 간에 토큰 예산을 공유합니다.

**temporalMarkers** (`boolean`): 메시지 사이의 긴 공백을 나타내는 인라인 시간 간격 마커를 유지합니다.

**retrieval** (`boolean | { vector?: boolean; scope?: 'thread' | 'resource' }`): 검색 모드 관찰 그룹을 원시 메시지 기록을 가리키는 영구 포인터로 활성화합니다.

**observation** (`SerializedObservationalMemoryObservationConfig`): Observer 단계 구성입니다(Model, 토큰 임계값, 버퍼링).

**reflection** (`SerializedObservationalMemoryReflectionConfig`): Reflector 단계 구성입니다(Model, 관찰 토큰 임계값, 버퍼링).

## 관련된

- [Memory 클래스](https://mastra.zisheng.pro/ko/reference/memory/memory-class): 이 구성이 수화되는 런타임 유형입니다.
- [관찰 기억](https://mastra.zisheng.pro/ko/reference/memory/observational-memory): 전체 관찰 Memory 참조입니다.
- [BuilderAgentDefaults](https://agent-builder.mastra.ai/reference/builder-agent-defaults): 이 유형이 Builder 기본값으로 고정되어 있는 곳입니다.
- [Agent Builder: Memory](https://agent-builder.mastra.ai/memory): 개념 및 작업 사례.