> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.
# 노트와 회상
> Agent가 실행 중에 노트를 쓰고, 관련이 있을 때 다시 읽습니다
메모리 스페이스가 붙은 Agent는 **기억** 할 수 있습니다. 한 실행에서 노트를 쓰고 나중 실행에서 떠올리죠.
메커니즘은 Nora가 다룹니다. 무엇을 쓸지, 언제 검색할지, 어떻게 랭크할지요. 여러분은 정책을 통제합니다.
## 노트의 모양
메모리 항목마다 이런 걸 가집니다.
* **Content** 텍스트.
* **Type** free note, fact, event, procedure.
* **Importance** 0\~1, 기본 0.5. 보존과 리트리벌 부스트에 영향을 줍니다.
* **Metadata** 임의 key/value(엔티티 ID, 소스 URL, 타임스탬프).
* **Scope** [스코핑](/ko/build/memory/scoping) 참고.
* **TTL** 만료(선택).
## Agent가 쓸 때
쓰기는 켜서 씁니다. 세 가지 방법입니다.
### 신호가 강한 이벤트에서 자동 쓰기
메모리 스페이스 붙임에서 **Auto-remember**를 켭니다. 기억할 값이 있을 때 Agent가 정합니다. 사용자가 새 선호를 알려 주거나, 도구가 안정된 사실을 돌려주거나, 절차 스텝이 먹힌다고 확인될 때죠. 쓰기는 더하기만 합니다. 뚜렷한 의도 없이는 아무것도 덮어쓰지 않습니다.
### 드러난 `remember` 도구
Agent에 `remember` 도구를 붙입니다. Agent가 정할 때 부릅니다. 사람이 노트를 쓰기로 정하는 것과 비슷하죠. 가시성(모든 쓰기가 트레이스에 도구 호출로 보임)과 통제(도구 설명을 손봐 쓰기를 부추기거나 누르기)를 줍니다.
### 프로그램으로 쓰기
코드나 CLI에서 씁니다.
```bash theme={null}
nora memory write --content "..." --scope '{"user":"alice"}'
```
알려진 사실로 스페이스에 씨를 뿌리거나, 기존 스토어에서 들여올 때 좋습니다.
## Agent가 읽을 때
읽기는 자동입니다. 메모리 스페이스가 붙은 모델 호출은 모두 리트리벌을 부릅니다. 지식 리트리벌과 비슷하지만 스코프가 걸리고 메모리에 맞춘 랭킹을 씁니다.
메모리 리트리벌은 이런 걸 섞습니다.
* 지금 쿼리와의 **의미 유사도**.
* **중요도**(중요도 높은 항목이 위로).
* **최근성**(최근 항목을 조금 올리고, 시간에 따라 감쇠).
* **접근 이력**(전에 리트리벌되어 잘 쓰인 항목이 위로).
옛 메모리가 새 것만큼 좋은 도메인(용어집, 자리 잡은 절차)은 최근성 부스트를 끄세요.
## 노트 고치기
Wiki 스페이스는 UI에서 바로 고칩니다. 노트를 누르면 에디터가 열립니다. 고치면 임베딩이 자동으로 업데이트됩니다.
Index 스페이스는 Agent가 읽고 씁니다. UI에서 바로 고칠 수 없습니다(대개 양이 너무 많습니다). 특정 항목을 지우거나 대체하려면 CLI나 관리자 액션을 씁니다.
## 중복 제거
같은 스코프 안에서 사실상 비슷한 내용을 두 번 쓰면 하나로 합쳐집니다. 둘째가 첫째의 업데이트가 되죠(중요도와 타임스탬프를 새로 하고, 내용이 조금 다르면 병합). Agent가 "Alice는 이메일을 선호" 를 다섯 번 쓰는 걸 막습니다.
중복 임계값은 스페이스마다 조정합니다(기본은 코사인 0.9).
## 통합
Nora가 주기적으로 스페이스를 통합합니다.
* 관련 노트를 더 강한 통합 노트로 합칩니다.
* 중요도 낮은 항목을 감쇠시킵니다.
* 중복 패턴을 접습니다.
스케줄로 자동(기본 주간)으로, 또는 수동으로 돌립니다. 통합은 감사 로그를 남깁니다. 정보를 잃지 않고 재구성만 합니다.
## 쓰기 살피기
트레이스 뷰가 실행당 모든 메모리 읽기/쓰기를 보여줍니다.
* 읽기: 쿼리, 돌아온 top-N 항목, 스코프.
* 쓰기: 내용, 중요도, 스코프, 새 항목인지 중복 업데이트인지.
배포 전 Draft에서 메모리 동작을 확인하기 좋습니다.