> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ja/to/vision-events.md). # Vision Events 本番環境で、デプロイしたコンピュータビジョンモデルが何を見たかを記録、検索、分析します。 ## 概要 ### オーバービュー Vision Events は、デプロイ済みのコンピュータビジョンモデルからの視覚情報とともに、欠陥の検出や在庫数のカウントなどの重要なイベントを記録できる Roboflow のデータストアです。これにより、本番環境でビジョンシステムが観測したすべての履歴を検索・フィルタリング可能な形で保存できます。 ### Vision Event とは何ですか？ Vision Event は、モデルが画像を処理したときに作成されるタイムスタンプ付きの記録です。各イベントでは、必要に応じて次の情報を取得できます: * **画像**: 処理された元の画像と、それに関連付けられた出力画像 * **動画**: イベントの前後で何が起きたかを示す最大 4 本の動画クリップ * **予測**: モデルが返したオブジェクト検出、分類、インスタンスセグメンテーション、またはキーポイント * **ソースメタデータ**: どのデバイス、ストリーム、またはワークフローがイベントを生成したか * **カスタムメタデータ**: あなたのドメイン向けに定義するキーと値のペア（例: `line_number`, `shift`, `part_number`) プログラムからのアクセスについては、次を参照してください。 [Vision Events API リファレンス](#http-api). {% embed url="" %} ### 主要な概念 #### ユースケース 1 つの **ユースケース** 共通の目的とカスタムメタデータ構造を共有するイベントをグループ化します。同じユースケース内のイベントは通常、同様のメタデータフィールドを送信するため、一貫した方法でフィルタリングとクエリを行えます。 たとえば、「Defect Detection」ユースケースには常に `line_id`, `shift`、および `part_number` イベントが複数の工場やカメラ設置場所から来る場合でも。メタデータ構造が根本的に異なる場合は、別々のユースケースを作成してください（例: 「PPE Compliance」では `zone` および `alert_type` を追跡します）。 ### このセクションでは * [イベントを送信](/deployment/ja/to/vision-events/send-events.md) - ワークフローブロック、REST API、またはエッジデバイスのバックアップからイベントを送信します。 * [イベントをクエリ](/deployment/ja/to/vision-events/query-events.md) - ダッシュボードでイベントをフィルタリングする、Agent に自然言語で質問する、または API 経由でクエリします。 * [トレーニング用に画像を追加](/deployment/ja/to/vision-events/add-images-for-training.md) - キャプチャしたイベント画像をプロジェクトに移してモデルを学習します。 * [オペレーターフィードバック](/deployment/ja/to/vision-events/operator-feedback.md) - チームメンバーがイベントを正しい、誤り、または判断不能としてマークできるようにします。 * [要約レポート](/deployment/ja/to/vision-events/summary-reports.md) - ユースケースの定期ダイジェストをチームにメール送信します。 * [イベントを削除](/deployment/ja/to/vision-events/delete-events.md) - 不要になったイベントをユースケースから削除します。 ## HTTP API Vision Events API を使用すると、コンピュータビジョンのデプロイから構造化イベントを記録し、それらをクエリして分析できます。イベントには、画像、動画クリップ、検出アノテーション、カスタムメタデータ、品質チェック、在庫数、安全アラートなどのタイプ別データを含めることができます。 Vision Events API でできること: * [Vision Event 画像をアップロード](/deployment/ja/to/vision-events/upload-a-vision-event-image.md#http-api) * [Vision Event 動画をアップロード](/deployment/ja/to/vision-events/upload-a-vision-event-video.md#http-api) * [Vision Event を作成](/deployment/ja/to/vision-events/create-a-vision-event.md#http-api) * [Vision Event を一括作成](/deployment/ja/to/vision-events/batch-create-vision-events.md#http-api) * [Vision Event バンドルをアップロード](/deployment/ja/to/vision-events/upload-a-vision-event-bundle.md#http-api) * [Vision Event をクエリ](/deployment/ja/to/vision-events/query-events.md#http-api) * [ユースケースを一覧表示](/deployment/ja/to/vision-events/use-cases.md#http-api) * [カスタムメタデータスキーマを取得](/deployment/ja/to/vision-events/get-custom-metadata-schema.md#http-api) ### 認証 すべての Vision Events エンドポイントでは、Roboflow API キーによる Bearer トークン認証を使用します: ``` Authorization: Bearer YOUR_API_KEY ``` Vision Events エンドポイントには、特定の [スコープ付き API キー](https://docs.roboflow.com/reference/authentication/authentication/scoped-api-keys) 権限が必要です: * **読み取り操作** （クエリ、一覧表示、スキーマ）: `vision-events:read` または `device:read` * **書き込み操作** （作成、一括処理、アップロード）: `vision-events:write` または `device:update` ### ユースケース 各 vision event はユースケースに関連付けられます。ユースケースの作成と管理方法については、次を参照してください。 [Use Cases ドキュメント](/deployment/ja/to/vision-events/use-cases.md). また、 [既存のユースケースを一覧表示](/deployment/ja/to/vision-events/use-cases.md#http-api) することもできます。API 経由でイベントを記録しているものです。 ### イベントタイプ API は 5 種類のイベントタイプをサポートしており、それぞれ独自の `eventData` スキーマを持ちます: | イベントタイプ | 説明 | | ------------------- | ------------------ | | `quality_check` | QA と検査結果 | | `inventory_count` | 在庫の計測 | | `safety_alert` | 安全インシデントとアラート | | `custom` | 自由形式のイベントデータ | | `operator_feedback` | モデル予測に対する人手フィードバック | ### データ保持 イベントは設定可能なルックバック期間（デフォルト: 14 日）保持されます。 `lookbackDays` の値はクエリ応答で返されるため、ワークスペースの実効保持期間を把握できます。 ## Python SDK Roboflow Python SDK には、 `Workspace` オブジェクト上で vision event を扱うためのメソッドがあります。イベントの作成、フィルタとページネーションを用いたクエリ、画像のアップロード、ユースケースの管理が可能です。 イベントスキーマ、フィルタリングオプション、レスポンス形式の詳細については、次を参照してください。 [Vision Events REST API ドキュメント](#http-api). ### クイックスタート ```python 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"]) ``` ### 利用可能なメソッド | メソッド | 説明 | | ---------------------------------------------------------------------------------------------------------------- | ---------------------------- | | [`upload_vision_event_image()`](/deployment/ja/to/vision-events/upload-a-vision-event-image.md#python-sdk) | イベントで使用する画像をアップロード | | [`write_vision_event()`](/deployment/ja/to/vision-events/create-a-vision-event.md#python-sdk) | 単一の vision event を作成 | | [`write_vision_events_batch()`](/deployment/ja/to/vision-events/batch-create-vision-events.md#python-sdk) | 1 回のリクエストで最大 100 件のイベントを作成 | | [`query_vision_events()`](/deployment/ja/to/vision-events/query-events.md#python-sdk) | フィルタとページネーションでイベントをクエリ | | [`query_all_vision_events()`](/deployment/ja/to/vision-events/query-events.md#paginate-through-all-results) | 一致するすべてのイベントを対象に自動ページングするクエリ | | [`list_vision_event_use_cases()`](/deployment/ja/to/vision-events/use-cases.md#python-sdk) | ワークスペース内のユースケースを一覧表示 | | [`create_vision_event_use_case()`](/deployment/ja/to/vision-events/use-cases.md#create-a-use-case) | 新しいユースケースを作成 | | [`rename_vision_event_use_case()`](/deployment/ja/to/vision-events/use-cases.md#rename-a-use-case) | ユースケースの名前を変更 | | [`archive_vision_event_use_case()`](/deployment/ja/to/vision-events/use-cases.md#archive-a-use-case) | ユースケースをアーカイブ | | [`unarchive_vision_event_use_case()`](/deployment/ja/to/vision-events/use-cases.md#unarchive-a-use-case) | ユースケースのアーカイブを解除 | | [`get_vision_event_metadata_schema()`](/deployment/ja/to/vision-events/get-custom-metadata-schema.md#python-sdk) | 検出されたカスタムメタデータフィールドタイプを取得 | ## MCP サーバー AI エージェントを次に接続すると [MCP サーバー](https://docs.roboflow.com/agents/mcp-server) 、以下のツールで本番イベントを確認できます:
ツール説明
vision_events_queryユースケースの本番 vision events をクエリします。
vision_events_use_cases_listワークスペース内の vision event ユースケースを一覧表示します。
vision_events_use_case_create新しい vision event ユースケースを作成します。
vision_events_custom_metadata_schema_getユースケースに対して検出されたカスタムメタデータスキーマを取得します。