Skip to main content
메모리 스페이스가 붙은 Agent는 기억 할 수 있습니다. 한 실행에서 노트를 쓰고 나중 실행에서 떠올리죠. 메커니즘은 Nora가 다룹니다. 무엇을 쓸지, 언제 검색할지, 어떻게 랭크할지요. 여러분은 정책을 통제합니다.
Wiki 스페이스에 쌓인 노트 — 왼쪽에 노트 목록, 오른쪽에 마크다운 본문이 보인다

노트의 모양

메모리 항목마다 이런 걸 가집니다.
  • Content 텍스트.
  • Type free note, fact, event, procedure.
  • Importance 0~1, 기본 0.5. 보존과 리트리벌 부스트에 영향을 줍니다.
  • Metadata 임의 key/value(엔티티 ID, 소스 URL, 타임스탬프).
  • Scope 스코핑 참고.
  • TTL 만료(선택).

Agent가 쓸 때

쓰기는 켜서 씁니다. 세 가지 방법입니다.

신호가 강한 이벤트에서 자동 쓰기

메모리 스페이스 붙임에서 Auto-remember를 켭니다. 기억할 값이 있을 때 Agent가 정합니다. 사용자가 새 선호를 알려 주거나, 도구가 안정된 사실을 돌려주거나, 절차 스텝이 먹힌다고 확인될 때죠. 쓰기는 더하기만 합니다. 뚜렷한 의도 없이는 아무것도 덮어쓰지 않습니다.

드러난 remember 도구

Agent에 remember 도구를 붙입니다. Agent가 정할 때 부릅니다. 사람이 노트를 쓰기로 정하는 것과 비슷하죠. 가시성(모든 쓰기가 트레이스에 도구 호출로 보임)과 통제(도구 설명을 손봐 쓰기를 부추기거나 누르기)를 줍니다.

프로그램으로 쓰기

코드나 CLI에서 씁니다.
알려진 사실로 스페이스에 씨를 뿌리거나, 기존 스토어에서 들여올 때 좋습니다.

Agent가 읽을 때

읽기는 자동입니다. 메모리 스페이스가 붙은 모델 호출은 모두 리트리벌을 부릅니다. 지식 리트리벌과 비슷하지만 스코프가 걸리고 메모리에 맞춘 랭킹을 씁니다. 메모리 리트리벌은 이런 걸 섞습니다.
  • 지금 쿼리와의 의미 유사도.
  • 중요도(중요도 높은 항목이 위로).
  • 최근성(최근 항목을 조금 올리고, 시간에 따라 감쇠).
  • 접근 이력(전에 리트리벌되어 잘 쓰인 항목이 위로).
옛 메모리가 새 것만큼 좋은 도메인(용어집, 자리 잡은 절차)은 최근성 부스트를 끄세요.

노트 고치기

Wiki 스페이스는 UI에서 바로 고칩니다. 노트를 누르면 에디터가 열립니다. 고치면 임베딩이 자동으로 업데이트됩니다. Index 스페이스는 Agent가 읽고 씁니다. UI에서 바로 고칠 수 없습니다(대개 양이 너무 많습니다). 특정 항목을 지우거나 대체하려면 CLI나 관리자 액션을 씁니다.

중복 제거

같은 스코프 안에서 사실상 비슷한 내용을 두 번 쓰면 하나로 합쳐집니다. 둘째가 첫째의 업데이트가 되죠(중요도와 타임스탬프를 새로 하고, 내용이 조금 다르면 병합). Agent가 “Alice는 이메일을 선호” 를 다섯 번 쓰는 걸 막습니다. 중복 임계값은 스페이스마다 조정합니다(기본은 코사인 0.9).

통합

Nora가 주기적으로 스페이스를 통합합니다.
  • 관련 노트를 더 강한 통합 노트로 합칩니다.
  • 중요도 낮은 항목을 감쇠시킵니다.
  • 중복 패턴을 접습니다.
스케줄로 자동(기본 주간)으로, 또는 수동으로 돌립니다. 통합은 감사 로그를 남깁니다. 정보를 잃지 않고 재구성만 합니다.

쓰기 살피기

트레이스 뷰가 실행당 모든 메모리 읽기/쓰기를 보여줍니다.
  • 읽기: 쿼리, 돌아온 top-N 항목, 스코프.
  • 쓰기: 내용, 중요도, 스코프, 새 항목인지 중복 업데이트인지.
배포 전 Draft에서 메모리 동작을 확인하기 좋습니다.