# Vision Events

## 概要

Vision Events は、Roboflow の datastore で、デプロイした computer vision model からの視覚情報とともに、欠陥の検出や在庫数のカウントなどの重要なイベントを記録できます。これにより、本番環境で vision system が観測するすべての履歴を検索・フィルタリング可能な形で保存できます。

## Vision Event とは？

Vision Event は、model が image を処理したときに作成されるタイムスタンプ付きのレコードです。各 event では、必要に応じて次の情報を記録できます:

* **Images**: 処理された元の images と、それに関連付けられた output images
* **Predictions**: model が返した object detections、classifications、instance segmentations、または keypoints
* **Source metadata**: どの device、stream、または workflow が event を生成したか
* **Custom metadata**: ドメイン向けに定義する key-value pairs（例: `line_number`, `shift`, `part_number`)

プログラムからアクセスするには、次を参照してください。 [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events).

{% embed url="<https://www.youtube.com/watch?v=4HlYG1MacRk>" %}

## 主要な概念

### Use Cases

1つの **Use Case** 共通の目的とカスタム metadata structure を共有する events をまとめます。同じ Use Case の events は通常、同様の metadata fields を送信するため、一貫した方法で filter や query を行えます。

たとえば、「Defect Detection」Use Case には、常に `line_id`, `shift`、および `part_number` が含まれる場合があります。たとえ event が複数の factory や camera location から来ていても同様です。metadata structure が本質的に異なる場合は、別の Use Case を作成してください（例: 「PPE Compliance」では `zone` と `alert_type` を追跡する）。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/roboflow/roboflow-jp/deploy/vision-events.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.