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

# 태그·정리

> 부서·대상·기능·최신성으로 문서 그룹화해서 Agent 가 적절한 하위집합을 끌어오게 함.

태그는 큰 지식 베이스를 슬라이스하는 방법입니다. Agent 가 전체 컬렉션에 붙을 수 있지만, **태그 필터** 로 그 Agent 의 작업에 관련된 하위집합으로 제한.

## 태그 두 종류

* **수동 태그** — 업로드 시 또는 나중에 여러분이 추가. 완전한 통제.
* **자동 태그** — Foundry 파이프라인의 (또는 컬렉션 인제스트 기본값의) 자동 태그 강화기가 추가. 일관되고 확장 가능.

둘 다 같은 필드에 쓰고, 동일하게 필터 가능.

## 태그 팔레트

워크스페이스는 공유된 **태그 팔레트** — 드롭다운에서 누구나 고를 수 있는 태그 목록 — 를 가짐. 오타 변형 방지 (`billing`, `Billing`, `bills`).

**Workspace settings → Tags** 에서 팔레트에 태그 추가. 자유형 태깅은 여전히 허용되지만 팔레트에 없는 태그는 하이라이트되어 추가 (또는 오타 수정) 할 수 있게 함.

## 권장 태그 축

대부분 워크스페이스는 몇 가지 표준 축을 따라 태그를 갖게 됨:

* **Audience**: `internal`, `customer`, `partner`, `developer`.
* **Domain**: `billing`, `auth`, `pricing`, `security`, `support`, `product`.
* **Freshness**: `current`, `deprecated`, `draft`.
* **Access**: `public`, `restricted`, `secret`.
* **Language**: `en`, `ko`, `ja`, `es` (언어 강화기가 자동 추가).

축 몇 개 고르고 고수. 일관성이 커버리지를 이김.

## 폴더

컬렉션은 **폴더** 지원 — 태그와 별개인 계층 위치. 문서는 하나의 폴더와 여러 태그.

폴더는 소스의 물리 배치가 중요할 때 유용 (예: Google Drive 폴더 트리 미러링). 태그는 같은 문서가 여러 슬라이스에 속할 때 유용.

## 리트리벌에서 태그 필터

리트리벌 프리셋과 Agent 별 필터는 태그 술어를 받음:

```json theme={null}
{ "tag": { "$in": ["billing", "pricing"] } }
```

[필터](/ko/build/retrieval/filters) 참고.

## 벌크 태그 작업

컬렉션 뷰에서:

* 여러 문서 선택 (체크박스).
* **Add tags** 또는 **Remove tags** 벌크.
* 또는 CLI: `nora knowledge tag <query> --add billing`.

## 파이프라인에서 자동 태깅

Foundry 파이프라인에 **Auto-tag (LLM)** 강화기 추가. 가능한 태그 목록과 한 줄 설명 제공. 모든 새 청크가 0-N 태그로 분류됨.

증분 실행 — 후속 실행에서 새로운/바뀐 청크만 태깅.

## 태그 통계

**Insights** 페이지가 태그 분포 표시:

* 태그별 문서/청크 수.
* 커버리지 — 태그 0개인 문서 수 (자동 태깅 대상).
* 리트리벌 쿼리에서의 태그 빈도 (어떤 태그가 실제로 필터됨).

은퇴시킬 미사용 태그나 팔레트의 갭 발견에 유용.