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

# nora knowledge

> 지식 폴더와 폴더별 접근 규칙을 터미널에서 관리합니다

지식 폴더는 라이브러리 사이드바가 보여 주는 태그 집합과 같습니다. 폴더 하나가 Agent 가 리트리벌하는 문서 한 갈래입니다. **접근 규칙** 은 어느 테넌트 역할이 어느 폴더의 문서를 볼 수 있는지 가릅니다. 두 표면 모두 `nora knowledge` 아래에 있습니다.

## 명령 그룹

* **폴더**: `knowledge folders list/add/delete`
* **접근 규칙**: `knowledge access list/set`

## 폴더

### list

```bash theme={null}
nora knowledge folders list
```

워크스페이스에 등록된 모든 폴더(스테이지 목록) 를 출력합니다.

### add

```bash theme={null}
nora knowledge folders add contracts
```

빈 폴더를 만듭니다. 이미 있으면 no-op(idempotent). 새 폴더에 문서를 태그하기 전에 미리 만들어 두면 사이드바가 바로 인식합니다.

### delete

```bash theme={null}
nora knowledge folders delete contracts
```

스테이지 목록에서 폴더를 제거합니다. 폴더로 태그된 문서는 **그대로 남습니다**. 폴더까지 완전히 없애려면 먼저 문서에서 태그를 떼거나 문서를 지우세요.

## 접근 규칙

규칙은 `{folder → {partitionKey?, requires[]}}` 모양입니다. `requires` 는 호출자가 가지고 있어야 하는 테넌트 권한 목록이고, `partitionKey` 는 폴더를 오퍼레이터가 정한 키(예: 리전별, 고객별) 로 좁힐 때 씁니다.

### list

```bash theme={null}
nora knowledge access list
```

지금 걸린 모든 규칙을 출력합니다.

### set

```bash theme={null}
# billing.read 권한 있는 호출자만 볼 수 있게
nora knowledge access set contracts --requires billing.read

# 여러 권한을 모두 요구
nora knowledge access set legal --requires legal.read,compliance.read

# 파티션 키 추가 (리전별 격리)
nora knowledge access set eu-contracts --partition-key region --requires legal.read

# 규칙 해제 (폴더가 열려 있게)
nora knowledge access set contracts
```

`--partition-key` 도 비우고 `--requires` 도 비우면 규칙 행이 삭제됩니다.

## 레시피

### 폴더 + 규칙 짝 부트스트랩

```bash theme={null}
nora knowledge folders add billing
nora knowledge access set billing --requires billing.read
```

### 폴더·접근 규칙을 git 에 스냅샷

```bash theme={null}
nora knowledge folders list --json > snapshots/folders.json
nora knowledge access list --json > snapshots/access.json
```

정책 변화 추적 후보. 이 스냅샷을 커밋해 두면 됩니다.

## 관련

* [`nora documents`](/ko/cli/documents) 문서에 폴더 태그를 붙이거나 뗍니다 (`documents tag --add <folder>`).
* [지식 개요](/ko/build/knowledge/overview) 폴더와 접근 규칙이 리트리벌 흐름에 어떻게 들어맞는지.