이벤트 전송

배포된 모델에서 Vision Events를 전송하는 세 가지 방법.

이벤트 전송

워크플로 블록, REST API 또는 엣지 디바이스 백업을 사용하여 Vision 이벤트를 보낼 수 있습니다.

• 워크플로 블록 - 워크플로 사용자라면 공식 Roboflow 블록을 사용하는 것이 가장 쉽다고 느낄 것입니다

• REST API - 워크플로 외부에 모델을 배포하려는 사용자는 REST API를 사용할 수 있습니다

• 엣지 디바이스 백업 - Roboflow Edge 디바이스를 배포하는 사용자는 디바이스의 로컬 이벤트 저장소에서 자동 백업을 구성하는 것이 가장 편리할 것입니다

워크플로 블록

대부분의 사용자에게 권장되는 방법입니다. 다음을 추가하세요. 비전 이벤트 블록을 Roboflow Workflow에 추가하면 코드 없이 추론 결과로부터 이벤트를 자동으로 생성할 수 있습니다.

이 Roboflow Agent 이 설정을 대신해 드릴 수 있습니다. Agent에게 모델을 실행하는 워크플로를 만들어 달라고 요청하면, Agent가 자동으로 Vision Events 블록을 추가하고 적절한 유스 케이스.

설정

1

워크플로 편집기 열기

다음으로 이동 워크플로 워크스페이스에서 해당 워크플로를 열고 이벤트를 추가하려는 워크플로를 여세요.

2

비전 이벤트 블록 추가

블록 카탈로그에서 "Vision Event"를 검색한 다음 워크플로에 추가하세요.

3

입력 연결

이미지 입력과 모델 예측 출력을 Vision Event 블록에 연결하세요.

4

유스 케이스 구성

유스 케이스 이름(useCaseId). 상위 블록에서 사용자 지정 메타데이터를 매핑할 수도 있습니다. 유스 케이스를 선택하면 드롭다운 아래의 "Vision Events에서 열기"를 클릭하여 새 탭에서 해당 유스 케이스의 이벤트 페이지로 이동할 수 있습니다.

5

워크플로 배포

워크플로를 배포하거나 업데이트하세요. 워크플로가 실행될 때마다 이벤트가 자동으로 생성됩니다.

워크플로 블록은 이미지 업로드와 이벤트 생성을 한 단계로 처리합니다.

REST API

워크플로를 사용하지 않는 맞춤형 통합이나 파이프라인의 경우, REST API를 통해 이벤트를 직접 보낼 수 있습니다. 전체 요청 및 응답 스키마는 다음을 참조하세요. Vision Events API 참조.

인증

모든 쓰기 엔드포인트에는 다음 범위의 API 키가 필요합니다. visionEvents.write 또는 device.update 스코프입니다. API 키를 Bearer 토큰으로 전달하세요:

Authorization: Bearer YOUR_API_KEY

엔드투엔드 예시: 이미지 업로드 + 이벤트 생성

이벤트를 보내기 전에 유스 케이스를 만들어야 합니다. 를 참조하는 이벤트는 useCaseId 존재하지 않는 경우 거부됩니다.

API를 통해 이벤트를 보낼 때는 먼저 이미지를 업로드한 다음, 업로드된 이미지를 참조하는 이벤트를 생성합니다.

1단계: 이미지 업로드

curl -X POST "https://api.roboflow.com/vision-events/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@inspection_photo.jpg"

응답:

{
  "success": true,
  "sourceId": "abc123def456",
  "url": "https://storage.googleapis.com/your-workspace/abc123def456/original.jpg"
}

2단계: 업로드된 이미지를 참조하여 이벤트 생성

curl -X POST "https://api.roboflow.com/vision-events" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "eventType": "quality_check",
    "useCaseId": "assembly-line-qa",
    "timestamp": "2026-03-30T14:30:00.000Z",
    "deviceId": "factory-cam-01",
    "streamId": "line-3",
    "images": [
      {
        "sourceId": "abc123def456",
        "objectDetections": [
          {
            "class": "defect",
            "x": 320,
            "y": 240,
            "width": 50,
            "height": 40,
            "confidence": 0.95
          }
        ]
      }
    ],
    "eventData": {
      "result": "fail"
    },
    "customMetadata": {
      "line_id": "line-3",
      "shift": "morning",
      "part_number": "PN-4421"
    }
  }'

응답:

{
  "eventId": "evt-789ghi",
  "created": true
}

이벤트 일괄 생성

배치 엔드포인트를 사용하여 한 번의 요청으로 최대 100개의 이벤트를 보낼 수 있습니다:

curl -X POST "https://api.roboflow.com/vision-events/batch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "events": [
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "pass" },
        "customMetadata": { "line_id": "line-1" }
      },
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "fail" },
        "customMetadata": { "line_id": "line-2" }
      }
    ]
  }'

배치 요청당 최대 100개 이벤트.

엣지 디바이스 백업

연결이 간헐적일 수 있는 엔터프라이즈 배포에서는 엣지 디바이스가 이벤트를 로컬에 저장했다가 연결이 복구되면 Roboflow와 동기화합니다.

엣지 디바이스 백업에는 Deployment Manager가 필요합니다. 다음을 참조하세요. Deployment Manager 문서 설정 지침은 여기를 참조하세요.

Vision Events 백업을 활성화하려면:

1. 열기 Deployment Manager 워크스페이스에서

2. 구성할 디바이스를 선택하세요

3. 활성화 Vision Events 백업 디바이스의 Event Store 구성에서

4. 이벤트는 디바이스의 로컬 이벤트 저장소에 기록됩니다

5. 디바이스가 다시 연결되면 이벤트가 Roboflow에 자동으로 동기화됩니다

동기화가 완료되면 이벤트가 Vision Events 대시보드에 표시됩니다.