> 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="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-aabe82fa5ff2678c21c6cc543ccaa3df86467108%2Fasset-library.webp?alt=media" alt=""><figcaption><p>시맨틱 검색("boxes")을 사용해 Workspace의 모든 프로젝트에서 이미지 찾기</p></figcaption></figure>

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

Asset Library 검색에는 다음 기능이 결합되어 있습니다.

* 시맨틱 검색: 찾으려는 항목을 설명하면(예: `boxes`) 일치하는 이미지와 동영상을 반환합니다.
* [유사도 검색](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`)

필터 바에서 메타데이터 필터에 숫자 비교 연산자를 사용할 수 있습니다. `=`, `>`, `≥`, `<`또는 `≤` (예: `metadata:object_car_count>=10`). 같은 키에 하한과 상한을 추가해 범위를 필터링할 수 있습니다. 전체 쿼리를 RoboQL로 편집하려면 "Raw"를 클릭하고, 돌아가려면 "Filters"를 클릭하세요.

업로드된 동영상은 시맨틱 검색을 위해 자동으로 색인됩니다. 각 동영상의 첫 프레임에서 썸네일을 생성하므로 검색 결과를 한눈에 파악할 수 있습니다.

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

"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) 를 선택한 이미지에 추가
* 선택한 이미지로 새 프로젝트 만들기
* 선택한 이미지를 기존 프로젝트에 추가
* [워크플로 실행](#running-a-workflow) 선택한 이미지에서 백그라운드 일괄 처리 작업으로 실행
* 검색 결과 내보내기/다운로드
* Workspace에서 이미지 삭제

프로젝트를 만들거나 이미지를 추가할 때 선택 항목에 있는 [주석 그룹](https://docs.roboflow.com/datasets/annotate/annotation-groups) 의 주석도 복사할 수 있습니다. 복사본을 편집해도 원본 프로젝트는 변경되지 않습니다.

검색이 활성화된 상태에서 "Select All"을 사용하면 현재 페이지에 표시된 이미지뿐 아니라 Workspace에서 검색 조건과 일치하는 모든 결과에 이러한 작업이 적용됩니다.

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

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

### 워크플로 실행

다음을 실행할 수 있습니다. [워크플로](https://docs.roboflow.com/workflows) 선택한 이미지에 [Batch Processing](https://docs.roboflow.com/deployment/roboflow-cloud/batch-processing) 작업을 실행합니다. 한 번에 대량의 이미지에 모델 출력(예: 분류, 감지, 품질 점수)을 추가할 때 유용합니다.

원하는 이미지를 선택한 다음 작업 표시줄에서 "워크플로 실행"을 클릭합니다. 모달에서 다음을 수행합니다.

* 실행할 워크플로를 선택합니다. 워크플로에는 다음 항목이 정확히 하나 있어야 합니다. `image` 입력.
* 머신 유형을 선택합니다. CPU는 소규모 감지, 분류 및 세그멘테이션 모델에 가장 적합합니다. GPU는 더 빠르며 SAM3, 대규모 VLM, 대형 RF-DETR 또는 YOLO 모델과 같은 일부 모델에 필요합니다. 워크플로에 GPU가 필요한 경우 자동으로 선택됩니다.
* "시작"을 클릭합니다.

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

#### Asset Library에 결과 쓰기

Asset Library에서 워크플로 결과를 검색할 수 있게 하려면, 워크플로가 각 원본 이미지에 속성과 태그를 기록하도록 설정합니다.

1. 워크플로의 Inputs 블록에 `source_id` 입력을 추가합니다. Batch Processing이 이미지마다 하나씩 자동으로 값을 채웁니다.
2. 다음 블록을 추가합니다. [Roboflow Asset Library Attributes](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`).

### HTTP API

코드에서 Asset Library 이미지를 Project에 추가하려면 이미지 또는 동영상 ID나 검색 쿼리를 다음으로 전송합니다. `/:workspace/:project/add-images` 엔드포인트. 요청은 즉시 작업을 반환하며, 추가 작업은 백그라운드에서 실행됩니다. 반환된 `url`을 폴링합니다. 자세한 내용은 [비동기 작업](https://docs.roboflow.com/reference/platform/rest-api/async-tasks)을 참조하세요. 작업이 완료될 때까지 폴링합니다.

{% openapi src="/files/f34ce7c3434dc1b92e365a0bcf9de63f153b7e42" path="/{workspace}/{project}/add-images" method="post" %}
[add-images.yaml](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-8d47867a5529560d8575a102a90720d309806573%2Fadd-images.yaml?alt=media)
{% endopenapi %}
