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

# nora documents

> 지식 라이브러리의 문서 관리 — 나열, 태그, supersede.

문서가 지식의 원시 단위 — 파일, 페이지, 추출. 인제스트 (Foundry 파이프라인이나 웹 업로드로) 되면 Agent 가 리트리벌하는 라이브러리에 삶.

`documents` CLI 가 라이브러리 일상 관리 표면: 나열, 태그, supersede.

## 명령

| 명령                                                  | 설명                     |
| --------------------------------------------------- | ---------------------- |
| `documents list [--tag <tag>]`                      | 문서 나열 (옵션으로 폴더 태그에서).  |
| `documents get <doc-id>`                            | 한 문서의 전체 메타데이터 인쇄.     |
| `documents supersede <doc-id> [--restore]`          | Superseded 표시 (또는 복원). |
| `documents tag <doc-id> [--add ...] [--remove ...]` | 폴더 태그 추가·제거.           |

## `documents list`

```bash theme={null}
nora documents list
nora documents list --tag billing
```

문서당 로우 하나 인쇄: ID, 제목, 콘텐츠 타입, 크기, 태그, 마지막 업데이트.

스크립트 가능 출력에 `--json` 추가.

## `documents get`

```bash theme={null}
nora documents get doc_abc
```

전체 메타데이터 인쇄 — 제목, 소스 URL, 콘텐츠 해시, 태그, 생성한 인제스트 파이프라인, 청크 카운트, supersede 상태.

## `documents supersede`

```bash theme={null}
nora documents supersede doc_abc
# 나중, undo:
nora documents supersede doc_abc --restore
```

문서를 superseded 로 표시 — 모든 리트리벌에서 숨김이지만 감사용으로 여전히 쿼리 가능. Superseded 청크가 몇 초 안에 쿼리 매치 중단.

`--restore` 가 supersede 되돌림. 문서가 리트리벌 인덱스에 재합류.

삭제보다 supersede 선호: 되돌리기 가능하고 감사 트레일 보존. 삭제는 진짜 테이크다운 (PII, 법적 제거) 에만 적절 — 그것도 CLI 아닌 라이브러리 UI 사용, 삭제가 확인 필요하므로.

## `documents tag`

```bash theme={null}
# 태그 추가
nora documents tag doc_abc --add customer-facing,billing

# 제거
nora documents tag doc_abc --remove deprecated

# 둘 다 한 번에
nora documents tag doc_abc --add current --remove draft
```

태그가 큰 라이브러리 슬라이스하는 주요 방법. 태그 위생은 [태그·정리](/ko/build/knowledge/tag) 참고.

Comma 로 구분된 목록 수용. `--add` 와 `--remove` 둘 다 옵션 (하지만 최소 하나 필수).

## 레시피

### 문서 세트를 한 폴더에서 다른 폴더로 이동

```bash theme={null}
for id in $(nora documents list --tag old-folder --json | jq -r '.[].id'); do
  nora documents tag $id --add new-folder --remove old-folder
done
```

### 날짜보다 오래된 모든 것 supersede

```bash theme={null}
cutoff="2025-01-01"
for id in $(nora documents list --json | jq -r --arg cutoff "$cutoff" '.[] | select(.updated_at < $cutoff) | .id'); do
  nora documents supersede $id
done
```

### 태그 커버리지 감사

```bash theme={null}
nora documents list --json | jq -r '.[] | select((.tags // []) | length == 0) | .id'
```

태그 없는 문서 인쇄 — Foundry 강화기로 자동 태깅 후보.

### 문서 메타데이터를 git 에 스냅샷

```bash theme={null}
nora documents list --json > snapshots/documents-$(date +%Y%m%d).json
```

콘텐츠 익스포트 없이 시간에 걸친 라이브러리 변경 추적에 유용.

## CLI 가 하지 않는 것

* **업로드** — 일회성 업로드는 앱 사용 ([문서 업로드](/ko/build/knowledge/upload) 참고) 또는 자동 인제스트는 Foundry 파이프라인 ([`nora pipelines`](/ko/cli/pipelines) 참고).
* **삭제** — CLI 는 supersede 만 가능. 하드 삭제는 앱 UI 사용 (이중 확인 있음).
* **콘텐츠 편집** — 문서가 인제스트되면 불변; 소스 편집하고 재인제스트.

이 제약이 의도적 — CLI 가 시각 리뷰 필요한 편집이 아닌 스크립트 작업에 최적화.

## 문서 ID 가 오는 곳

* **앱** — 라이브러리의 모든 문서가 세부 패널에 ID 표시.
* **Foundry 로그** — `pipelines logs get` 이 실행이 생성한 문서 ID 표시.
* **`documents list`** — 스크립팅용.