워크스페이스 메모리 관리

이 가이드에서는 워크스페이스의 지식 저장소를 다루는 방법을 설명합니다.

시작하기 전에 알아 두어야 할 중요한 점은 메모리 UI는 작성 표면이 아니라 검토 표면이라는 것입니다. 팩트와 정책은 에이전트가 작성합니다. propose_fact와 propose_policy로 쓰고, supersede_fact와 supersede_policy로 대체합니다. remember는 세션 범위의 핫 티어 항목을 기록하며, consolidate_memory가 나중에 이를 팩트로 승격할 수 있습니다. 녹음된 회의 결정은 decisions 도메인으로 수집됩니다. 완료된 에이전트 실행에는 수집이 없습니다. 여기서 하는 일은 에이전트가 기록한 내용을 읽고, 교정하고, 비활성화하거나 삭제하는 것입니다.

메모리는 설정 → 워크스페이스 → 메모리(/workspaces/<id>/settings/memory)에 있습니다. 최상위 사이드바 항목은 아닙니다.

세 개의 탭

이 페이지에는 정확히 세 개의 탭이 있습니다. 사실과 정책 탭은 실시간 개수를 표시하지만, 그래프 탭은 표시하지 않습니다:

사실 — 워크스페이스의 모든 팩트와, 그중 대체되지 않은 팩트의 개수
정책 — 도메인별로 묶인 규범적 규칙과, 그중 활성 규칙의 개수
지식 그래프 — 도메인, 주제, 팩트, 정책을 보여 주는 대화형 캔버스

도메인은 직접 만드는 것이 아닙니다. 도메인은 에이전트가 그 안에 첫 팩트나 정책을 기록할 때 생깁니다. UI 어디에도 도메인을 만드는 기능은 없습니다.

팩트 검토 및 교정

사실 탭을 엽니다.
검색 상자로 목록을 좁힙니다. 각 팩트의 도메인, 주제, 내용에 대한 단순 부분 문자열 필터이며, 키워드 색인도 순위도 없습니다.
범위 필터로 모든 범위, 워크스페이스 전체 팩트만, 또는 저장소 하나의 팩트만 표시합니다.
정렬 전환으로 최신순 또는 신뢰도순으로 정렬합니다.
팩트의 편집 컨트롤을 클릭합니다.

편집 대화 상자에서는 다음을 변경할 수 있습니다:

도메인 — 팩트를 도메인 간에 이동
주제 — 팩트의 짧은 레이블
내용 — 지식 텍스트
신뢰도 — 5% 단위의 슬라이더

저장하면 다시 기록됩니다. 팩트 추가 버튼은 없으며, 대화 상자는 기존 행에서만 열립니다.

대체된 팩트 확인

사실 탭에는 대체된 항목 표시 스위치가 있습니다. 대체된 팩트는 기본적으로 숨겨져 있으며 그 스위치로 표시됩니다. 감사 추적이 사는 곳이 바로 여기입니다. 대체는 결코 삭제하지 않습니다.

팩트 삭제

팩트의 삭제 컨트롤을 사용하고 확인합니다. 이는 대체가 아니라 실제 삭제입니다. 기록한 것 자체가 잘못이었던 팩트에 사용하고, _내용_이 달라진 팩트는 에이전트가 대체하도록 두십시오.

정책 관리

정책 탭은 활성 정책을 도메인별로 묶고, 비활성 정책은 맨 뒤 섹션으로 내립니다. 각 정책에 대해 다음을 할 수 있습니다:

편집
삭제
비활성화 / 활성화 — 되돌릴 수 있는 선택지이며 보통은 이것이 옳습니다. 활성 정책만 에이전트 프롬프트에 도달합니다.

팩트와 마찬가지로 생성 기능은 없습니다.

지식 그래프 살펴보기

지식 그래프 탭은 도메인, 주제, 팩트, 정책을 탐색 가능한 노드 캔버스로 펼쳐 보여 줍니다. 팬, 확대/축소, 노드 드래그가 가능합니다. 노드를 탭하면 상세 시트가 열리고, 거기서 같은 편집 대화 상자에 접근할 수 있습니다. 어떤 도메인에 실제로 내용이 채워져 있는지 가장 빠르게 확인하는 방법입니다.

에이전트의 워킹 메모리 편집

워킹 메모리는 에이전트마다 있는 비공개 스크래치패드이며, 디스패치 시점에 해당 에이전트의 프롬프트에 주입됩니다. 에이전트가 record_observation과 update_my_notes로 직접 기록하지만, 여러분이 직접 읽고 편집할 수도 있습니다:

설정 → 워크스페이스 → 에이전트 → 에이전트 선택 → 메모리 탭.

접근 권한 부여

메모리 접근 권한 부여는 에이전트의 역할을 도메인별 권한(none, read, write)에 매핑합니다. memory_access_grant.* 작업으로 기록합니다.

이들이 어떻게 결정되는지에 관해 이해해야 할 두 가지가 있습니다:

읽기는 페일 오픈입니다. (역할, 도메인) 쌍에 대한 권한 부여 행이 없으면 실제 권한은 read입니다. write 없이 예외를 던지는 유일한 쓰기는 propose_policy입니다. 팩트 쓰기는 권한 부여로 제한되지 않습니다.
권한 부여는 에이전트의 역할을 키로 합니다. 제안 도구는 누락된 agent_role을 general로 기본 설정합니다. 다른 역할에 대해 기록한 권한 부여는 그 에이전트들을 구속하지 않으며, general 권한 부여는 구속합니다.

검색은 어디에서나 같지 않습니다

세 가지 서로 다른 것이 “메모리 검색”이라고 불리며, 서로 일치하지 않습니다:

위치	동작
사실 탭의 검색 상자	클라이언트에 이미 로드된 팩트에 대한 부분 문자열 필터
`memory_fact.search` RPC 작업	FTS5 키워드 검색만 수행합니다. 씬 클라이언트는 쿼리 임베딩을 실어 보낼 수 없으므로 하이브리드 검색은 호스트 내부에 머뭅니다
에이전트 측 `search_memory` 도구	`keyword`, `semantic` 또는 `hybrid`(기본값)입니다. 하이브리드는 어휘, 의미론, 시간, 그래프의 네 목소리를 융합합니다

따라서 에이전트와 메모리 페이지는 같은 쿼리를 같은 방식으로 순위 매기지 않습니다. 에이전트가 실제로 무엇을 회수할 수 있는지 확인할 때는 에이전트에게 물어보십시오.

임베딩

팩트는 기록 시점에 임베딩되며, 온디바이스 임베딩 모델이 설치되어 있을 때만 그렇습니다. 상태는 설정 → 서버 → 진단 및 개인정보 보호 → 시맨틱 검색에서 확인합니다. 의미론적 회수를 원한다면 에이전트가 메모리를 쓰기 시작하기 전에 모델을 설치하십시오.