최근 업데이트된 지식 및 메모리 관리 (Knowledge and Memory Management) 문서는 방향성 1–3을 확정하여, 지속적인 컨텍스트 (persistent context) 및 검색 (retrieval)을 위한 핵심 아키텍처를 고정했습니다. 이 세 가지 방향성은 이전에 초안 상태였으나, 이번 확정 기록을 통해 데이터 수명 (data lifetimes), 인덱싱 전략 (indexing strategies), 그리고 통합 계약 (integration contracts)에 대한 모호함을 제거했습니다. 다음은 상태 유지 추론 시스템 (stateful reasoning systems)을 구축하는 구현자들을 위해 각 방향성이 제공하는 내용입니다.

방향성 1: 핵심 메모리 아키텍처 (Core Memory Architecture)

이 방향성은 표준 메모리 모델을 정의합니다. 확정된 설계는 단기 메모리 (short-term, 휘발성 세션 버퍼)와 장기 메모리 (long-term, 내구성이 있고 감쇠 가중치가 적용된 저장소)를 분리합니다. 핵심 결정 사항은 명시적인 우선순위 버킷 (priority buckets)입니다. high_priority로 태그된 모든 메모리 항목은 제거 임계값 (eviction thresholds)을 우회합니다. 이를 통해 모든 항목이 LRU (Least Recently Used) 가지치기 대상인지에 대한 이전의 모호함을 제거했습니다.

이제 구현에는 priority 파라미터를 받는 store() 호출과, 쿼리 및 코사인 유사도 (cosine similarity) 점수를 위한 선택적 threshold를 받는 recall() 함수가 필요합니다. 아래 예시는 최소한의 계약을 보여줍니다:

class DirectedMemory:
    def __init__(self):
        self._short = []
...

확정 사항에 따라 store()는 내부 루프에서 반드시 동기적 (synchronous)이어야 하며, 비동기 (async) 래퍼는 선택 사항입니다. 이는 메모리 쓰기가 언제 디스크로 플러시 (flush)되는지에 대한 이전의 혼란을 방지합니다.

방향성 2: 검색 파이프라인 (Retrieval Pipeline)

방향성 2는 인덱싱 및 쿼리 흐름을 다룹니다. 최종 버전은 증분 인덱싱 (incremental indexing)을 표준화합니다. 즉, 전체 재구축 없이 새로운 항목이 인덱스에 추가됩니다. 이제 파이프라인은 배치 쓰기 (batch writes) 후 commit 호출을 예상하며, 이는 영속화 (persistence) 전에 인메모리 병합 (in-memory merge)을 트리거합니다. 해당 문서는 실험적인 벡터 전용 모드 (vector-only mode)를 제거했습니다. 모든 검색기 (retrievers)는 결정론적 매칭 (deterministic matching)을 위한 키워드 폴백 (keyword fallback)도 반드시 지원해야 합니다. 이는 디버깅 및 감사 추적 (audit trails)에 매우 중요합니다.

방향성 3: 외부 통합 (External Integration)

방향성 3은 외부 지식 소스(APIs, 데이터베이스, 파일 시스템)가 메모리 그래프(memory graph)에 어떻게 연결되는지를 정의합니다. 확정된 핵심 기능은 MemoryAdapter 인터페이스입니다. 모든 어댑터는 sync 및 read 프리미티브(primitives)를 구현해야 하며, 소스 간의 키 충돌(key collisions)을 방지하기 위해 필수적으로 namespace 파라미터를 포함해야 합니다. 이번 업데이트에서는 초안 2(Draft 2)의 자동 병합(auto-merge) 동작이 폐기(deprecate)되었습니다. 이제 어댑터는 외부 데이터가 저장된 메모리와 중복될 경우 명시적인 충돌 신호(conflict signals)를 반환합니다. 핸들러(Handlers)는 이를 ConflictWarning 객체로 전달받으며, 정책(덮어쓰기, 건너뛰기 또는 우선순위에 따른 병합)을 적용할 수 있습니다.

이 세 가지 방향성은 이전 반복 단계(iterations)에서의 추측 요소를 제거합니다. 만약 초안을 바탕으로 프로토타입을 구축했다면, 방향성 1의 우선순위 의미론(priority semantics)과 방향성 3의 어댑터 시그니처(adapter signature)에서 가장 큰 어려움을 겪을 것으로 예상됩니다. 확정 기록에는 이전 메서드 이름을 새 이름으로 매핑하는 마이그레이션 가이드(migration guide)가 포함되어 있으니, 의존성 잠금(dependency lock)을 업데이트하기 전에 반드시 읽어보는 것이 좋습니다.