> 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/deploy/vision-events/use-cases.md).
# 사용 사례
## Use Cases
Use Case는 공통 목적과 사용자 정의 메타데이터 구조를 공유하는 Vision Events를 그룹화합니다. 각 이벤트는 정확히 하나의 Use Case에만 속합니다. 같은 Use Case의 이벤트는 일반적으로 동일한 메타데이터 필드를 공유하므로, 서로 다른 소스 간 데이터를 쉽게 필터링하고 비교할 수 있습니다.
### 하나의 Use Case를 사용할 때와 여러 Use Cases를 사용할 때
**이벤트를 같은 Use Case에 넣기** 서로 다른 위치, 카메라 또는 기기에서 온 것이라도 유사한 사용자 정의 메타데이터 필드를 공유할 때. 예를 들어, "Defect Detection" Use Case는 여러 공장의 이벤트를 받을 수 있지만, 모든 이벤트에는 `line_id`, `shift`그리고 `part_number`.
**별도의 Use Cases 만들기** 메타데이터 구조가 근본적으로 다를 때. 예:
* **Assembly Line QA** — 추적 `line_id`, `shift`, `part_number`
* **Warehouse Inventory** — 추적 `통로`, `선반`, `품목 유형`
* **Construction Site Safety** — 추적 `구역`, `경고 유형`, `도급업체`
### Use Case 만들기
#### Agent를 통해
이 [Roboflow Agent](broken://pages/a49e1c0c68822bd5a89b21f433391322f1b50a29) Vision Events로 Workflow를 만들 때 Use Cases를 자동으로 생성합니다. 설명한 사용 사례에 맞는 기존 Use Case가 있으면 그것을 선택하고, 없으면 새로운 Use Case를 생성합니다. Agent에게 직접 새 Use Case를 설정해 달라고 요청할 수도 있습니다.
#### 대시보드에서
1. 이동하세요 **Vision Events** 워크스페이스의 왼쪽 사이드바에서
2. 클릭 **+ Create Use Case**
3. Use Case 이름을 입력하세요
REST API를 통해서도 Use Cases를 만들 수 있습니다. 자세한 내용은 [프로그램 방식으로 Use Cases 관리하기](#manage-use-cases-programmatically).
### Use Cases 보기
#### 대시보드에서
Vision Events 페이지에는 모든 Use Cases의 표가 표시되며, 다음 항목을 보여줍니다:
* Use Case 이름
* 총 이벤트 수
* 마지막 이벤트 타임스탬프
* 사용 중인 이벤트 유형
#### API를 통해
워크스페이스의 모든 Use Cases를 가져오려면:
```bash
curl -X GET "https://api.roboflow.com/vision-events/use-cases" \
-H "Authorization: Bearer YOUR_API_KEY"
```
다음을 [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events) 에서 전체 응답 형식을 확인하세요.
### 프로그램 방식으로 Use Cases 관리하기
대시보드 외에도 REST API를 통해 Use Cases를 생성, 이름 변경, 보관, 보관 해제할 수 있습니다. 이러한 엔드포인트는 다음 권한이 있는 API 키를 필요로 합니다. `vision-events:manage` 스코프(제한 없는 워크스페이스 API 키는 기본적으로 접근할 수 있음).
**Use Case 만들기**
```bash
curl -X POST "https://api.roboflow.com/vision-events/use-cases" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{ "name": "assembly-line-qa" }'
```
**Use Case 이름 변경**
```bash
curl -X PUT "https://api.roboflow.com/vision-events/use-cases/USE_CASE_ID" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{ "name": "assembly-line-qa-v2" }'
```
**Use Case 보관 또는 보관 해제**
```bash
curl -X POST "https://api.roboflow.com/vision-events/use-cases/USE_CASE_ID/archive" \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X POST "https://api.roboflow.com/vision-events/use-cases/USE_CASE_ID/unarchive" \
-H "Authorization: Bearer YOUR_API_KEY"
```
### Use Case 보관
더 이상 필요하지 않을 때 대시보드에서 Use Cases를 보관할 수 있습니다. 보관된 Use Cases와 해당 이벤트는 계속 접근 가능하지만 기본 보기에서는 숨겨집니다. 아래의 **보관된 use cases 보기** 를 클릭하면 볼 수 있습니다.\
### 사용자 정의 메타데이터 스키마
이벤트가 Use Case로 전송된 후, 시스템은 관찰된 필드와 값 유형을 바탕으로 메타데이터 스키마를 추론합니다. Use Case에 대해 추론된 스키마를 가져와 현재 사용 중인 키와 값 유형을 확인할 수 있습니다:
```bash
curl -X GET "https://api.roboflow.com/vision-events/custom-metadata-schema/assembly-line-qa" \
-H "Authorization: Bearer YOUR_API_KEY"
```
**응답 예:**
```json
{
"useCaseId": "assembly-line-qa",
"fields": {
"line_id": { "types": ["string"] },
"shift": { "types": ["string"] },
"temperature": { "types": ["number"] },
"is_priority": { "types": ["boolean"] }
}
}
```
다음을 [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events) 전체 내용을 확인하세요.
---
# 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/deploy/vision-events/use-cases.md?ask=&goal=
```
`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.