본문으로 건너뛰기

직렬화된 Memory 구성

SerializedMemoryConfigJSON 직렬화 가능한 하위 집합입니다.Memory저장된 Agent 기록에 있는 구성입니다. 런타임은 이를 다시 수화합니다.Memory구성된 인스턴스에 대해 벡터 및 임베더 ID를 확인하여 인스턴스Mastra사례.

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

embedder?:

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

embedderOptions?:

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

options?:

SerializedMemoryOptions
Memory 동작을 위한 구성입니다. 작업 Memory 및 스레드처럼 직렬화할 수 없는 필드는 제외됩니다.
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를 전달하고, 관찰자/성찰자 Model, 범위 및 활성화 동작을 재정의하려면 객체를 전달합니다.

SerializedObservationalMemoryConfig
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, 관찰 토큰 임계값, 버퍼링).
On this page