> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 버전 개요

> 에이전트 설정을 코드로 다룸. 얼어붙고, 감사 가능, 즉시 롤백.

배포된 모든 Flow 가 **버전**. 버전은 불변 — 출시되면 얼어붙음. Nora 가 "프로덕션" 에서 현재 라이브 버전으로의 포인터 관리.

버전이 위험을 관리 가능하게 만듦. 롤백이 즉시라 자신 있게 배포 가능. 모든 배포가 고정 정체성 가지므로 명확히 감사 가능. 두 버전이 diff 할 두 것이라 정확히 비교 가능.

## 버전에 있는 것

버전이 캡처:

* Flow 의 **모든 블록**.
* 그 사이 **모든 와이어**.
* **모든 설정** (제한, 승인, 보존).
* **모든 붙은 프리셋** (리트리벌, 메모리, 인과 그래프).
* **모든 붙은 데이터 소스** — 특정 컬렉션 버전에 고정.
* 배포 시 제공한 **릴리스 노트**.

배포 후 버전에 관해 아무것도 못 바꿈. 롤백은 "current" 포인터 이동; 버전 자체 편집 안 함.

## 버전이 중요한 곳

<CardGroup cols={2}>
  <Card title="버전 배포" icon="rocket" href="/ko/reliable/versions/publish">
    Draft 를 새 버전으로 출시.
  </Card>

  <Card title="롤백" icon="rotate-left" href="/ko/reliable/versions/rollback">
    프로덕션을 이전 버전으로 가리킴.
  </Card>

  <Card title="버전 diff" icon="code-compare" href="/ko/reliable/versions/diff">
    무엇이 정확히 바뀌었는지 확인.
  </Card>

  <Card title="Draft" icon="pen" href="/ko/reliable/versions/drafts">
    프로덕션 만지지 않고 안전하게 편집.
  </Card>

  <Card title="감사 트레일" icon="clipboard-list" href="/ko/reliable/versions/audit">
    모든 배포, 롤백, 복원.
  </Card>
</CardGroup>

## 버전 번호

버전은 Flow 별 번호, v1 에서 시작. 번호가 단조 증가 — 번호가 출시된 순서 말해줌, 반드시 라이브 것이 아님.

또한 보임: 버전의 **콘텐츠 해시** — 버전 콘텐츠에서 파생된 짧은 ID. 같은 콘텐츠의 두 버전이 해시 공유 (드물지만 롤백 + 재롤 후 가능).

## 버전 라이프사이클

```
Draft → 배포 → 버전 (불변)
                 ↓
             라이브? (버전 포인터 통해)
                 ↓
             나중 배포로 superseded
                 ↓
             유예 기간 동안 버전 ID 로 접근 가능
                 ↓
             N 개월 후 아카이브 (쿼리 가능하지만 실행 불가)
```

설정 가능한 보존: superseded 된 후 버전이 얼마나 오래 실행 가능한지. 기본: 최근 10 버전 무기한, 오래된 것은 1년, 그 다음 아카이브.

## 배포된 포인터

모든 Flow 가 언제든 하나의 **배포된 포인터**. 프로덕션 트래픽 받는 버전 가리킴. 배포가 포인터 앞으로 이동. 롤백이 뒤로.

포인터가 실행되는 것 — 버전 자체는 저장소.

## 여러 포인터 (canary)

Canary 롤아웃용으로 두 포인터가 한 번에 활성 가능:

* **Primary** — 트래픽 대부분 처리하는 버전.
* **Canary** — 트래픽 % 처리하는 버전.

둘 다 고정 버전. 트래픽 분할이 Flow 레벨에 정의.