Use Cases

목적별로 Vision Events를 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 — 추적 aisle, shelf, item_type

• Construction Site Safety — 추적 zone, alert_type, contractor

Use Case 만들기

Agent를 통해

해당 Roboflow Agent Vision Events로 Workflow를 빌드할 때 Use Cases를 자동으로 생성합니다. 기존 Use Case가 적합하면 그것을 선택하고, 그렇지 않으면 설명한 사용 사례를 바탕으로 새로 만듭니다. Agent에게 새 Use Case를 직접 설정해 달라고 요청할 수도 있습니다.

대시보드에서

1. 이동하세요 Vision Events workspace의 왼쪽 사이드바에서

2. 클릭하세요 + Create Use Case

3. Use Case 이름을 입력하세요

REST API를 통해서도 Use Cases를 만들 수 있습니다. 자세한 내용은 Use Cases를 프로그래밍 방식으로 관리.

View Use Cases

대시보드에서

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

• Use Case 이름

• 총 이벤트 수

• 마지막 이벤트 타임스탬프

• 사용 중인 이벤트 유형

API를 통해

workspace의 모든 Use Cases를 가져오세요:

curl -X GET "https://api.roboflow.com/vision-events/use-cases" \
  -H "Authorization: Bearer YOUR_API_KEY"

다음을 참조하세요 Vision Events API Reference 전체 응답 형식을 위해.

Use Cases를 프로그래밍 방식으로 관리

대시보드 외에도 REST API를 통해 Use Cases를 만들고, 이름을 바꾸고, 보관하고, 보관 취소할 수 있습니다. 이러한 엔드포인트를 사용하려면 다음 범위가 포함된 API key가 필요합니다: vision-events:manage 범위(제한 없는 workspace API key는 기본적으로 접근 권한이 있습니다).

Use Case 만들기

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 이름 바꾸기

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 보관 또는 보관 취소

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와 해당 이벤트는 계속 접근할 수 있지만, 기본 보기에서는 숨겨집니다. 아래의 View archived use cases 를 Use Cases 표 하단에서 클릭하면 볼 수 있습니다.

사용자 지정 메타데이터 스키마

이벤트가 Use Case로 전송되면 시스템은 관찰된 필드와 값 유형을 기반으로 메타데이터 스키마를 추론합니다. Use Case에 대해 추론된 스키마를 가져와 어떤 키와 값 유형이 사용 중인지 확인할 수 있습니다:

curl -X GET "https://api.roboflow.com/vision-events/custom-metadata-schema/assembly-line-qa" \
  -H "Authorization: Bearer YOUR_API_KEY"

예시 응답:

{
  "useCaseId": "assembly-line-qa",
  "fields": {
    "line_id": { "types": ["string"] },
    "shift": { "types": ["string"] },
    "temperature": { "types": ["number"] },
    "is_priority": { "types": ["boolean"] }
  }
}

다음을 참조하세요 Vision Events API Reference 자세한 내용을 보려면