Memory Console 가이드

사용자 목표 및 콘솔 개요

Memory Console은 /me (/memory-console로도 별칭 지정됨)에서 메모리 기록, 에이전트 연결, 프로젝트 및 보안 설정을 검사, 검색 및 관리할 수 있는 시각적 웹 인터페이스를 제공합니다. 개발자와 팀 구성원은 CLI 명령어나 MCP 도구만을 통해 상호 작용하는 대신 콘솔을 사용하여 에이전트가 기록한 내용을 감사하고, 부정확한 메모리를 수정하며, 에이전트 귀속을 검사하고, API 토큰을 관리하며, 데이터 내보내기 및 삭제를 제어합니다.

이용 가능성 및 사전 요구 사항

Memory Console은 인증된 사용자를 위해 모든 최신 브라우저에서 사용할 수 있습니다. 콘솔 레이아웃은 사이드바 탐색 및 직접 URL 해시 앵커를 통해 액세스할 수 있는 별개의 워크스페이스 및 액세스 섹션으로 기능을 구성합니다:

• 인증 요구 사항: 활성 사용자 세션이 필요합니다. 인증되지 않은 방문은 /login (로그인 페이지)으로 리디렉션됩니다.
• 개요 (#overview): 개인 메모리 워크스페이스, 최근 활동, 연결된 에이전트 및 스토리지 신호에 대한 빠른 요약입니다.
• 메모리 (#memory): 전체 텍스트 검색, 유형 필터 및 소스 필터를 사용하여 메모리 레코드를 검색, 필터링, 검사 및 편집합니다.
• Knowledge (#knowledge): 승인된 에이전트가 참조할 수 있도록 지식 문서를 보고 유지 관리합니다.
• 프로젝트 (#projects): 프로젝트 워크스페이스, 컨텍스트 메모 및 프로젝트 관련 메모리를 탐색합니다.
• Cloud Skill (#skills): 절차적 클라우드 스킬을 작성, 가져오기 및 관리합니다. Preview 배지가 표시되며 계정에서 활성화된 경우 사용할 수 있습니다.
• Dream (#dream): 지속성 메모리가 되기 전에 반복되는 패턴과 종합 제안을 검토합니다. Preview 배지가 표시되며 계정에서 활성화된 경우 사용할 수 있습니다.
• 에이전트 (#agents): 이 워크스페이스에 연결된 에이전트를 보고, 마지막 활성 타임스탬프를 검사하며, 권한을 검토합니다.
• 팀 (#teams): 팀을 생성 및 관리하고, 구성원을 초대하며, 팀 워크스페이스 역할을 구성합니다. Preview 배지가 표시되며 계정에서 활성화된 경우 사용할 수 있습니다.
• 프로필 (#profile): 계정 ID, 이메일 확인 상태 및 개인 환경설정입니다.
• 세션 (#sessions): 활성 로그인 세션 및 연결된 장치를 검토합니다.
• API 키 (#api-keys): CLI, 에이전트 및 자동화를 위한 범위가 지정된 액세스 토큰을 발급, 순환 및 취소합니다.
• 설정 (#memory-settings): 개인정보 보호 태세, 보안 모드, 데이터 내보내기 요청 및 메모리 삭제 제어입니다.

하나의 완전한 작업: 합성 메모리 검사 및 수정

이 단계별 안내에서는 빠른 시작 가이드 중에 저장된 합성 규칙 메모리를 찾고, 에이전트 귀속을 검사하며, 콘솔에서 텍스트를 수정하고, 업데이트를 확인하며, 개인 워크스페이스 경계를 검증합니다.

1. 메모리 패널에서 합성 메모리 찾기

/me로 이동하고 사이드바에서 Memories를 클릭하거나 #memory로 이동하여 메모리 패널을 엽니다. 검색창에 "demo project timestamp format"을 입력하거나 Facts 범주로 필터링합니다. 목록에 요약 콘텐츠, 생성 시간 및 가시성 배지가 표시된 일치하는 메모리 카드가 렌더링됩니다.

# Access personal workspace
https://xmemo.dev/me#memory

# Access team workspace with explicit team context
https://xmemo.dev/me?space=<team_id>#memory

2. 에이전트 귀속 및 메타데이터 검사

메모리 카드를 클릭하여 Explain 패널을 확장합니다. 콘솔에 작성 시점에 캡처된 출처 및 귀속 세부 정보가 표시됩니다:

• 작성자 종류 및 에이전트 ID: 메모리가 에이전트, 인간 사용자 또는 가져온 스크립트에 의해 작성되었는지 여부를 에이전트 이름 및 ID와 함께 표시합니다.
• 에이전트 인스턴스 표시: 동일한 에이전트의 개별 실행을 구별하기 위해 고유한 에이전트 인스턴스 식별자(agent_instance_display)를 표시합니다.
• 기기 및 전송: 쓰기가 제출된 기기 레이블(device_label) 및 전송 채널을 표시합니다.
• 가시성 및 범위: 레코드가 개인용인지 팀 공유(team_id)인지 여부와 프로젝트 및 버킷 할당을 나타냅니다.
• 버전 기록: 현재 리비전 번호를 표시하고 버전 계보 드로어로 연결됩니다.

3. 메모리 콘텐츠 인라인 수정

메모리 카드에서 Edit 버튼을 클릭하여 인라인 편집기를 엽니다. 개선된 프로젝트 규칙을 반영하도록 콘텐츠를 업데이트한 다음 Save를 클릭합니다:

• 업데이트된 콘텐츠: "demo project timestamp format"을 "Demo project timestamps use UTC with ISO 8601 formatting."으로 변경합니다.
• 저장 작업: 콘솔은 CSRF 보호가 적용된 인증된 업데이트 요청을 실행하여 리비전 카운터를 증가시킵니다.
• 충돌 방지: 에이전트가 동시에 메모리를 업데이트한 경우 콘솔은 리비전 불일치(HTTP 409)를 감지하고 덮어쓰기 전에 최신 콘텐츠를 검토하도록 "CAS version conflict: Data has been updated elsewhere. Please refresh and try again." 메시지를 표시합니다.

4. 콘솔 및 에이전트 리콜 전반에서 업데이트 확인

저장 후 콘솔에 성공 알림이 표시되고 메모리 카드가 업데이트됩니다. 버전 계보 드로어에 이전 리비전이 새 리비전으로 대체되었음이 표시됩니다. 연결된 에이전트가 수정을 즉시 확인하는지 확인하려면 터미널에서 recall을 실행하십시오:

node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" --limit 1

관찰 가능한 결과

성공적인 콘솔 수정은 웹 UI 및 에이전트 인터페이스 전반에 걸쳐 관찰 가능한 변화를 생성합니다:

• 웹 콘솔 토스트: 확인 토스트("Memory updated")가 화면 하단에 나타납니다.
• 카드 표시: 카드에 업데이트된 텍스트, 갱신된 타임스탬프 및 증가된 리비전 색인이 즉시 표시됩니다.
• 계보 드로어: 버전 계보 드로어에 이전 리비전과 업데이트된 텍스트를 비교하는 단어 수준의 차이점이 표시됩니다.
• 에이전트 리콜 출력: "demo project timestamp format"에 대한 쿼리는 최신 리비전 참조와 함께 업데이트된 텍스트를 반환합니다.

에이전트가 액세스할 수 있는 범위

에이전트와 콘솔 사용자는 별개의 인증 및 권한 경계 내에서 작동합니다:

• 콘솔 권한: 콘솔 사용자는 CSRF 검증이 적용된 브라우저 쿠키를 통해 데이터에 액세스합니다. 콘솔의 작업은 로그인한 사용자 프로필을 반영합니다.
• 에이전트 권한: 에이전트는 API 키 패널(#api-keys)에서 발급된 범위가 지정된 API 키 또는 OAuth 토큰을 사용하여 인증합니다. 허용되는 토큰 범위에는 memory:read, memory:write, knowledge:read, ledger:read, ledger:write 및 read:audit이 포함됩니다.
• 에이전트 가시성 경계: 에이전트는 계정 비밀번호, 활성 브라우저 세션 또는 청구 세부 정보를 볼 수 없습니다. 개인 토큰을 발급받은 에이전트는 개인 메모리와 공개 지식만 쿼리할 수 있으며, 해당 팀에 명시적으로 바인딩되지 않는 한 팀 워크스페이스를 검사할 수 없습니다.

공유 및 스토리지 경계

Memory Console은 개인 데이터와 팀 워크스페이스 간의 엄격한 분리를 적용합니다:

• 공간 선택: 공간 선택기는 쿼리 매개변수 ?space=<team_id>(useSpaceContext에 의해 관리됨)를 통해 개인 메모리와 팀 워크스페이스 간을 전환합니다. 매개변수를 생략하거나 ?space=personal로 설정하면 보기가 개인 메모리로 제한됩니다.
• 설정 격리: 설정 패널(#memory-settings)은 테넌트 간 구성 드리프트를 방지하기 위해 팀 공간을 탐색할 때 자동으로 숨겨집니다. 팀 공간에 있는 동안 설정을 열려고 시도하면 활성 공간이 Personal로 재설정됩니다.
• 데이터 내보내기 경계: 설정(#memory-settings)에서 사용자는 비밀 안전 내보내기 아카이브(/api/v1/me/export-requests)를 요청할 수 있습니다. 개인 내보내기에는 개인 메모리 레코드, 버전 계보, 개인 원장 트랜잭션 및 개인 문서가 포함됩니다. 팀 메모리는 개인 내보내기에서 엄격히 제외됩니다.
• 내보내기 다운로드 승인: 생성된 내보내기 아카이브는 xmemo-personal-export.zip을 검색하기 전에 임시 다운로드 승인 토큰을 얻기 위해 sudo 챌린지가 필요합니다. 내보내기 아티팩트는 언제든지 취소하고 삭제할 수 있습니다.
• 메모리 삭제 제어: 사용자는 확인을 통해 개별 메모리를 삭제하거나, 모든 메모리를 지우거나, 계정 이메일을 확인하고 확인 문구 "RESET MY XMEMO MEMORY"를 입력하여 메모리를 재설정할 수 있습니다. 셀프 서비스 계정 폐쇄는 삭제 전에 소유한 팀을 이전해야 합니다(HTTP 409).
• TODO 진입점: 콘솔은 프로젝트(#projects) 아래의 프로젝트 카드 내에 TODO를 집계 카운터로 노출하여 각 워크스페이스와 연관된 열린 작업 항목의 수를 표시합니다.
• 원장 진입점: 원장 레코드는 메모리(#memory) 아래에 필터링 가능한 유형 범주로 표시되고, API 키(#api-keys) 아래의 API 토큰(ledger:read, ledger:write)에 범위를 지정할 수 있으며, 개인 데이터 내보내기 아카이브에 포함됩니다.

장애 복구

다음 단계를 사용하여 일반적인 콘솔 오류 및 액세스 문제를 해결하십시오:

• 검색에서 메모리를 찾을 수 없음: 공간 선택기가 올바른 공간(Personal 대 Team ?space=<team_id>)으로 설정되어 있는지 확인하십시오. 검색 결과를 넓히려면 도구 모음의 활성 필터 드롭다운(예: 유형 또는 가시성)을 지우십시오.
• 동시 편집 오류 (HTTP 409): 편집이 열려 있는 동안 에이전트나 다른 탭에서 메모리를 업데이트한 경우 콘솔에 "CAS version conflict: Data has been updated elsewhere. Please refresh and try again." 메시지가 표시됩니다. 목록을 새로고침하고 새 리비전을 검사한 다음 변경 사항을 다시 적용하십시오.
• 사이드바에 설정 옵션이 표시되지 않음: 팀 공간을 볼 때 설정이 숨겨집니다. 사이드바에서 공간 드롭다운을 열고 Personal 워크스페이스로 다시 전환하여 설정(#memory-settings)에 대한 액세스를 복원하십시오.
• 내보내기 다운로드 승인 만료됨: Sudo 다운로드 승인 토큰은 유효 기간이 짧습니다. 새로운 다운로드 승인을 생성하려면 다운로드 프롬프트에 계정 자격 증명을 다시 입력하십시오.

관련 참조

기본 메커니즘 및 API 계약에 대해서는 관련 개념 및 도구 문서를 참조하십시오:

• 빠른 시작: 초기 설정 및 합성 메모리 생성에 대해서는 /docs/quickstart를 참조하십시오.
• 메모리 수정: 리비전 기록 및 대체 의미 체계에 대해서는 /docs/concepts/memory-correction을 참조하십시오.
• 메모리 삭제: 소프트 삭제 및 툼스톤 라이프사이클에 대해서는 /docs/concepts/memory-deletion을 참조하십시오.
• 출처 및 귀속: 에이전트 인스턴스 및 작성자 종류 사양에 대해서는 /docs/concepts/provenance-attribution을 참조하십시오.
• 프로젝트: 프로젝트 워크스페이스 경계 및 컨텍스트 범위에 대해서는 /docs/concepts/projects를 참조하십시오.
• 팀: 팀 워크스페이스 생성, 역할 및 협업에 대해서는 /docs/capabilities/teams를 참조하십시오.
• 지식 베이스: 문서 베이스 및 게시 규칙에 대해서는 /docs/concepts/knowledge-bases를 참조하십시오.
• Cloud Skills: 절차적 클라우드 스킬 작성에 대해서는 /docs/concepts/cloud-skills를 참조하십시오.
• Dream 성찰: 패턴 분석 개념에 대해서는 /docs/concepts/dream-reflection을 참조하십시오.
• 거버넌스 및 보존: 보존 정책 및 DSAR 제어에 대해서는 /docs/concepts/governance-retention을 참조하십시오.
• 데이터 경계: 암호화, 다중 테넌시 및 격리에 대해서는 /docs/security/data-boundary를 참조하십시오.
• TODO 도구: 에이전트 작업 추적 도구 매개변수에 대해서는 /docs/tools/todos를 참조하십시오.
• 원장 도구: 금융 거래 도구 매개변수에 대해서는 /docs/tools/ledger를 참조하십시오.