> 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>이미지 업로드 전에 Tag 메뉴 열기</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 탭에서 태그 적용

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

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

### Project 전체에서 태그 이름 바꾸기 또는 삭제

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

1. 체크박스 열을 사용해 수정할 태그를 선택하세요.
2. 도구 모음에서 "Rename" 또는 "Delete"를 클릭하세요.
3. 이름 변경의 경우 각 태그의 새 이름을 입력한 다음 "Review Changes"를 클릭하고, তারপর "Confirm Changes"를 클릭하세요.
4. 삭제의 경우 목록을 검토한 뒤 확인하세요.

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

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

<figure><img src="/files/daf4cbb893190af377f5366b6172d36a99865374" alt="Filtering by Existing dataset Tags from within the Assign tool"><figcaption><p>Assign 도구 내에서 기존 dataset 태그를 기준으로 필터링</p></figcaption></figure>

### Versions에서 데이터를 선별하는 데 Tags 사용

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

<figure><img src="/files/640efff5437e6f889b42a1e2fb631028e6aea1f1" alt=""><figcaption><p>"Filter by Tag" 전처리 단계를 사용하면 특정 태그가 dataset 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
