# Vision Events

## 概要

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

## Vision Event とは何ですか？

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

* **Images**: 処理された元の画像と、それに関連する出力画像
* **Predictions**: model が返した object detections、classifications、instance segmentations、または keypoints
* **Source metadata**: どの device、stream、または workflow が event を生成したか
* **Custom metadata**: あなたのドメイン向けに定義する key-value pair（例: `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** 共通の目的と custom metadata 構造を持つ event をまとめます。同じ Use Case 内の event は通常、同様の metadata フィールドを送信するため、一貫した方法でフィルタやクエリを行えます。

たとえば、「Defect Detection」の Use Case では、常に `line_id`, `shift`、および `part_number` を含めることがあります。たとえ event が複数の工場や camera の場所から来ていたとしても同様です。metadata 構造が本質的に異なる場合は、別々の 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.
