For the complete documentation index, see llms.txt. This page is also available as Markdown.

Vision Events

배포된 컴퓨터 비전 모델이 실제 운영에서 보는 내용을 기록, 검색, 분석합니다.

소개

개요

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

비전 이벤트란?

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

  • 이미지: 처리된 원본 이미지와 관련 출력 이미지

  • 비디오: 이벤트 전후에 발생한 일을 보여주는 최대 4개의 비디오 클립

  • 예측: 모델이 반환한 객체 탐지, 분류, 인스턴스 분할 또는 키포인트

  • 소스 메타데이터: 어떤 기기, 스트림 또는 워크플로가 이벤트를 생성했는지

  • 사용자 정의 메타데이터: 예를 들어 도메인에 대해 정의한 키-값 쌍(예: line_number, shift, part_number)

프로그래밍 방식 액세스를 위해서는 다음을 참조하세요. Vision Events API 레퍼런스.

핵심 개념

사용 사례

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

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

이 섹션에서

  • 이벤트 전송 - 워크플로 블록, REST API 또는 엣지 디바이스 백업에서 이벤트를 전송합니다.

  • 이벤트 조회 - 대시보드에서 이벤트를 필터링하고, 에이전트에 자연어로 질문하거나, API를 통해 쿼리합니다.

  • 학습용 이미지 추가 - 캡처된 이벤트 이미지를 프로젝트로 옮겨 모델을 학습합니다.

  • 자동화 - 수동으로 하지 않고도 일치하는 이벤트의 이미지를 프로젝트로 보내거나 알림 이메일을 보냅니다.

  • 작업자 피드백 - 팀원이 이벤트를 정확함, 부정확함, 또는 판단 불가로 표시할 수 있습니다.

  • 요약 보고서 - 팀에 사용 사례의 정기 요약 메일을 보냅니다.

  • 이벤트 삭제 - 더 이상 필요하지 않은 이벤트를 사용 사례에서 제거합니다.

HTTP API

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

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

인증

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

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

  • 읽기 작업 (query, list, schema): vision-events:read 또는 device:read

  • 쓰기 작업 (create, batch, upload): vision-events:write 또는 device:update

사용 사례

각 비전 이벤트는 사용 사례와 연결됩니다. 사용 사례를 생성하고 관리하는 방법은 다음을 참조하세요. Use Cases 문서.

또한 기존 사용 사례를 나열할 수 있으며 API를 통해 이벤트가 기록된 사례들을 볼 수 있습니다.

이벤트 유형

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

이벤트 유형
설명

quality_check

QA 및 검사 결과

inventory_count

재고 측정값

safety_alert

안전 사고 및 경고

custom

자유 형식 이벤트 데이터

operator_feedback

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

데이터 보존

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

Python SDK

Roboflow Python SDK는 다음의 작업공간에서 비전 이벤트를 다룰 수 있는 메서드를 제공합니다. Workspace 객체를 통해 이벤트를 생성하고, 필터와 페이지네이션으로 조회하고, 이미지를 업로드하고, 사용 사례를 관리할 수 있습니다.

이벤트 스키마, 필터링 옵션, 응답 형식에 대한 자세한 내용은 다음을 참조하세요. Vision Events REST API 문서.

빠른 시작

사용 가능한 메서드

메서드
설명

이벤트에 사용할 이미지를 업로드합니다

단일 비전 이벤트 생성

한 요청으로 최대 100개의 이벤트 생성

필터와 페이지네이션으로 이벤트 조회

일치하는 모든 이벤트에 대해 자동 페이지네이션 쿼리

작업공간의 사용 사례 나열

새 사용 사례 생성

사용 사례 이름 변경

사용 사례 보관 해제

검색된 사용자 정의 메타데이터 필드 유형 가져오기

MCP 서버

AI 에이전트를 다음에 연결하면 MCP 서버 다음 도구로 운영 이벤트를 살펴볼 수 있습니다:

도구
설명

vision_events_query

특정 사용 사례의 운영 비전 이벤트를 조회합니다.

vision_events_use_cases_list

작업공간의 비전 이벤트 사용 사례를 나열합니다.

vision_events_use_case_create

새 비전 이벤트 사용 사례를 만듭니다.

vision_events_custom_metadata_schema_get

특정 사용 사례에서 검색된 사용자 정의 메타데이터 스키마를 가져옵니다.

마지막 업데이트

도움이 되었나요?