Skip to main content
Wiki 메모리는 사람과 Agent 가 마크다운으로 함께 쓰는 노트 공간입니다. 팀 위키처럼 오래 남고, 리트리벌은 의미 검색으로 이루어집니다.

​
언제 쓰나

  • 상시 운영 절차·플레이북 “환불 처리 시 항상 주문 상태를 먼저 확인” 같은 규칙을 저장할 때 씁니다.
  • 외부 문서에 없는 팀 지식 커뮤니케이션 톤이나 예외 처리 방식을 저장할 때 씁니다.
  • Agent 가 이후에도 계속 참조해야 할 결정과 결론

​
만들기

메모리 → 새 공간 → Wiki (notes) 로 즉시 생성됩니다. 자세한 흐름은 메모리 개요 → 공간 만들기를 참고하세요.

​
상세 페이지

Wiki 를 열면 이렇게 구성됩니다.
  • Notes 탭 왼쪽에는 노트 목록, 오른쪽에는 마크다운 에디터가 있습니다. 상단 필터로 스코프별로 좁혀 봅니다.
  • Log 탭 이 공간의 이벤트를 시간순으로 표시합니다.
  • Settings 탭 아래 내용을 참고하세요.
에디터에는 세 가지 필드가 있습니다.
  • 경로 (path) 선택 사항입니다. Agent가 노트를 참조하는 주소입니다. 모노스페이스로 표시되며, docs/refund-policy 같은 폴더 형식으로 작성하면 노트를 묶어 정리하기 편합니다.
  • 제목 (title) 선택 사항입니다. 사람에게 표시되는 이름입니다.
  • 본문 마크다운으로 작성합니다. 상단의 편집/미리보기 토글로 렌더링 결과를 바로 확인할 수 있습니다.
저장하면 리트리벌용 임베딩이 자동으로 갱신됩니다.

​
Settings 탭에서 정하는 것

Basics 공간 이름을 바꿉니다. 패러다임(Wiki)은 생성 후 고정입니다. Flow 바인딩 이 공간을 특정 Flow 하나에 바인딩하면 그 Flow 의 모든 Agent 가 자동으로 이 공간을 읽고 씁니다. 바인딩하지 않으면 Flow 빌더에서 Agent 마다 개별로 붙입니다. 스코프 어떤 요청 파라미터로 노트를 나눌지 정합니다. flow_id / thread_id / user_id / 커스텀 키를 조합할 수 있습니다. 스코핑을 참고하세요. Access (선택) 파티션 키(호출자 신원으로 자동 필터)와 필요 권한 게이트를 걸어 접근 자체를 통제합니다. 스코핑 → 접근 제어를 참고하세요. Memory agent (큐레이터) Wiki 공간을 관리하는 에이전트입니다. 무엇을 남기고, 늘리고, 지울지 이 에이전트가 정합니다.
  • 모델 추출·통합을 수행합니다. 워크스페이스에 키를 등록한 공급자 중에서 고릅니다. 비우면 저비용 기본값을 씁니다.
  • 정책 프롬프트 무엇을 남기고 지울지 지시하는 자유 문장. 예: “고객의 안정적 선호·결정은 남기고, 잡담은 버리고, 선호가 바뀌면 기존 것을 대체.”
  • 멀티모달 이미지·음성·비디오를 메모리에 어떻게 담을지 (재사용 / 참조 / 재분석). 재분석은 추가 비용이 듭니다.
  • 백그라운드 저장 켜 두면 저장·삭제가 응답 경로 밖에서 처리되어 응답 지연이 없습니다. 검색은 항상 동기입니다. 켜 두기를 권합니다.

​
Agent 에 붙이기

Flow 빌더에서 Agent 를 열고 메모리 탭 → 메모리 추가 로 붙입니다. 예산이 걱정이면 같은 탭의 메모리 최대 비용을 켜세요. Flow 전체가 같은 Wiki 를 쓴다면 Settings 의 Flow 바인딩을 쓰는 것이 편합니다.

​
노트가 쌓이는 방식

세 가지 경로가 있습니다. 메모리 에이전트가 자동으로 실행이 끝날 때 위 정책 프롬프트 에 따라 남길 것을 추려 씁니다. 사용자 개입 없이 이 경로가 대부분을 채웁니다. Agent 가 명시적으로 Agent 프롬프트에서 저장을 지시하도록 만들 수 있습니다. 트레이스에 도구 호출로 남아 가시성이 좋고, 어떤 것을 남길지 프롬프트로 좁게 제어할 수 있습니다. 직접(사람) 또는 CLI Wiki 상세 페이지에서 새 노트를 직접 작성하거나, nora memory 로 스크립트 실행. 알려진 사실을 미리 채워 두거나 기존 스토어에서 이전할 때 유용합니다.

​
노트가 검색되는 방식

Wiki 가 붙은 Agent 가 모델을 부를 때마다 자동으로 리트리벌이 걸립니다. 지식 검색과 비슷하지만 스코프가 걸리고, 메모리에 맞춘 랭킹을 씁니다.
  • 관련성 지금 쿼리와 노트 내용의 의미적 거리
  • 최근성 최근에 쓴 노트를 위로. 시간이 지나면 점수가 감쇠
  • 중요도 중요도가 높은 노트를 위로
리트리벌 프리셋은 Agent마다 다르게 설정할 수 있습니다. Agent 인스펙터의 메모리 탭에서 연결한 공간별로 Retrieval preset 을 고릅니다.

​
룰 스타일 노트

절차·룰을 담을 때는 노트에 트리거·액션을 명확히 적으면 메모리 에이전트가 관련 상황에서 잘 회상해 옵니다.
정책 프롬프트에 “룰 형식 노트는 관련 상황에서 항상 컨텍스트에 포함” 이라고 지시해 두면 룰이 매 턴 반영됩니다. Wiki 자체에 “rule” 타입이라는 개념은 없고, 그냥 마크다운 노트의 관례일 뿐입니다.

​
노트 정리

  • 편집 노트 클릭 → 에디터에서 수정. 저장 시 임베딩 자동 갱신
  • 검색에서 제외 에디터 우측 상단 ⋯ 메뉴 → 검색에서 제외. 소프트 삭제라 리트리벌에서 사라지고 하단에 되돌리기 토스트가 잠깐 뜹니다
  • 중복 같은 스코프 안에서 사실상 같은 내용이 자동으로 병합됩니다. Agent 가 “Alice 는 이메일을 선호” 를 다섯 번 쓰는 일이 없습니다.
더 자세한 정리 방법은 잊기를 참고하세요.

​
트레이스에서 살펴보기

Draft 실행 시 트레이스 뷰에서 실행당 모든 메모리 읽기·쓰기가 보입니다.
  • 읽기 쿼리, 반환된 top-N 항목, 스코프
  • 쓰기 내용, 스코프, 새 항목인지 중복 업데이트인지
배포 전 Draft 에서 메모리 동작을 확인하기 좋습니다.