> 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/get-started/ko/platform/workspaces/asset-library.md).

# 에셋 라이브러리

Asset Library를 사용하면 하나의 장소에서 전체 Workspace의 이미지와 동영상을 찾고 관리할 수 있습니다. Workspace 사이드바의 "Asset Library"에서 엽니다.

<figure><img src="/files/14dc0b774adee9b3a4ec832adc3195fbb83795e3" alt=""><figcaption><p>Workspace의 모든 프로젝트에서 이미지를 찾기 위해 의미 기반 검색("boxes") 사용</p></figcaption></figure>

### 이미지와 동영상 찾기

Asset Library 검색은 다음을 결합합니다:

* 의미 기반 검색: 찾고 있는 내용을 설명하세요(예: `상자`)를 입력하면 일치하는 이미지와 동영상을 반환합니다
* [유사도 검색](https://docs.roboflow.com/datasets/annotate/annotate/use-roboflow-annotate/similarity-search-and-settings): 시각적으로 유사한 이미지를 찾습니다(예: `like-image:61JNhXnwbNqNxux5Acnk`)
* [데이터셋 필터링](https://docs.roboflow.com/datasets/manage/manage-datasets/dataset-search): 클래스, 태그 또는 기타 필드로 필터링합니다(예: `class:helmet AND NOT (tag:v1 OR tag:v2)`)
* [메타데이터 검색](https://docs.roboflow.com/datasets/create-and-upload/adding-data/image-metadata#searching-by-metadata): 사용자 지정 메타데이터로 필터링합니다(예: `metadata:author=John`)

업로드된 동영상은 의미 기반 검색을 위해 자동으로 색인됩니다. 각 동영상의 첫 프레임에서 썸네일이 생성되어 결과를 한눈에 식별할 수 있습니다.

### 프로젝트 유형별 필터링

선택한 유형의 프로젝트(예: Object Detection, Classification, Instance Segmentation, Keypoint Detection, Multimodal)에서 온 이미지와 동영상만 표시하려면 "Type" 드롭다운을 사용하세요. Workspace에 둘 이상의 유형의 프로젝트가 있을 때 "Type" 드롭다운이 표시됩니다.

### 이미지 관리

이미지를 개별적으로 선택하거나, "Select All"을 사용하여 현재 검색 쿼리와 일치하는 모든 이미지를 선택하세요. 그러면 페이지 하단에 고정 작업 표시줄이 나타납니다. 작업 표시줄에서 다음을 할 수 있습니다:

* 추가 [태그](https://docs.roboflow.com/datasets/manage/manage-datasets/add-tags-to-images) 및 [메타데이터](https://docs.roboflow.com/datasets/create-and-upload/adding-data/image-metadata) 를 선택한 이미지에
* 선택한 이미지로 새 Project 만들기
* 선택한 이미지를 기존 Project에 추가하기
* [Workflow 실행](#running-a-workflow) 를 선택한 이미지에 백그라운드 Batch Processing 작업으로
* 검색 결과 내보내기/다운로드
* Workspace에서 이미지 삭제

"Select All"을 활성 검색과 함께 사용하면 이러한 작업은 현재 페이지에 보이는 이미지뿐만 아니라 Workspace 전체의 모든 일치 결과에 적용됩니다.

내보내기는 항상 전체 검색 쿼리를 대상으로 하므로, "Select All"을 사용할 때까지 비활성화된 상태로 유지됩니다. 이렇게 하면 다운로드한 내용이 선택한 내용과 일치합니다.

{% hint style="info" %}
Asset Library 검색 결과를 내보내고 다운로드하려면 "Export Workspace Images" 권한이 필요하며, 이 권한은 기본적으로 workspace 소유자에게 부여됩니다. 다음이 있는 workspace에서는 [사용자 지정 역할](/get-started/ko/platform/enterprise-features/role-based-access-control.md#custom-roles), 다른 역할에 부여할 수 있습니다. 이 권한이 없는 멤버는 내보내기 작업을 볼 수 없습니다.
{% endhint %}

### Workflow 실행하기

다음을 실행할 수 있습니다 [워크플로](https://docs.roboflow.com/workflows) 선택한 이미지에 대해 하나의 [배치 처리](https://docs.roboflow.com/deployment/roboflow-cloud/batch-processing) 작업입니다. 이는 분류, 탐지, 품질 점수와 같은 모델 출력으로 대규모 이미지 집합을 한 번에 보강하는 데 유용합니다.

원하는 이미지를 선택한 다음 작업 표시줄에서 "Run Workflow"를 클릭하세요. 모달에서:

* 실행할 Workflow를 선택하세요. 정확히 하나의 `이미지` 입력값이 있어야 합니다.
* Machine 유형을 선택하세요. CPU는 더 작은 탐지, 분류, 분할 모델에 가장 적합합니다. GPU는 더 빠르며 SAM3, 대형 VLM, 더 큰 RF-DETR 또는 YOLO 모델과 같은 일부 모델에 필요합니다. Workflow에 GPU가 필요한 경우 자동으로 선택됩니다.
* "Start"를 클릭하세요.

작업은 백그라운드에서 Batch Processing 작업으로 실행됩니다. 진행 상황은 Activity Center와 Deployments 아래의 "Batch Processing" 탭에서 확인할 수 있습니다.

#### 결과를 Asset Library에 다시 쓰기

Workflow 결과를 Asset Library에서 검색 가능하게 하려면, Workflow가 각 원본 이미지에 attributes와 tags를 다시 기록하도록 하세요:

1. 다음을 추가하세요: `source_id` 를 Workflow의 Inputs 블록 아래에 입력하세요. Batch Processing이 이를 이미지당 값 하나씩 자동으로 채워줍니다.
2. 다음을 추가하세요: [Roboflow Asset Library 속성](https://docs.roboflow.com/workflows/blocks/blocks/data-storage/roboflow-asset-library-attributes) 블록에, 다음을 연결하고 `source_id` 그 안으로 넣고, 기록할 태그와 속성을 선택하세요.

작업이 완료되면 다음을 사용하여 해당 이미지를 찾을 수 있습니다 [메타데이터 및 태그 검색](https://docs.roboflow.com/datasets/create-and-upload/adding-data/image-metadata#searching-by-metadata) (예: `metadata:blur_score>0.7`, `tag:auto-labeled`).