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

# 태그

> 워크스페이스 전체 리소스에 태그를 붙여 분류하고 필터링하는 중앙 관리 기능

워크스페이스의 에이전트, 지식기반, 플로우, 가드레일, 도구, 프롬프트, 데이터베이스, 용어집 — 리소스가 많아지면 원하는 항목을 찾기 어려워집니다.

태그는 **모든 워크스페이스 리소스에 공통으로 붙일 수 있는 라벨**입니다. "마케팅", "고객지원", "실험중" 같은 태그를 만들어 리소스를 분류하면, 각 목록에서 태그로 필터링할 수 있습니다.

***

## 태그 관리

**워크스페이스 > 태그** 탭에서 태그를 생성·수정·삭제합니다.

<Frame caption="태그 이름만 입력하면 즉시 태그가 생성됩니다.">
  <img src="https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tags-list.png?fit=max&auto=format&n=NKTn2BIqecyNib8M&q=85&s=d5c33dbcb08183a68dc2108fb8898f7d" alt="태그 관리" width="1911" height="906" data-path="images/workspace/tags-list.png" />
</Frame>

### 태그 생성

상단의 입력 필드에 태그 이름을 입력하고 **+ 생성** 버튼을 클릭합니다. 동일한 이름의 태그는 중복 생성할 수 없습니다.

### 태그 수정

태그 행 우측의 **연필 아이콘**을 클릭하면 이름을 즉시 수정할 수 있습니다. **Enter 버튼**이나 **체크표시**로 저장, **Esc 버튼**이나 **X표시**를 클릭하여 편집을 취소합니다.

### 태그 삭제

태그 행 우측의 **휴지통 아이콘**을 클릭하면 태그를 삭제할 수 있습니다. 삭제 시 **모든 워크스페이스 리소스에서 해당 태그가 제거**됩니다.

<Warning>
  태그 삭제는 되돌릴 수 없습니다. 삭제 전 확인 다이얼로그가 표시됩니다.
</Warning>

***

## 태그 적용

각 워크스페이스 리소스(에이전트, 지식기반 등)의 편집 화면에서 태그를 붙이거나 뗄 수 있습니다. 태그 적용과 더불어 리소스 위치에서 생성까지도 가능합니다.

**지원 리소스 유형:**

| 리소스        | 태그 적용 위치       |
| ---------- | -------------- |
| **에이전트**   | 에이전트 편집 화면     |
| **플로우**    | 플로우 편집기        |
| **지식기반**   | 지식기반 편집 화면     |
| **데이터베이스** | DbSphere 편집 화면 |
| **용어집**    | 용어집 편집 화면      |
| **지식 그래프** | 지식 그래프 편집 화면   |
| **가드레일**   | 가드레일 편집 화면     |
| **프롬프트**   | 프롬프트 편집 화면     |
| **도구**     | 도구 편집 화면       |

***

## 권한

| 작업            | 필요 권한           |
| ------------- | --------------- |
| 태그 조회         | 로그인한 모든 사용자     |
| 태그 생성         | 로그인한 모든 사용자     |
| 태그 수정/삭제      | 태그 생성자 또는 Admin |
| 리소스에 태그 부착/해제 | 로그인한 모든 사용자     |

***

## 활용 예시

<AccordionGroup>
  <Accordion title="부서별 분류">
    "마케팅", "개발", "인사", "재무" 태그를 만들어 각 부서에서 사용하는 에이전트와 지식기반을 구분합니다.
  </Accordion>

  <Accordion title="상태 관리">
    "운영중", "실험중", "폐기예정" 태그로 리소스의 생명주기를 관리합니다.
  </Accordion>

  <Accordion title="프로젝트별 묶기">
    "프로젝트-A" 태그를 에이전트, 지식기반, 프롬프트에 공통으로 붙여 관련 리소스를 한눈에 파악합니다.
  </Accordion>
</AccordionGroup>