AI 메모리 뱅크 사용법
AI 메모리 뱅크는 MBAgent가 세션을 횡단하여 저장하는 장기 메모리입니다. AI가 사용자의 선호·계정 정보·비즈니스 규칙을 기억하게 하여, 새 세션마다 매번 설명할 필요가 없도록 합니다.
NOTE
스크린샷 설명: AI 메모리 뱅크 관리 화면의 스크린샷은 v1.x에서 점진적으로 보완될 예정입니다.
1. AI 메모리란 무엇인가?
MBAgent는 2가지 종류의 "메모리"를 구분합니다:
| 유형 | 범위 | 용도 |
|---|---|---|
| 세션급 메모리 | 현재 대화만 | "방금 그 숫자"를 AI가 기억 |
| AI 로컬 메모리 뱅크 | 세션 횡단·영구 | 사용자 선호, 계정, 비즈니스 규칙 |
TIP
비유: 세션급 메모리는 "이번 대화의 임시 기억", AI 로컬 메모리 뱅크는 "사용자의 개인 프로필".
2. AI 메모리 뱅크에 저장할 수 있는 것
적합한 내용:
- ✅ 사용자 선호 ("응답 스타일은 격식 있고 엄격하게, 이모지 없이")
- ✅ 계정 정보 ("내 후니아오 메인 계정은 123456")
- ✅ 비즈니스 규칙 ("고객 ID는 항상 32자리 문자열")
- ✅ 중요 사실 ("당사는 주로 유럽·미국 시장을 대상으로 함")
- ✅ 상용어 ("GMV = Gross Merchandise Value")
적합하지 않은 내용:
- ❌ 일시적 정보 ("오늘 주문은 100건")
- ❌ 기밀 자격증명 (비밀번호·Token·API Key) → 이는 자격증명 관리자에서 관리
- ❌ 대량 문서 → 이는 KMS 지식베이스에서 관리
3. AI 메모리 뱅크 저장 위치
메모리 뱅크 파일은 MBAgent 사용자 설정 디렉터리에 저장됩니다:
%LOCALAPPDATA%\mbagent\memory\
├── user.md ← 사용자급 메모리 (모든 세션 공유)
├── project\
│ ├── my-project.md ← 프로젝트급 메모리 (현재 프로젝트만 가시)
│ └── ...- 사용자급 메모리: 모든 워크스페이스·전 세션 공유
- 프로젝트급 메모리: 현재 워크스페이스(프로젝트 디렉터리)의 세션에서만 가시
4. 메모리 추가
방법 1: 대화에서 직접 AI에게 기억시키기
가장 자연스러운 추가 방법:
사용자: 내 후니아오 메인 계정은 123456789이고, 주로 유럽·미국 Amazon 시장을 대상으로 한다고 기억해줘.
MBAgent: 알겠습니다, AI 로컬 메모리 뱅크에 추가했습니다.
AI가 자동으로 기억할 가치가 있는지 판단합니다.
방법 2: 메모리 뱅크 관리 화면에서 수동 추가
- 좌측 사이드바의 "AI 로컬 메모리 뱅크" 진입점 클릭
- "+" 버튼 클릭
- 메모리 유형 선택 (사용자급 / 프로젝트급)
- 제목과 내용 입력
- "저장" 클릭
방법 3: slash command 사용
채팅 입력란에서:
/memory add 내 후니아오 메인 계정은 123456789AI가 자동으로 적절한 메모리 카테고리로 분류합니다.
방법 4: 대화에서 증류
- 채팅에서 유용한 정보를 발견
- 우측 클릭 → "메모리에 추가"
- 메모리 유형 선택 (사용자급 / 프로젝트급)
- 저장
5. 메모리 유형 및 분류
AI 메모리 뱅크는 여러 분류를 지원하여 관리하기 쉽게 합니다:
| 유형 | 용도 | 예시 |
|---|---|---|
| 계정 정보 | 후니아오 계정, API Key 번호 (실제 Key 제외) | "메인 계정 123456" |
| 비즈니스 규칙 | 워크플로, 명명 규칙 | "고객 ID는 32자리" |
| 선호 설정 | 글쓰기 스타일, 응답 포맷 | "응답은 격식 있고 엄격하게" |
| 중요 사실 | 업무 배경, 회사 정보 | "주력은 유럽·미국 Amazon" |
| 상용어 | 전문 용어 | "GMV = 총 거래액" |
| 기타 | 상기 외 카테고리 | "API 게이트웨이 도메인" |
6. 메모리 표시 및 편집
모든 메모리 표시
- 좌측 사이드바 "AI 로컬 메모리 뱅크" 클릭
- 메모리 브라우저가 팝업되어 모든 메모리 엔트리를 표시
- 분류로 필터, 시간순으로 정렬
메모리 편집
- 메모리 목록의 임의의 1개 클릭
- 우측에 편집 패널 표시
- 제목·내용·분류 수정
- "저장" 클릭
메모리 삭제
- 삭제할 메모리 선택
- "삭제" 버튼 클릭
- 삭제 확인 (복원 불가)
TIP
정기 정리: 매월 1회 메모리 뱅크를 정리하여 시대에 뒤떨어지거나 잘못된 정보를 삭제할 것을 권장.
7. AI는 메모리를 어떻게 사용하는가?
자동 검색
새 세션 시작 시 MBAgent는 자동으로 AI 메모리 뱅크에서 현재 작업과 관련된 메모리를 검색하여 system prompt의 일부로 포함합니다.
예: "내 메인 계정의 오늘 주문은?"이라고 물었을 때:
- AI가 자동으로 "메인 계정 123456" 메모리를 검색
- 자동으로 후니아오 브라우저 API를 호출하여 123456의 오늘 주문을 조회
- "내 메인 계정은 123456"이라고 반복할 필요 없음
주체적 인용
AI는 응답 시 "기억하고 있는" 정보를 명시적으로 언급합니다:
"이전에 기록한 선호에 따르면, 격식 있고 엄격한 스타일로 응답합니다."
학습 증류
autoLearn 설정을 활성화하면 MBAgent가 자동으로 "의미 있는 대화"를 메모리로 증류:
- "설정 → 환경 설정" 진입
- "autoLearn" 옵션 찾기
- 활성화 후 MBAgent가 각 대화를 분석
- "기억할 가치가 있는" 것을 자동으로
self_learn메모리 뱅크에 추가 (사용자 능동 메모리와 별도)
8. 메모리 뱅크 모범 사례
권장
✅ MBAgent 최초 사용 시 중요 메모리 몇 개 생성:
- 후니아오 메인 계정 번호
- 주력 업무 범위
- 응답 스타일 선호
✅ AI가 같은 질문을 반복하면 즉시 기록:
- AI가 "고객 ID가 무엇인가요"를 반복하면 이를 기록
✅ 프로젝트별로 메모리 범위를 분리:
- 프로젝트 A의 메모리는 프로젝트 A 디렉터리에만 배치
- 사용자급 메모리는 일반 정보를 배치
✅ 메모리에 구조 부여:
- 제목을 명확하게
- 내용은 간결하게
- markdown 리스트로 정리
안티 패턴
❌ 기밀 자격증명을 메모리 뱅크에 두지 말 것:
- 비밀번호·Token·API Key는 자격증명 관리자에서 관리
- 메모리 뱅크 파일은 평문, 암호화 없음
❌ 문서 전체를 메모리 뱅크에 밀어넣지 말 것:
- 문서·참고 자료는 KMS 지식베이스에서 관리
- 메모리 뱅크는 "규칙·선호·중요 사실"만
❌ 메모리 뱅크를 과도하게膨胀 시키지 말 것:
- 메모리가 너무 많으면 AI의 주의가 분산됨
- 메모리 엔트리를 50개 미만으로 유지
9. 메모리 뱅크 vs 다른 기능
| 기능 | 용도 | 크기 |
|---|---|---|
| AI 메모리 뱅크 | 선호, 규칙, 중요 사실 | 소 (KB급) |
| 로컬 지식베이스 (KMS) | 완성 문서, 참고 자료 | 대 (MB급) |
| 세션 | 1회 대화의 완전한 기록 | 중 (KB-MB급) |
| RAG 후니아오 공식 지식베이스 | 후니아오 업무 원격 검색 | 원격 |
TIP
어떤 것을 선택할지:
- 단순 선호 → AI 메모리 뱅크
- 완성 문서 → KMS
- 원샷 Q&A → 세션
- 후니아오 업무 지식 → 후니아오 RAG
10. 메모리 뱅크 장애 분리
Q1: AI가 이전 발언을 "기억하지 못하는" 것처럼 보인다
가능한 원인:
- 메모리 뱅크에 저장 실패
- 메모리가 기본으로 무시됨 (현재 작업과 무관)
- 메모리 뱅크 파일 손상
분리:
- **"AI 로컬 메모리 뱅크"**에 진입하여 메모리가 존재하는지 확인
- AI에게 다시 기억시키고 명시적으로 확인
Q2: AI가 잘못된 메모리를 사용했다
가능한 원인:
- 메모리 분류 오류 (사용자급이 프로젝트급에 배치됨)
- 메모리 내용이 오래됨
분리:
- 해당 메모리 편집
- 수정 또는 삭제
Q3: 메모리 뱅크를 백업하려면?
- 메모리 뱅크 디렉터리
%LOCALAPPDATA%\mbagent\memory\찾기 - 폴더 전체를 백업 위치에 복사
- 복원 시 역조작
Q4: 여러 PC 간 메모리를 동기화할 수 있나?
✅ 가능하지만 수동으로:
- PC A에서 메모리 내보내기 (백업 폴더)
- PC B에 가져오기 (폴더 덮어쓰기)
- MBAgent 재시작
NOTE
후니아오는 아직 클라우드 메모리 동기화 서비스를 제공하지 않습니다. 중요 메모리는 수동 백업을 권장합니다.