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

# 태그·정리

> 부서·대상·기능·최신성으로 문서를 묶어, Agent가 알맞은 일부를 끌어오게 합니다

태그는 큰 지식 베이스를 잘라 쓰는 방법입니다. Agent가 컬렉션 전체에 붙을 수 있지만, **태그 필터**로 그 Agent의 일에 맞는 일부로 좁힙니다.

## 태그 두 종류

* **수동 태그** 올릴 때나 나중에 여러분이 답니다. 완전히 통제합니다.
* **자동 태그** 파운더리 파이프라인의(또는 컬렉션 인제스트 기본값의) 자동 태그 강화기가 답니다. 한결같고 대규모로 됩니다.

둘 다 같은 필드에 쓰이고 똑같이 거를 수 있습니다.

## 태그 팔레트

워크스페이스에 공유 **태그 팔레트**가 있습니다. 드롭다운에서 누구나 고르는 태그 목록이죠. 오타 변형(`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`.

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

파운더리 파이프라인에 **Auto-tag (LLM)** 강화기를 더합니다. 쓸 수 있는 태그 목록과 한 줄 설명을 줍니다. 새 청크마다 0\~N개 태그로 분류됩니다.

증분으로 돕니다. 이후 실행에서는 새로 생기거나 바뀐 청크만 태그합니다.

## 태그 통계

**Insights** 페이지가 태그 분포를 보여줍니다.

* 태그별 문서/청크 수.
* 커버리지. 태그가 하나도 없는 문서 수(자동 태깅 대상).
* 리트리벌 쿼리에서 태그가 얼마나 쓰이는지(어느 태그가 실제로 필터됐는지).

안 쓰는 태그를 물리거나 팔레트의 구멍을 찾을 때 좋습니다.