> ## 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.

# 버전과 supersede

> 감사 이력을 지우지 않고 오래된 지식을 물립니다

콘텐츠는 바뀝니다. 가격이 바뀌고, 정책이 개정되고, 제품 문서가 이전 버전을 대신하죠. 오래된 걸 지우는 대신 **supersede** 하세요. 옛 버전은 리트리벌에서 숨지만 감사용으로는 조회됩니다.

## Supersede와 삭제

|           | Supersede | 삭제  |
| --------- | --------- | --- |
| 리트리벌에서 빠짐 | 예         | 예   |
| 저장소에서 제거  | 아니오       | 예   |
| 나중에 감사 가능 | 예         | 아니오 |
| 되돌리기 가능   | 예         | 아니오 |
| 저장 쿼터 해제  | 아니오       | 예   |

기본은 supersede 입니다. 삭제는 꼭 필요할 때만 하세요(PII 내림, 법적 제거).

## Supersede 하는 법

세 가지입니다.

### 수동

문서에서 우클릭 → **Supersede** 입니다. 대체 문서를 고를 수 있습니다. 인용 트레일이 둘을 이어, 옛 버전을 읽는 사람이 어디로 가야 할지 알게 합니다.

### 재업로드 시 자동 supersede

기존과 같은 **정본 URL**이나 같은 **소스 경로**의 문서를 올리면, Nora가 옛것을 새것으로 자동 supersede 하자고 제안합니다.

파운더리 파이프라인의 Source 단계가 소스 콘텐츠 변경을 볼 때도 자동으로 걸립니다. 옛 청크는 superseded 되고 새 청크가 쓰입니다.

### 대량

* 여럿 골라 → **Supersede selection**.
* CLI: `nora knowledge supersede <query>`.

## Un-supersede

모두 되돌릴 수 있습니다. superseded 문서로 거르고(**View → Superseded**), 되살릴 걸 골라 **Restore**를 누릅니다. 몇 초면 활성 인덱스로 돌아옵니다.

## 트레이스의 Superseded 문서

Agent가 나중에 superseded 된 청크로 실행됐다면, 트레이스가 눈에 띄게 표시합니다. 오래된 답을 살필 때 좋습니다. 그때는 그 답이 옳았다는 걸 볼 수 있죠.

## 유효 날짜

**미래 날짜**로 supersede 할 수 있습니다. 문서가 그 날짜까지 살아 있다가 자동으로 리트리벌에서 빠집니다. 시간에 민감한 콘텐츠에 좋습니다.

* "옛 수수료표는 2026-08-01에 superseded."
* "SDK 5.0이 나오면 폐기 API 문서를 supersede."

## 버전 체인

한 문서를 여러 번 supersede 하면 버전 체인이 생깁니다. 어느 버전에서든 양방향으로 오갈 수 있습니다.

```
v1 → v2 (v2로 superseded) → v3 (v3로 superseded) → current
```

특정 날짜에 Agent가 무엇을 리트리벌했을지 되짚을 때 좋습니다.

## 보존

superseded 문서도 저장에 잡히지만 더 쌉니다(오래 superseded 된 콘텐츠는 메타데이터만 남습니다). 기본은 무기한 보관입니다. **Collection settings → Superseded retention**에서 보존 정책을 정합니다. N일 뒤 자동 삭제로요.

## 감사 뷰

**Insights → Supersede log**가 모든 supersede 작업을 보여줍니다.

* 누가, 언제.
* 어느 문서, 어느 대체(있다면).
* 수동인지 자동인지 CLI 인지.

거를 수 있고 내보낼 수 있습니다.