메모리 페이지¶
독립된 메모리 페이지는 영구 메모리를 검토하고 유지 관리하는 기본 워크스페이스입니다. 사이드바에서 메모리를 여세요. 페이지는 개요, 라이브러리, 유지 관리 탭으로 구성됩니다.
API 응답과 진단 출력에서는 메모리 뱅크를 네임스페이스라고도 부릅니다. 앱의 사용자 인터페이스에서는 메모리 뱅크라는 용어를 사용합니다.
개요¶
개요 탭은 모든 항목을 라이브러리로 불러오지 않고 메모리 전체를 요약합니다.
- 통계에는 전체 메모리, 활성 및 전체 메모리 뱅크, 자동 캡처 비율, 예상 주입 토큰, 이번 주에 추가된 메모리가 표시됩니다.
- 구성은 메모리를 종류와 소스별로 분류합니다. 구간이나 범례를 선택하면 해당 필터가 적용된 라이브러리가 열립니다.
- 30일 증가 추이는 UTC 기준 일별 추가 수를 보여줍니다. 운영 체제에서 동작 줄이기를 활성화하면 차트 애니메이션이 꺼집니다.
- 유지 관리 상태에는 예약 통합의 활성 여부와 실행 시점이 표시됩니다.
- 주입 미리 보기에는 활성 메모리 뱅크가 대화에 추가할 컨텍스트가 표시됩니다.
- 최근 활동을 선택하면 해당 메모리 뱅크가 열린 라이브러리로 이동합니다.
각 통계와 차트에는 접근 가능한 이름이 있습니다. Tab 키로 동작 사이를 이동하고, 표준 방향키로 페이지 탭 사이를 이동할 수 있습니다.
라이브러리¶
라이브러리 탭은 전체 페이지에서 메모리 뱅크와 항목을 편집하는 공간입니다.
메모리 뱅크 선택¶
왼쪽에 메모리 뱅크 레일이 표시됩니다.
- 모든 메모리 뱅크를 선택하면 일반 메모리 뱅크의 항목을 함께 탐색합니다.
- 하나의 뱅크를 선택하면 그 안의 항목을 추가, 편집, 삭제할 수 있습니다.
- 뱅크 옆 스위치로 메모리 주입에 포함할지 정합니다.
- 뱅크 메뉴에서 이름을 바꾸거나 삭제할 수 있습니다.
- 설치된 플러그인이 메모리 뱅크를 소유할 수 있습니다. 소유 정보를 알 수 있으면 뱅크 이름 아래에 플러그인 이름이 표시됩니다.
메모리 뱅크 옵션에 포커스가 있을 때 Arrow Up, Arrow Down, Home, End 키로 레일을 이동할 수 있습니다. 포커스된 옵션은 Enter 또는 Space 키로 선택합니다.
Layer-A 에이전트 경험 메모리¶
에이전트 경험 뱅크에는 에이전트가 사용하는 내부 경험 기록이 들어 있습니다. 이 뱅크는 의도적으로 모든 메모리 뱅크와 기본 항목 목록에서 제외됩니다. 확인이 필요할 때 레일의 에이전트 경험을 펼치세요. 에이전트 경험 뱅크로 직접 연결된 링크는 그룹을 자동으로 펼칩니다.
이 뱅크를 비활성화하거나 편집하면 에이전트 동작이 달라질 수 있습니다. 일반 메모가 아니라 운영 데이터로 취급하세요.
항목 검색과 필터¶
도구 모음에서 항목 내용을 검색하고, 종류와 소스로 필터링하며, 생성 또는 수정 시간순으로 정렬할 수 있습니다. 하나의 뱅크를 선택하면 해당 뱅크 안에서 검색합니다. 모든 메모리 뱅크를 선택하면 일반 뱅크 전체에서 검색합니다.
종류에는 사실, 선호, 개체, 결정, 미분류가 있습니다. 소스는 자동으로 캡처된 메모리와 수동으로 추가한 항목을 구분합니다.
직접 링크¶
메모리 링크는 뱅크, 검색어, 필터가 미리 선택된 라이브러리를 열 수 있습니다. 지원하는 쿼리 매개변수에는 tab=browser, namespace, q, kind, source가 있습니다. 페이지는 값을 적용한 뒤 이 매개변수를 제거하므로 새로 고침할 때 같은 직접 링크 상태를 다시 적용하지 않습니다.
유지 관리¶
유지 관리 탭에는 많은 메모리를 변경하거나 전송하는 작업이 모여 있습니다.
통합¶
통합 실행을 사용하면 설정된 모델이 처리할 수 있는 유사 중복 메모리를 병합합니다. 상태 패널에는 일정, 마지막 실행, 마지막 시도, 마지막 오류가 표시됩니다. 수동 항목은 통합하지 않습니다.
뱅크별 중복 제거¶
메모리 뱅크를 선택하고 유사도 임계값과 최대 항목 수명을 조정한 뒤 중복 제거를 실행하세요. 이 작업은 자동으로 캡처된 항목에만 적용됩니다. 다른 임계값으로 다시 실행하기 전에 결과 수치를 확인하세요.
가져오기와 내보내기¶
백업을 만들려면 다음 단계를 따르세요.
- 내보내기 패널에서 메모리 뱅크를 선택합니다.
- 내보내기를 선택합니다.
- 다운로드한 JSON 파일을 안전한 위치에 보관합니다.
뱅크를 복원하거나 전송하려면 다음 단계를 따르세요.
- Backend.AI GO 메모리 JSON 파일을 가져오기 영역에 놓거나 파일 선택기로 고릅니다.
- 성공 메시지와 메모리 뱅크 목록 새로 고침을 기다립니다.
- 라이브러리를 열어 가져온 항목을 확인합니다.
가져오기 파일은 최대 10 MB입니다. 나중에 데이터가 필요할 수 있다면 뱅크를 비우거나 삭제하기 전에 내보내세요.
추출 상태와 위험 영역¶
추출 섹션에는 실제로 적용되는 자동 추출 설정이 표시되며, 선택한 추출 모델을 사용할 수 있는지 확인할 수 있습니다. 추출 동작을 바꾸려면 설정 편집을 통해 설정 > 메모리로 이동하세요.
위험 영역에서는 뱅크의 모든 항목을 비우거나 뱅크를 삭제할 수 있습니다. 두 작업 모두 확인이 필요합니다. 비우기는 뱅크와 설정을 유지합니다. 삭제는 뱅크와 항목을 모두 제거합니다.
페이지, 채팅, 설정 화면¶
메모리 페이지가 모든 상황별 메모리 조작을 대체하지는 않습니다.
- 설정 > 메모리에서는 전역 메모리, 주입, 자동 추출을 설정합니다. 메모리 뱅크에서 보기를 선택하면 설정을 벗어나지 않고 기존 드로어가 열립니다.
- 채팅 메모리 인디케이터는 대화 안의 간단한 팝오버를 유지합니다. 관리 동작을 선택하면 활성 메모리 뱅크 정보와 함께 독립 라이브러리가 열립니다.
- 채팅 메시지의 메모리에 저장은 뱅크와 태그를 선택하는 간결한 대화상자를 계속 사용합니다.
페이지, 드로어, 채팅, 데스크톱 IPC, Management API에서 변경한 내용은 백엔드가 변경을 확인한 뒤 열려 있는 메모리 페이지에 자동으로 반영됩니다.
권장 작업 흐름¶
- 개요에서 증가 추이, 토큰 사용량, 유지 관리 시점을 확인합니다.
- 라이브러리에서 개별 메모리를 검토하고 수정합니다.
- 대량 작업 전에 중요한 뱅크를 내보냅니다.
- 유지 관리에서 통합, 중복 제거, 가져오기, 내보내기, 비우기, 삭제를 실행합니다.
- 주입이나 추출 정책을 바꿀 때는 설정 > 메모리로 돌아갑니다.