사용 사례
사용 목적별로 Vision Event를 사용 사례로 그룹화합니다.
정보
사용 사례는 그룹화합니다 비전 이벤트 공통 목적과 사용자 지정 메타데이터 구조를 공유하며, 모든 이벤트는 정확히 하나의 사용 사례에 속합니다. 이렇게 이벤트를 구성하면 동일한 필드를 보고하는 카메라, 장치, 위치 전반에서 데이터를 쉽게 필터링하고 비교할 수 있습니다.
서로 다른 위치, 카메라 또는 장치에서 오더라도 사용자 지정 메타데이터 필드를 공유한다면 이벤트를 같은 사용 사례에 넣으세요. 예를 들어, "Defect Detection" 사용 사례는 여러 공장에서 발생한 이벤트를 받을 수 있으며, 모두 line_id, shift, 그리고 part_number. 메타데이터 구조가 다르면 별도의 사용 사례를 만드세요:
조립 라인 QA:
line_id,shift,part_number창고 재고:
aisle,shelf,item_type건설 현장 안전:
zone,alert_type,contractor
이벤트가 도착하면 Roboflow는 보이는 필드와 값 유형으로부터 사용자 지정 메타데이터 스키마를 추론합니다. 확인하려면 다음을 호출하세요. 사용자 지정 메타데이터 스키마 가져오기.
Roboflow 에이전트 비전 이벤트로 워크플로를 빌드할 때 사용 사례를 생성합니다. 적합한 기존 사용 사례가 있으면 재사용합니다. 설정해 달라고 요청할 수도 있습니다.
사용 사례를 보관 처리하면 기본 보기에서 숨겨집니다. 해당 이벤트는 유지되며, 보관 해제할 수 있습니다. 보관된 사용 사례로 전송된 이벤트도 계속 저장되지만, 각 이벤트는 경고를 반환합니다.
이벤트 값
사용 사례의 가치를 추적하려면 이벤트에 금전적 가치를 부여하세요(예: 포착된 각 결함의 비용). 사용 사례에 기본 값과 통화를 설정하세요. 자체 값을 보내지 않는 새 이벤트에는 기본값이 적용되고, 이미 보낸 이벤트는 값을 유지합니다.
이벤트는 다음 항목에서 자체 값을 보낼 수도 있습니다. valueBaseUnits (참조: 비전 이벤트 생성). 값은 항상 사용 사례 통화로 표시됩니다. 값 합계는 약 5분마다 업데이트됩니다.
웹 앱
워크스페이스의 왼쪽 사이드바에서 "Vision Events"를 열고 "+ Create Use Case"를 클릭하세요.

사용 사례 표에는 각 사용 사례의 이벤트 수, 마지막 이벤트 시간, 이벤트 유형, 누적 가치가 표시됩니다. 사용 사례의 개요에는 "Value Created" 타일에 해당 가치가 표시됩니다.
기본 이벤트 값을 설정하려면 사용 사례의 메뉴를 열고 "Update Settings"를 클릭한 다음 "Default Event Value"와 "Currency"를 입력하세요.
대시보드에서 사용 사례를 보관 처리할 수 있습니다. 표 하단의 "View archived use cases"를 클릭하여 보관된 항목을 확인하세요.

