> 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 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** — 추적 `통로`, `선반`, `item_type`
* **Construction Site Safety** — 추적 `구역`, `alert_type`, `contractor`

### Use Case 만들기

#### Agent를 통해

When the [Roboflow Agent](/roboflow/roboflow-ko/agents/roboflow-agent.md) Vision Events로 Workflow를 만들면, 로그를 남기기 전에 Use Case를 확인합니다. 새 Workflow의 경우 기본적으로 새 Use Case를 만들며, 기존 Use Case를 명확히 같은 목적으로 공유하거나 사용자가 이름을 지정한 경우에만 재사용합니다. 또한 Agent에게 새 Use Case를 직접 설정해 달라고 요청하거나, 로깅을 하지 않도록 선택할 수도 있습니다.

#### Dashboard에서

1. 이동하세요 **Vision Events** workspace의 왼쪽 사이드바에서
2. 클릭 **+ Create Use Case**
3. Use Case 이름을 입력하세요

<figure><img src="/files/058ef7e3dc122a0b87868780f2de5e9f8affa59d" alt="" width="375"><figcaption></figcaption></figure>

REST API를 통해서도 Use Cases를 만들 수 있습니다. 다음을 참조하세요: [프로그램 방식으로 Use Cases 관리](#manage-use-cases-programmatically).

### Use Cases 보기

#### Dashboard에서

Vision Events 페이지에는 모든 Use Cases의 표가 표시되며, 다음을 보여줍니다:

* Use Case 이름
* 총 이벤트 수
* 마지막 이벤트 타임스탬프
* 사용 중인 이벤트 유형

#### API를 통해

workspace의 모든 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 관리

Dashboard 외에도 REST API를 통해 Use Cases를 만들고, 이름을 바꾸고, 보관하고, 보관 해제할 수 있습니다. 이러한 엔드포인트에는 다음 권한이 있는 API 키가 필요합니다: `vision-events:manage` scope(제한이 없는 workspace 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 보관

더 이상 필요하지 않을 때 Dashboard에서 Use Cases를 보관할 수 있습니다. 보관된 Use Cases와 해당 이벤트는 계속 접근 가능하지만 기본 보기에서는 숨겨집니다. 다음을 클릭하세요: **보관된 Use Cases 보기** 를 보려면 Use Cases 표의 하단에서\ <br>

<figure><img src="/files/91314253e8b39652a59ffe9f5eef28a83326baa6" alt=""><figcaption></figcaption></figure>

### Custom Metadata Schema

이벤트가 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) 전체 세부 정보는