> 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/dataset-search.md).

# 데이터셋 검색

Roboflow에서 파일 이름, 검색 쿼리로 이미지 파일을 검색할 수 있으며, 쿼리와 필터를 조합해 특정 이미지를 찾고 데이터를 더 잘 이해할 수 있습니다.

* **특정 태그가 있는 split의 이미지:**\
  `tag:factory split:train`\
  이는 tag 필터와 split 필터를 사용합니다
* **semantic search와 class 필터를 사용해 누락된 레이블을 찾기**:\
  `person -class:helmet`\
  이는 semantic search와 class 필터에 대한 반전 필터를 사용합니다
* **특정 class의 모든 이미지에 특정 필터가 필요하다면:**\
  `class:helmet AND NOT (tag:v1 OR tag:v2)`\
  이는 class 필터, boolean logic, 그리고 tag 필터를 사용합니다
* **주석 수가 적은 넓은 이미지를 찾기:**\
  `min-width:1000 max-annotations:1`\
  이는 최소 너비 필터와 최대 주석 수 필터를 사용합니다

전체 목록 보기 [검색 필터](#search-filters), 아래 예시도 함께 확인하세요

{% hint style="info" %}
이 모든 search 필터와 쿼리를 함께 조합할 수 있습니다
{% endhint %}

### Semantic Search

이미지를 설명해서 검색할 수 있습니다. 이러한 쿼리는 검색어와 가장 관련성이 높은 이미지를 찾아주며, 객체에 아직 label이 지정되지 않은 경우에도 이미지를 찾는 데 도움이 됩니다.

텍스트 쿼리를 필터 선택자 없이 입력하면 semantic search가 실행됩니다(예: `filename:`)

<figure><img src="/files/543d9892b3d86e0a7bd062f1fef2a446d3062bf8" alt=""><figcaption></figcaption></figure>

### 파일 이름으로 검색

다음을 사용해 파일 이름을 검색할 수 있습니다: `filename:` 필터 또는 파일 이름 텍스트 상자를 사용하면 쿼리가 자동으로 생성됩니다.

<figure><img src="/files/4388ee546318da318eb0cb25c5b5097bb21a0ed4" alt="" width="192"><figcaption></figcaption></figure>

### 데이터셋 split으로 검색

데이터셋 split(train, valid, test)으로 이미지를 검색합니다

<figure><img src="/files/9a10f464088db16c62c68b720edc0e3c61b44738" alt="" width="257"><figcaption></figcaption></figure>

## 검색 필터

사용 가능한 필터는 다음과 같습니다:

* `like-image:<IMAGE_ID>`: 이미지 콘텐츠를 기반으로 하는 semantic search
* `tag` : 사용자가 제공한 tag로 필터링합니다.
* `filename` : 제공된 파일 이름과 일치하는 파일 이름을 검색합니다. 부분 일치를 실행하려면 쿼리의 앞뒤에 \*를 사용하세요.
* `split` : split(train, test, valid)으로 필터링합니다.
* `job:<JOB_ID>` : 제공된 job ID가 있는 이미지를 표시합니다.
* `min-width:X` : 너비가 X보다 큰 이미지를 표시합니다.
* `max-width:X` : 너비가 X보다 작은 이미지를 표시합니다.
* `min-height:X` : 높이가 X보다 큰 이미지를 표시합니다.
* `max-height:X` : 높이가 X보다 작은 이미지를 표시합니다.
* `min-annotations:X` : 지정한 개수보다 많은 주석이 있는 이미지를 필터링합니다.
* `max-annotations:X` : 지정한 개수보다 적은 주석이 있는 이미지를 표시합니다.
* `class:CLASS`: 제공된 label이 최소 1개 이상 있는 이미지를 표시합니다.

### 불리언 논리

AND, OR, NOT 및 괄호를 사용해 여러 필터를 결합하여 복잡한 쿼리를 만드세요.

`class:helmet AND NOT (tag:v1 OR tag:v2)`

### 반전 필터

필터 앞에 마이너스 기호를 붙여 해당 필터와 일치하는 이미지를 제외하세요.

`class:helmet -class:vest`

### 숫자형 class 필터

이미지 내 label이 지정된 항목 수로 필터링합니다.

`class:helmet=3 class:vest>=4`

## API를 통해

Roboflow에서 다음을 통해 데이터셋과 이미지를 검색할 수도 있습니다: [Search API](https://docs.roboflow.com/api-reference/images/search#rest-api).


---

# 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/dataset-search.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.
