> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/roboflow/roboflow-ko/datasets/manage-datasets/add-tags-to-images.md).

# 이미지에 태그 추가

Roboflow는 이미지 태깅 기능을 제공합니다. 이 기능을 사용하면 업로드 중에 이미지에 태그를 지정할 수 있습니다. 이러한 태그는 라벨링을 위한 일괄 할당에 사용할 수 있어, 라벨링할 이미지를 할당할 때 더 높은 정밀도를 제공합니다. 또한 이미지 태그를 데이터셋과 연결된 Roboflow dataset search의 매개변수로 사용할 수 있습니다.

### 업로드 중 태그 할당

데이터 업로드 중에는 웹 인터페이스와 다음을 사용해 태그를 할당할 수 있습니다 [REST API 및 Python SDK](https://docs.roboflow.com/api-reference/images/upload-api). 아래 이미지는 웹 인터페이스를 사용해 업로드한 이미지에 연결할 태그를 지정하는 방법을 보여줍니다:

<figure><img src="/files/e27a06c79a29f9744daac0c429b3de5cfda3eaf0" alt="Opening the Tag menu prior to image Upload"><figcaption><p>이미지 업로드 전 태그 메뉴 열기</p></figcaption></figure>

### CLI

다음을 사용해 기존 이미지에 태그를 추가하거나 제거할 수 있습니다: `roboflow image metadata` 명령:

```bash
# 이미지에 태그 추가
roboflow image metadata <image_id> --tags "reviewed,v2"

# 이미지에서 태그 제거
roboflow image metadata <image_id> --remove-tags "draft,needs-review"

# 한 번의 호출로 태그 추가 및 제거
roboflow image metadata <image_id> --tags "approved" --remove-tags "pending"

# 여러 이미지의 태그를 일괄 업데이트
roboflow image metadata img1,img2,img3 --tags "processed" --poll
```

업로드 중에도 다음을 사용해 태그를 전달할 수 있습니다 `roboflow image upload`:

```bash
roboflow image upload photo.jpg -p my-project --tag "review,v2"
```

### 이미지 탭에서 태그 적용

이미지 탭에서 태그를 적용하려면 태그를 적용할 이미지를 클릭한 다음 페이지 오른쪽 상단의 "Images Selected" 버튼을 클릭하고, 이어서 "Apply tags"를 클릭하세요. 그러면 선택한 이미지에 원하는 수의 태그를 추가할 수 있습니다.

<figure><img src="/files/dacabad13553ecfd8047b564471d274ceb5d9487" alt=""><figcaption><p>선택한 이미지에 태그 적용</p></figcaption></figure>

### 프로젝트 전체에서 태그 이름 바꾸기 또는 삭제하기

프로젝트의 모든 이미지에 걸쳐 태그의 이름을 바꾸거나 삭제하려면 프로젝트의 "Settings" 페이지에서 "Tags" 탭을 여세요.

1. 체크박스 열을 사용해 수정하려는 태그를 선택하세요.
2. 툴바에서 "Rename" 또는 "Delete"를 클릭하세요.
3. 이름을 바꾸려면 각 태그의 새 이름을 입력한 뒤 "Review Changes"를 클릭하고, 그다음 "Confirm Changes"를 클릭하세요.
4. 삭제하려면 목록을 검토하고 확인하세요.

### 태그로 이미지 필터링

Roboflow 대시보드의 Assign 페이지에서 태그를 사용해 이미지를 필터링할 수 있습니다:

<figure><img src="/files/fe992eac56122ca7dfbf919c15de0c8c658b147e" alt="Filtering by Existing dataset Tags from within the Assign tool"><figcaption><p>Assign 도구에서 기존 dataset Tags로 필터링하기</p></figcaption></figure>

### Versions에서 데이터를 선별할 때 Tags 사용

다음 [Filter by Tag](https://docs.roboflow.com/datasets/image-preprocessing#filter-by-tag) 전처리 단계에서는 특정 데이터를 포함하거나 제외하는 데이터셋 Version을 만들 수 있습니다. 이 전처리 단계를 사용하면 선별된 일부 데이터만 학습하거나 내보낼 수 있습니다.

<figure><img src="/files/640efff5437e6f889b42a1e2fb631028e6aea1f1" alt=""><figcaption><p>"Filter by Tag" 전처리 단계를 사용해 특정 태그가 데이터셋 Version에 포함되도록 하거나 차단하도록 설정하세요.</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/roboflow/roboflow-ko/datasets/manage-datasets/add-tags-to-images.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.