agent-memory은(는) 무엇을 하나요?
AI 에이전트의 지속적 메모리를 마크다운 파일에 저장하고, 검색, 컨텍스트 주입, 체크포인트, 압축 기능을 제공합니다. 데이터베이스가 필요 없습니다.
개요
이 기술은 AI 에이전트가 여러 대화 세션에 걸쳐 정보를 기억할 수 있도록 지원합니다. 모든 메모리는 일반 마크다운 파일로 저장되므로, 데이터베이스나 특별한 인프라 없이도 Git과 같은 버전 관리 시스템과 완벽하게 통합됩니다.
기능
- 마크다운 기반 저장소: 메모리를 구조화된 마크다운 파일로 저장 (예:
memory/디렉토리) - 검색: 키워드 기반 검색을 통해 관련 메모리 조각을 빠르게 찾을 수 있음
- 컨텍스트 주입: 현재 대화에 관련 메모리를 자동으로 주입하여 에이전트가 이전 맥락을 인지하도록 함
- 체크포인트: 메모리의 특정 시점을 저장하고 복원할 수 있는 체크포인트 기능
- 압축 (Compaction): 오래된 메모리를 요약하여 저장 공간을 절약하고 검색 효율성을 높임
사용 방법
-
메모리 디렉토리 설정
기본 메모리 디렉토리는
memory/입니다. 환경 변수AGENT_MEMORY_DIR을 설정하여 변경할 수 있습니다.export AGENT_MEMORY_DIR="./my_memory" -
메모리 쓰기
agent-memory write "사용자가 Node.js 프로젝트를 선호함" -
메모리 검색
agent-memory search "Node.js" -
컨텍스트 주입
현재 대화에 메모리를 주입하려면 다음 명령을 사용합니다:
agent-memory inject이 명령은
inject_context.md파일을 생성하여 관련 메모리를 포함시킵니다. -
체크포인트 생성
agent-memory checkpoint "checkpoint_name" -
메모리 압축
agent-memory compact
환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
AGENT_MEMORY_DIR | 메모리 파일이 저장될 디렉토리 | ./memory |
AGENT_MEMORY_MAX_SIZE | 메모리 파일 최대 크기 (바이트) | 1000000 |
AGENT_MEMORY_COMPACT_SIZE | 압축을 트리거하는 메모리 크기 임계값 (바이트) | 500000 |
설치
npm install -g agent-memory
또는 저장소를 클론하여 로컬에서 실행:
git clone https://github.com/Defiladeboarfish90/agent-memory.git
cd agent-memory
npm install
npm run build
라이선스
MIT