CtxVault: 인지 아키텍처 기반의 에이전트 메모리 관리 오픈소스 프레임워크

커뮤니티 반응

작성자가 피드백을 요청한 상태이며, 인지 아키텍처를 실제 인프라로 구현하려는 시도에 대해 긍정적인 관심이 예상된다.

주요 논점

01찬성다수

에이전트의 지식과 행동 절차를 분리하여 관리하는 것이 시스템의 제어력과 일관성을 향상시킨다.

합의점 vs 논쟁점

합의점

에이전트 메모리 설계 시 인지 아키텍처 이론(CoALA)을 참고하는 것이 유익하다.
로컬 환경에서의 메모리 관리는 보안과 검사 가능성 측면에서 장점이 있다.

실용적 조언

에이전트의 페르소나나 복잡한 행동 규칙을 시스템 프롬프트에 넣는 대신 '절차적 메모리'로 분리하여 관리하면 효율적이다.
MCP를 활용하여 에이전트가 다양한 유형의 메모리 저장소에 표준화된 방식으로 접근하도록 설계한다.

섹션별 상세

CtxVault는 에이전트의 메모리를 'Vault'라는 독립된 유형별 단위로 격리하여 관리한다. CoALA와 같은 인지 아키텍처 연구를 기반으로 '무엇을 아는가'와 '어떻게 행동하는가'를 명확히 구분한다. 사용자는 세만틱 메모리에 문서와 벡터 인덱스를 저장하고, 절차적 메모리에 자연어로 정의된 행동 지침을 저장한다. 이러한 구조는 에이전트가 지식 검색과 행동 규칙 준수를 동시에 수행하도록 돕는다.

에이전트가 특정 요청을 받으면 두 종류의 Vault를 순차적으로 참조하여 결과를 생성한다. 먼저 절차적 메모리에서 작업의 형식, 톤, 제약 사항이 담긴 '기술(Skill)'을 읽어 들인다. 이후 세만틱 메모리에서 팀 지표나 프로젝트 업데이트와 같은 실제 사실 정보를 쿼리하여 결합한다. 최종 출력물은 사용자가 정의한 규칙을 철저히 따르면서도 최신 지식을 반영한 결과물이다.

LangChain 에이전트와 MCP(Model Context Protocol)를 결합하여 실질적인 워크플로우를 구현했다. MCP를 통해 에이전트가 외부 도구처럼 Vault에 접근하며, 주간 엔지니어링 업데이트 작성과 같은 복잡한 작업을 자동화한다. 공개된 예제 코드는 에이전트가 내부 기술(Skill)은 사용자에게 노출하지 않은 채 결과물만 생성하는 방식이다. 로컬 환경에서 전체 시스템이 구동되므로 데이터 보안과 검사 가능성이 높다.

프로젝트의 향후 로드맵은 인지 아키텍처의 전체 범위를 포괄하는 인프라 구축을 목표로 한다. 세션 로그와 상호작용 이력을 담는 일화적 메모리(Episodic Memory)와 지식 간의 관계를 정의하는 그래프 기반 세만틱 메모리 추가가 예정되어 있다. 이는 단순한 데이터 저장을 넘어 에이전트가 과거의 경험을 학습하고 복잡한 지식 구조를 이해하도록 돕는다. 개발자는 이를 통해 문헌에 기술된 메모리 분류 체계를 실제 구현 가능한 코드로 활용한다.

언급된 도구

CtxVault추천링크

에이전트 메모리 관리 및 격리

LangChain중립

LLM 애플리케이션 프레임워크

MCP추천

모델과 외부 도구 간의 통신 프로토콜

언급된 리소스

GitHubCtxVault GitHub 저장소

튜토리얼절차적 메모리 에이전트 예제