비전 이벤트

배포된 컴퓨터 비전 모델이 프로덕션에서 무엇을 보는지 기록, 검색 및 분석하세요.

소개

개요

Vision Events는 배포한 컴퓨터 비전 모델의 시각적 정보와 함께 결함 감지나 재고 수량 집계 같은 중요한 이벤트를 캡처할 수 있는 Roboflow 데이터 저장소입니다. 이를 통해 프로덕션에서 비전 시스템이 관찰하는 모든 것의 검색 가능하고 필터링 가능한 기록을 얻을 수 있습니다.

Vision Event란 무엇인가요?

Vision Event는 모델이 이미지를 처리할 때 생성되는 타임스탬프가 포함된 기록입니다. 각 이벤트는 선택적으로 다음을 캡처할 수 있습니다:

이미지: 처리된 원본 이미지와 연결된 출력 이미지
예측: 모델이 반환한 객체 탐지, 분류, 인스턴스 세분화 또는 키포인트
소스 메타데이터: 어떤 디바이스, 스트림 또는 워크플로가 이벤트를 생성했는지
사용자 지정 메타데이터: 도메인에 대해 정의하는 키-값 쌍(예: line_number, shift, part_number)

프로그램 방식의 접근은 다음을 참조하세요 Vision Events API 레퍼런스.

핵심 개념

사용 사례

하나의 사용 사례 는 공통의 목적과 사용자 지정 메타데이터 구조를 공유하는 이벤트를 그룹화합니다. 같은 사용 사례의 이벤트는 일반적으로 유사한 메타데이터 필드를 전송하므로 일관되게 필터링하고 쿼리할 수 있습니다.

예를 들어, "결함 감지" 사용 사례에는 항상 line_id, shift, 그리고 part_number 이벤트가 여러 공장이나 카메라 위치에서 발생하더라도 마찬가지입니다. 메타데이터 구조가 근본적으로 다를 때는 별도의 사용 사례를 만드세요(예: "PPE 준수"는 zone 및 alert_type 를 추적합니다).

이 섹션에서는

이벤트 전송 - Workflow 블록, REST API 또는 엣지 디바이스 백업에서 이벤트를 전송합니다.
이벤트 쿼리 - 대시보드에서 이벤트를 필터링하고, Agent에게 자연어로 묻거나, API를 통해 쿼리합니다.
학습용 이미지 추가 - 캡처된 이벤트 이미지를 프로젝트로 옮겨 모델을 학습시킵니다.
운영자 피드백 - 팀원들이 이벤트를 정답, 오답 또는 판정 불가로 표시할 수 있게 합니다.
요약 보고서 - 사용 사례의 정기 요약을 팀에 이메일로 보냅니다.
이벤트 삭제 - 더 이상 필요 없는 이벤트를 사용 사례에서 제거합니다.

HTTP API

Vision Events API를 사용하면 컴퓨터 비전 배포에서 구조화된 이벤트를 기록한 다음 쿼리하고 분석할 수 있습니다. 이벤트에는 이미지, 탐지 주석, 사용자 지정 메타데이터, 품질 검사, 재고 수량, 안전 경고 등을 위한 유형별 데이터가 포함될 수 있습니다.

Vision Events API를 사용하면 다음을 할 수 있습니다:

인증

모든 Vision Events 엔드포인트는 Roboflow API 키를 사용한 Bearer 토큰 인증을 사용합니다:

Authorization: Bearer YOUR_API_KEY

Vision Events 엔드포인트에는 특정 범위가 지정된 API 키 권한이 필요합니다:

읽기 작업 (쿼리, 목록, 스키마): vision-events:read 또는 device:read
쓰기 작업 (생성, 일괄 처리, 업로드): vision-events:write 또는 device:update

사용 사례

각 vision event는 사용 사례와 연결됩니다. 사용 사례를 만들고 관리하는 방법은 다음을 참조하세요: 사용 사례 문서.

또한 기존 사용 사례를 나열할 수 있습니다 API를 통해 이벤트를 기록한 경우.

이벤트 유형

API는 다섯 가지 이벤트 유형을 지원하며, 각 유형마다 고유한 eventData 스키마가 있습니다:

이벤트 유형

설명

quality_check

QA 및 검사 결과

inventory_count

재고 측정

safety_alert

안전 사고 및 경고

custom

자유 형식 이벤트 데이터

operator_feedback

모델 예측에 대한 사람의 피드백

데이터 보존

이벤트는 구성 가능한 조회 기간 동안 보관됩니다(기본값: 14일). lookbackDays 값은 쿼리 응답에 반환되어 작업공간의 실제 보관 기간을 확인할 수 있습니다.

Python SDK

Roboflow Python SDK는 다음의 vision 이벤트를 다루는 메서드를 제공합니다: 작업공간 객체. 이벤트를 생성하고, 필터와 페이지네이션으로 쿼리하며, 이미지를 업로드하고, 사용 사례를 관리할 수 있습니다.

이벤트 스키마, 필터링 옵션, 응답 형식에 대한 전체 세부 정보는 다음을 참조하세요: Vision Events REST API 문서.

빠른 시작

import roboflow

roboflow.login()

rf = roboflow.Roboflow()
ws = rf.workspace()

# 사용 사례 생성
result = ws.create_vision_event_use_case("manufacturing-qa")
use_case_id = result["id"]

# 이미지 업로드
img = ws.upload_vision_event_image("photo.jpg")

# 업로드한 이미지로 이벤트 생성
ws.write_vision_event({
    "eventId": "c3d4e5f6-a1b2-4c3d-8e5f-6a7b8c9d0e1f",
    "eventType": "quality_check",
    "useCaseId": use_case_id,
    "timestamp": "2024-01-15T10:30:00Z",
    "images": [{"sourceId": img["sourceId"]}],
    "eventData": {"result": "pass"},
})

# 이벤트 쿼리
for page in ws.query_all_vision_events(use_case_id):
    for evt in page:
        print(evt["eventId"], evt["eventType"])