> 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/query-events.md). # イベントを検索 ダッシュボードで Vision Event を検索、フィルタリング、閲覧したり、Agent に自然言語で質問したり、API 経由でクエリしたりできます ## 概要 このページでは、特定の [Visionイベント](/deployment/ja/to/vision-events.md) - デプロイ済みモデルが観測した内容のタイムスタンプ付きレコード - を、Vision Events ダッシュボードでのフィルタリングや検索、または REST API によるプログラム操作で見つける方法を説明します。結果は日付範囲、イベントタイプ、デバイス、ストリーム、ワークフロー、検出クラス、またはフィードバックステータスで絞り込み、運用時の挙動を監査したりレポートを作成したりできます。また、 [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) にイベントについて自然言語で質問することもできます。 ## Web アプリ ### イベントのクエリとフィルタリング Vision Events ダッシュボードのフィルターを使って特定のイベントを見つけるか、REST API でプログラム的にクエリします。 #### ダッシュボードでイベントを閲覧する **ユースケースを選択** Vision Events ページで、ユースケースをクリックするとそのイベントを表示できます。イベントは新しい順に表示されます。
**イベントをフィルタリングする** イベント一覧上部のフィルターコントロールを使って、次の条件で結果を絞り込みます。 * **日付範囲** - 開始および終了のタイムスタンプ * **イベントタイプ** - quality\_check、inventory\_count、safety\_alert、custom、operator\_feedback * **デバイス** - デバイス ID でフィルター * **ストリーム** - ストリームまたはカメラ ID でフィルター * **ワークフロー** - イベントを生成したワークフローでフィルター * **検出** - 検出されたオブジェクトクラスでフィルター。任意で信頼度のしきい値を指定できます * **フィードバックステータス** - correct、incorrect、inconclusive、またはフィードバックなし * **カスタムメタデータ** - 任意のカスタムメタデータのフィールドと値でフィルター * **動画数** - 添付された動画クリップの数でフィルター（例: "Greater Than or Equal" 1 で動画付きイベントを検索） * **警告** - 取り込み警告があったイベントのみを表示 開始日または終了日は「相対的」（例: 7日前）にも「絶対的」（固定の日時）にもできます。相対日付は現在時刻に合わせて変動するため、過去 7 日間への保存済みリンクや共有リンクは常に直近 7 日間を表示します。 フィルターのセットを再利用するには、フィルターバー先頭の「保存済みフィルター」メニューを開き、「現在のフィルターを保存」をクリックします。保存済みフィルターはユースケースに属するため、ワークスペースの全員が開くことができます。相対日付は相対のまま保持されます。保存済みフィルターを共有するには「リンクをコピー」を使用してください。Vision Events を作成できる人なら誰でもフィルターを上書き保存できます。保存した本人、または Vision Events を管理できる人だけが、名前の変更や削除を行えます。 イベント詳細サイドバーの値（デバイス ID、ストリーム、品質チェック結果、カスタムメタデータ値など）をクリックして、それらを素早くフィルターとして追加することもできます。 フィルターチップは編集可能です。アクティブなフィルターチップをクリックすると、削除して再追加しなくても値や演算子を変更できます。 フィルターが適用されると、 **一致したイベントの総数** が結果一覧の上部に表示されます。この件数はイベント一覧とは独立して更新されるため、イベントが読み込み中でも、フィルターに一致するイベント数を確認できます。ユースケースに [イベント値](/deployment/ja/to/vision-events/use-cases.md#event-value)がある場合は、一致したイベントの合計値も表示されます。
**イベント詳細を表示** 一覧の任意のイベントをクリックすると、その完全な詳細を表示できます。 * ソース画像、出力画像、および動画クリップ * すべてのソースメタデータ（デバイス、ストリーム、ワークフロー） * 信頼度スコア付きのオブジェクト検出、分類、セグメンテーション * イベントタイプ固有のデータ（例: 合否結果、アイテム数、アラートの重大度） * カスタムメタデータのキーと値のペア * イベントに値がある場合は、その値（ [イベント値](/deployment/ja/to/vision-events/use-cases.md#event-value)) **検出を描画** イベントに予測データ（オブジェクト検出、インスタンスセグメンテーション、キーポイント）が含まれている場合、画像の上に「検出を描画」チェックボックスが表示されます。これを有効にすると、バウンディングボックス、セグメンテーションポリゴン、信頼度スコア付きラベルをソース画像上に重ねて表示できます。 これは、パイプラインが元の入力画像のみを保存し、別の出力画像を保存せずにモデルが検出した内容を可視化したい場合に便利です。 {% hint style="info" %} 別の出力画像を表示している場合は、その画像にはすでに検出結果が描画されているため、このチェックボックスは非表示になります。 {% endhint %} **動画クリップ** 再生アイコン付きのイベントカードには、1 つ以上の [動画クリップ](/deployment/ja/to/vision-events/upload-a-vision-event-video.md) が添付されています。詳細表示では、クリップは画像の後ろの「メディア」欄に表示され、ラベル名または「Clip 1」「Clip 2」などで示されます。クリップをクリックするとブラウザの動画プレーヤーで再生され、下に再生時間が表示されます。 Roboflow がまだ処理中のクリップには「Still processing. This will play as soon as it is ready.」と表示されます。プレーヤーは数分間再確認し、その後「Still processing.」と「Check Again」ボタンを表示します。アップロードに失敗したクリップには「Video failed to upload」と表示され、読み込めないクリップには「Video unavailable」と表示されます。検出オーバーレイと全画面表示は画像にのみ適用され、クリップは [トレーニング用に追加できません](/deployment/ja/to/vision-events/add-images-for-training.md). **自動最終確定イベント** 自動最終確定とフラグ付けされたイベントは、動画のアップロードが完了する前にエッジデバイス上で自動的に閉じられたため、動画がありません。イベントには結果と静止画は残っています。イベントカードには取り消し線付きの動画アイコン（「Auto-finalized: video missing」）が表示され、詳細表示には最終確定時刻が表示されます。これは、以下を通じて同期されたイベントにのみ適用されます [Edge Device Backup](/deployment/ja/to/vision-events/send-events.md#edge-device-backup). ### Agent に質問する フィルターを手作業で作る代わりに、自然言語でイベントをクエリできます。 [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) 左側のサイドバーで「Agent」をクリックして開き、ユースケースについて質問します（例: 「先週、assembly-line-qa の失敗数はいくつでしたか？」「欠陥率は時間とともにどう変化しましたか？」「ストリームごとの平均アイテム数は？」）。 ユースケース上で「AI で分析」をクリックすることもできます。このボタンは「概要」と「検索」タブに表示され、そのユースケースに関する質問が入力済みの状態で新しいタブで Agent を開きます。「検索」タブでは、質問に適用中のフィルターも含まれるため、Agent はあなたが見ているのと同じイベントを参照します。 Agent はイベントデータをクエリして回答するため、数値はイベントに実際に含まれる内容を反映します。できることは次のとおりです。 * 時間範囲、イベントタイプ、または結果に一致するイベントを数える。 * 時間の経過に伴う合格率と不合格率を追跡し、欠陥率が改善しているか悪化しているかを伝える。 * 数値フィールドの合計、平均、最小値、最大値、またはユニーク値の数を求める。 * イベントフィールドまたはカスタムメタデータごとに合計をグループ化するか、日別または週別にバケット化する。 質問がワークスペースの [保持期間](/deployment/ja/to/vision-events.md#data-retention)を超える場合、Agent はゼロで答える代わりに、クエリ可能な最も古い日付を伝えます。日付境界と時間バケットには UTC が使用されます。 イベントについて質問するには「View Vision Events」 [権限](https://docs.roboflow.com/platform/enterprise-features/role-based-access-control). 単発の回答ではなく定期配信のメールダイジェストについては、 [要約レポート](/deployment/ja/to/vision-events/summary-reports.md). ## HTTP API ### Vision Events をクエリする フィルター、時間範囲、ページネーションを使って vision events をクエリします。このエンドポイントは、イベントタイプ、デバイスコンテキスト、検出クラス、カスタムメタデータ、画像メタデータ、イベント固有のフィールドでのフィルタリングをサポートします。 **必要なスコープ:** `vision-events:read` または `device:read` {% openapi src="/files/934e54fa9aa57656316a422a76238b867f081de5" path="/vision-events/query" method="post" %} [openapi.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-90cd0189aea08d3263ce3e004f4958cc7363d4ed%2Fopenapi.yaml?alt=media) {% endopenapi %} {% hint style="info" %} この `detection` フィルターは以前は `detectionClass`という名前でした。旧名はもう受け付けられません。 {% endhint %} 結果の各動画には、その `sourceId` および `ラベル`のみが表示されます。再生またはダウンロードするには、 [再生用 URL を取得します](/deployment/ja/to/vision-events/upload-a-vision-event-video.md#get-a-playback-url) その `sourceId`. ## Python SDK フィルター、時間範囲、ページネーションを使って vision events をクエリします。 ### 単一ページのクエリ 使用します `query_vision_events()` を使って結果の 1 ページを取得します。 ```python import roboflow roboflow.login() rf = roboflow.Roboflow() ws = rf.workspace() page = ws.query_vision_events( "a1b3c8e1", # ユースケース ID（必須） event_type="quality_check", # 単一のイベントタイプでフィルター start_time="2024-01-14T00:00:00Z", # ISO 8601 開始時刻 end_time="2024-01-15T23:59:59Z", # ISO 8601 終了時刻 limit=50, # 1 ページあたりの最大イベント数 ) for evt in page["events"]: print(evt["eventId"], evt["eventData"]) ``` 追加のフィルターもキーワード引数として渡せます。これらはそのまま API に送られます。 ```python page = ws.query_vision_events( "a1b3c8e1", event_types=["quality_check", "safety_alert"], deviceId={"operator": "eq", "value": "camera-node-5"}, customMetadataFilters=[ {"field": "temperature", "operator": "gt", "value": 70, "type": "number"} ], eventFieldFilters=[ {"column": "result", "operator": "eq", "value": "fail"} ], ) ``` 手動ページネーションには `cursor` パラメータと `nextCursor` の値（前回のレスポンスから取得）を使います。 ```python all_events = [] page = ws.query_vision_events("a1b3c8e1", limit=100) all_events.extend(page.get("events", [])) while page.get("hasMore"): page = ws.query_vision_events("a1b3c8e1", cursor=page["nextCursor"], limit=100) all_events.extend(page.get("events", [])) ``` ### すべての結果をページネーションで取得する 使用します `query_all_vision_events()` を使うと、一致するすべてのイベントを自動的にページネーションできます。イベントは一度に 1 ページずつ返されます。 ```python all_events = [] for page in ws.query_all_vision_events( "a1b3c8e1", event_type="quality_check", start_time="2024-01-14T00:00:00Z", end_time="2024-01-15T23:59:59Z", ): all_events.extend(page) print(f"{len(all_events)} 件のイベントが見つかりました") ``` 利用可能なフィルター、演算子、レスポンス形式の詳細については、 [REST API リファレンス](#http-api). ## MCPサーバー AIエージェントを [MCPサーバー](https://docs.roboflow.com/agents/mcp-server) を参照し、次のツールでイベントについて質問できます。
ツール説明
vision_events_queryフィルターとページネーションを使って本番の vision events をクエリします。
vision_events_use_cases_listワークスペース内の vision event ユースケースを一覧表示します。
vision_events_custom_metadata_schema_getユースケースで検出されたカスタムメタデータスキーマを取得します。