HTTP API
제한 없는 Workspace API 키에는 기본적으로 vision-events:manage 스코프가 있습니다.
사용 사례 생성
워크스페이스에 새 사용 사례를 생성합니다. 사용 사례는 배포 맥락별로 비전 이벤트를 정리하는 데 도움이 됩니다(예: "Manufacturing Line 1", "Warehouse Inventory").
필수 스코프: vision-events:manage
Create a new use case in your workspace. It starts active. Requires the vision-events:manage scope.
Roboflow API key passed as a Bearer token.
A name for the use case. Leading and trailing spaces are trimmed. Must be unique within the workspace.
Value given to new events that don't send valueBaseUnits, in the smallest unit of the currency (ex: cents for USD).
5000Three-letter currency code for event values (ex: USD, EUR, JPY), in any case. Defaults to USD. An unsupported code returns 400.
USDUse case created successfully.
Use this as useCaseId when you create events.
name is missing or too long, a default value field is invalid, or another use case already has this name.
Insufficient permissions for this resource.
POST /vision-events/use-cases HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 31
{
"name": "Manufacturing Line 1"
}{
"id": "a1b3c8e1",
"name": "Manufacturing Line 1"
}참고
새 사용 사례는 기본적으로
활성상태로 생성됩니다.사용 사례를 만든 후에는 해당
id를useCaseId로 비전 이벤트 생성.
사용 사례 업데이트
기존 사용 사례의 이름, 상태 또는 기본 이벤트 값을 업데이트합니다.
필수 스코프: vision-events:manage
Update the name, status, or default event value of an existing use case. A new default applies only to events created afterward. Requires the vision-events:manage scope.
Roboflow API key passed as a Bearer token.
The ID of the use case to update.
Send at least one field.
A new name for the use case. Must be unique within the workspace.
The new status for the use case.
Value given to new events that don't send valueBaseUnits, in the smallest unit of the currency (ex: cents for USD). null removes the default.
5000Three-letter currency code for event values (ex: USD, EUR, JPY), in any case. Send defaultValueBaseUnits too when changing the currency of a use case that has a default value.
USDUse case updated successfully.
The default event value after the update. null when unset.
The currency after the update. USD when unset.
No field was sent, a field is invalid, another use case already has this name, or the currency changed without defaultValueBaseUnits on a use case that has a default value.
Insufficient permissions for this resource.
Use case not found.
PUT /vision-events/use-cases/{useCaseId} HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 31
{
"name": "Manufacturing Line 2"
}{
"id": "a1b3c8e1",
"name": "Manufacturing Line 2",
"defaultValueBaseUnits": 5000,
"defaultValueCurrency": "USD"
}사용 사례 목록
워크스페이스의 사용 사례를 나열합니다. 사용 사례를 생성하고 관리하는 방법은 사용 사례 문서.
필수 스코프: vision-events:read 또는 device:read
List the use cases in your workspace with the given status, whether or not they have events. Requires the vision-events:read or device:read scope.
Roboflow API key passed as a Bearer token.
Filter by use case status. Use inactive to list archived use cases.
activePossible values: List of use cases.
The workspace's retention window in days (14 by default).
Insufficient permissions for this resource.
GET /vision-events/use-cases HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"useCases": [
{
"id": "a1b3c8e1",
"name": "Manufacturing Line 1",
"status": "active",
"workspaceId": "Xk2mP9qLr4TzW8vN1bYc",
"automationsCount": 1,
"defaultValueBaseUnits": 5000,
"defaultValueCurrency": "USD",
"createdAt": "2024-01-10T08:00:00.000Z",
"updatedAt": "2024-01-15T10:30:00.000Z"
},
{
"id": "d4e5f6a7",
"name": "Warehouse Inventory",
"status": "active",
"workspaceId": "Xk2mP9qLr4TzW8vN1bYc",
"automationsCount": 0,
"defaultValueBaseUnits": null,
"defaultValueCurrency": "USD",
"createdAt": "2024-01-12T14:00:00.000Z",
"updatedAt": "2024-01-15T09:00:00.000Z"
}
],
"lookbackDays": 14
}사용 사례 보관 처리
상태를 비활성으로 설정하여 사용 사례를 보관 처리합니다. 보관된 사용 사례는 기본적으로 목록에서 숨겨집니다. 보관된 사용 사례로 전송된 이벤트는 계속 저장되지만 entity_not_found 경고가 표시됩니다.
필수 스코프: vision-events:manage
Archive a use case by setting its status to inactive. Its events are kept. Events sent to it afterward are still stored, but each returns an entity_not_found warning. Archiving an archived use case succeeds. Requires the vision-events:manage scope.
Roboflow API key passed as a Bearer token.
The ID of the use case to archive.
Use case archived successfully.
Insufficient permissions for this resource.
Use case not found.
POST /vision-events/use-cases/{useCaseId}/archive HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"success": true
}참고
보관 처리는 소프트 삭제입니다. 사용 사례와 그 이벤트는 보존되지만 활성 목록에서는 숨겨집니다.
보관된 사용 사례를 보려면 사용 사례 목록 엔드포인트를
status=inactive.를 사용하세요. 보관된 사용 사례는 다음을 사용하여 복원할 수 있습니다. 사용 사례 보관 해제 엔드포인트.
사용 사례 보관 해제
이전에 보관된 사용 사례의 상태를 다시 활성.
필수 스코프: vision-events:manage
Restore a previously archived use case by setting its status back to active. Requires the vision-events:manage scope.
Roboflow API key passed as a Bearer token.
The ID of the use case to unarchive.
Use case unarchived successfully.
Use case is not archived.
Insufficient permissions for this resource.
Use case not found.
POST /vision-events/use-cases/{useCaseId}/unarchive HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"success": true
}참고
상태인 사용 사례만
비활성보관 해제할 수 있습니다.보관 해제되면 사용 사례가 다시 활성 목록에 나타나며, 새 이벤트는 더 이상 경고를 반환하지 않습니다.
Python SDK
각 비전 이벤트는 사용 사례와 연결됩니다. Python SDK는 사용 사례를 생성, 목록 조회, 이름 변경, 보관 처리, 보관 해제하는 메서드를 제공합니다.
사용 사례 목록
상태로 필터링할 수 있습니다:
사용 사례 생성
사용 사례 이름 변경
사용 사례 보관 처리
사용 사례 보관 해제
사용 사례 관리에 대한 자세한 내용은 REST API 참조.
MCP 서버
AI 에이전트를 MCP 서버 에 연결하면 다음 도구로 사용 사례를 관리할 수 있습니다:
vision_events_use_cases_list
워크스페이스의 비전 이벤트 사용 사례를 나열합니다.
vision_events_use_case_create
새 비전 이벤트 사용 사례를 생성합니다.
vision_events_use_case_rename
기존 사용 사례의 이름을 변경합니다.
vision_events_use_case_archive
사용 사례를 보관 처리합니다.
vision_events_use_case_unarchive
이전에 보관된 사용 사례를 복원합니다.
마지막 업데이트
도움이 되었나요?