> 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/summary-reports.md).

# サマリーレポート

Vision Eventsのユースケースについて、主要な数値と完全版レポートへのリンクを含む定期サマリーをチームにメールで送信します。

サマリーレポートを使うと、チームに定期的な [ユースケース](https://docs.roboflow.com/deployment/ja/to/vision-events/use-cases.md)の概要をメールで送信できます。メールには主要な数値が表示され、Roboflowでグラフや表を含む完全なレポートを開くリンクも記載されます。レポートの内容を平易な言葉で説明すると、 [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) が、イベントからすでに送信されているデータを使ってレポートを作成します。スケジュール（日次、週次、隔週、月次）と、レポートを受け取るワークスペースメンバーを選択できます。

ユースケースのダッシュボードには、カメラが記録したすべての内容が表示されますが、閲覧できるのはダッシュボードを開いた人だけです。レポートを使えば、数値に基づいて行動する人に情報を届けられます（例：工場長が毎週月曜の朝に、先週のライン別合格数と不合格数を確認する）。レポートは送信時の状態で保存されるため、任意の期間を振り返り、チームが実際に見た内容を正確に確認できます。

定期レポートではなく一度だけ回答が必要な場合は、 [Agentにイベントについて質問してください](https://docs.roboflow.com/deployment/ja/to/vision-events/query-events.md#ask-the-agent).

## レポートメール

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-46751d3dae5b1ffc7b222fbb0bf766abaa2b9dd0%2Fsummary-report-email.png?alt=media" alt="A Summary Report email with Pass, Fail, and Avg people in zone headline numbers and a View Full Report button" width="375"><figcaption><p>メールには主要な数値が表示され、完全なレポートへのリンクが記載されます。</p></figcaption></figure>

レポートが実行されるたびに、各受信者に次の内容を含むメールが届きます。

* 件名には、レポート名と対象期間が記載されます。
* 主要な数値は最大4つです。「イベント総数」、「価値創出」（ユースケースに [イベント価値](https://docs.roboflow.com/deployment/ja/to/vision-events/use-cases.md#event-value)がある場合）、およびレポート内の単一数値セクション（例：「合格」と「不合格」）が表示されます。
* 「完全なレポートを表示」ボタン。

メールにグラフは含まれません。「完全なレポートを表示」をクリックすると、Roboflowでレポート全体が開きます。受信者はサインインすると、すべてのセクションを確認できます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2f2637c1c6fa69f3c424d10f9c211da58f997036%2Fsummary-report-viewer.png?alt=media" alt="A full Summary Report in Roboflow with Pass, Fail, and Avg people in zone numbers and a daily events chart"><figcaption><p>完全なレポートはRoboflowで開きます。</p></figcaption></figure>

## レポートを作成する

レポートを作成するには、Manage Vision Events Reports [権限](#permissions) が必要です。ユースケースでは、レポート対象にしたいフィールドを含むイベントをすでに受信している必要があります。イベントの送信を開始する方法については、 [イベントを送信する](https://docs.roboflow.com/deployment/ja/to/vision-events/send-events.md).

1. 左側のサイドバーで「Vision Events」をクリックし、ユースケースを開きます。
2. 「Reports」タブを開きます。
3. 「Create Report」をクリックします（ユースケースにすでにレポートがある場合は「Create With AI」）。アイデアをもとに作成するには、「Weekly Volume & Trend」、「Top Categories」、「By Device or Location」のいずれかの候補をクリックします。
4. 「What should the report cover?」で、対象者や送信頻度も含めてレポートの内容を説明します。空欄のままにして、チャットで説明することもできます。
5. 「Create Report」をクリックします。Agentが新しいブラウザータブで開き、レポートの下書きを作成します。
6. 「Preview」をクリックして、実際のイベントデータから作成されたレポートを確認します。希望どおりになるまで、チャットで変更を依頼してください。
7. 「Save & Schedule」をクリックします。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-dcc3bae7807f1b205cfc2b0b263065bd6f1b524b%2Fsummary-report-empty.png?alt=media" alt="The Reports tab of a Use Case with no reports, showing the Create Report button and three suggestions"><figcaption><p>レポートがないユースケースには、「Create Report」と3つの候補が表示されます。</p></figcaption></figure>

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-7227c1b1633583efa35d1a61b78e7bc6bdef0e71%2Fsummary-report-create.png?alt=media" alt="The Create a Summary Report dialog with a description of a weekly summary for a site manager" width="375"><figcaption><p>レポートの内容を説明します。</p></figcaption></figure>

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-92b5e83e7b32107423081a6644fea39062cabe41%2Fsummary-report-agent.png?alt=media" alt="The Roboflow Agent with the chat on the left and the report on the right, with Preview, Email Now, and Scheduled buttons"><figcaption><p>チャットでレポートを調整し、保存します。</p></figcaption></figure>

レポートはユースケースの「Reports」タブに表示されます。スケジュールを指定しない場合、Agentは毎週月曜日の9:00を提案します。

依頼できる内容の例：

* 「工場長向けに、毎週月曜の午前8時に送るサマリーを作成してください。検査したボトルの総数、合格数と不合格数、ライン別の不合格数を含めてください。」
* 「日ごとの不合格数を示す折れ線グラフを追加してください。」
* 「直近の不合格イベントを10件表示し、ラインと不良タイプも含めてください。」
* 「デバイス別にグループ化し、列名を「device\_id」ではなく「Line」にしてください。」
* 「隔週にしてください。」

Agentは、イベントに実際に含まれるフィールドのみを使用します。レポートに必要なフィールドがない場合、推測せずにその旨を伝えます。Agentが作成するのはレポートの定義であり、クエリではありません。スケジュールされた実行のたびに、AIを使わずにイベントから数値を算出します。

## レポートの内容

レポートには1～8個のセクションがあり、各セクションは次のいずれかです。

* 指標。統計値（単一の数値）、棒グラフ、折れ線グラフ、面グラフ、円グラフ、ドーナツグラフ、または表として表示されます。指標では、イベント数、条件に一致するイベント数、合計、平均、最小値、最大値、または一意の値の数を集計できます。また、 [オペレーターのフィードバック](https://docs.roboflow.com/deployment/ja/to/vision-events/operator-feedback.md) 判定（例：不正解とされた割合）を示すこともできます。イベントフィールド、カスタムメタデータ、画像メタデータ、または日・週ごとにグループ化できます。
* 最近のイベントの一覧。最大25行、12列です。列には、組み込みのイベントフィールドや、イベントで送信される任意のカスタムメタデータを表示できます。
* の概要 [オペレーターのフィードバック](https://docs.roboflow.com/deployment/ja/to/vision-events/operator-feedback.md).

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-4cfa717440581e2503d419edd24cd0b3199ea34d%2Fsummary-report-viewer-tables.png?alt=media" alt="A report section with events grouped by site and a list of the 10 most recent quality check events"><figcaption><p>サイト別にグループ化した表と、最近のイベントの一覧。</p></figcaption></figure>

Agent に列名の変更や、生の値の代わりにわかりやすい名前を表示するよう依頼できます（例：ストリーム ID「lane-1」を「Lane 1」として表示）。デバイス別にグループ化した指標や列には、デバイス一覧に登録されているデバイス名が表示されます。登録名がない場合は、生のデバイス ID が表示されます。デバイス名はレポートの実行時に読み込まれるため、その後にデバイス名を変更しても、すでに送信されたレポートには反映されません。

## スケジュールと宛先

レポートの実行時刻や送信先を変更するには、「レポート」タブを開き、レポートカードのスケジュール（例：「毎週月曜日 09:00（America/New\_York）」）をクリックします。設定を変更してから、「変更を適用」をクリックします。Agent に依頼することもできます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-e86feca9b28b65cc8edbf78f39dae51186eff687%2Fsummary-report-schedule.png?alt=media" alt="The Schedule and Recipients dialog set to Weekly, Monday, 09:00, America/New_York, a 7 day lookback, and one recipient" width="375"><figcaption><p>レポートの内容を変えずに、スケジュールと送信先を変更します。</p></figcaption></figure>

<table data-search="false"><thead><tr><th width="200">設定</th><th>選択肢</th></tr></thead><tbody><tr><td>頻度</td><td>毎日、毎週、隔週、または毎月</td></tr><tr><td>曜日</td><td>毎週および隔週のレポートの場合</td></tr><tr><td>日付</td><td>毎月のレポートの場合。日数の少ない月は、月末に送信されます</td></tr><tr><td>送信時刻</td><td>レポートの送信時刻</td></tr><tr><td>タイムゾーン</td><td>送信時刻、各レポートの対象期間、グラフの日別・週別の区分に使用されます</td></tr><tr><td>遡る日数</td><td>各実行で対象とする日数（1～90日）。ワークスペースの <a href="https://docs.roboflow.com/deployment/ja/to/vision-events.md#data-retention">データ保持期間</a> （デフォルトでは14日）を超えることはできません</td></tr><tr><td>送信先</td><td>ワークスペースメンバーを最大25人まで指定できます。名前またはメールアドレスで検索できます</td></tr></tbody></table>

### 各レポートの対象範囲

各レポートの対象期間は、レポートのタイムゾーンで午前0時から翌日の午前0時までの丸一日です。送信日の前から遡る日数は「遡る日数」の設定に従います。イベントは、それぞれのタイムスタンプに基づいて集計されます。

* 火曜日の9:00に送信される日次レポートは、月曜日の全期間を対象とします。火曜日の午前中のイベントは、水曜日のレポートに含まれます。
* 遡る日数を7日に設定した週次レポートを月曜日に送信する場合、前週の月曜日から日曜日までが対象です。

対象日が漏れないよう、「遡る日数」をレポートの頻度に合わせて設定してください（日次は1日、週次は7日、隔週は14日）。遡る日数がレポート間の期間より短い場合、Agent が警告します。月次レポートで遡れるのはデータ保持期間までです。そのため、デフォルトの14日では月末の直近14日間が対象になります。

### レポートの到着時刻

レポートは、設定した時刻の数分後に送信されます。スケジュールされた日の当日、送信時刻を過ぎてからレポートを保存した場合は、1時間以内に初回のレポートが送信されます。それ以外の場合は、次の予定日に送信されます。インドなど、時差が30分または45分のタイムゾーンでは、時刻から最大45分後にレポートが届きます。

### 送信先

送信先に指定できるのは、ワークスペースのメンバーです。Roboflow は送信のたびにメンバーかどうかを再確認し、ワークスペースを退出した人への送信をスキップします。保存済みの送信先がメンバーでなくなった場合、ダイアログに警告が表示されます。

どのメンバーもメールを受信できますが、完全なレポートを開くには、「Vision Events レポートの表示」権限が必要です。各送信先のロールにこの権限があることを確認してください。

メールは、ワークスペースの次のアドレスから送信されます： `roboflow.email` （例： `acme-foods@roboflow.email`）。すべての送信先が同じメールに記載されます。メールが迷惑メールフォルダに振り分けられる場合は、IT チームにこのアドレスを許可するよう依頼してください。

## レポートの管理

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-acb9d5832dbf192f4b09ce85608887f0a7642534%2Fsummary-report-card.png?alt=media" alt="A report card in the Reports tab showing its schedule, recipient count, lookback, and last send, with See More, Pin, Open With AI, and Delete buttons"><figcaption><p>各カードには、レポートの最終送信日時と送信先の人数が表示されます。</p></figcaption></figure>

「レポート」タブでは、次の操作ができます：

* タイトルをクリックして、レポート名を変更します。
* カードのスイッチでレポートを一時停止します。「一時停止中」チップが表示され、再開するまでメールは送信されません。一時停止中にスキップされた実行分が、後から送信されることはありません。
* ユースケースごとに最大5件のレポートをピン留めできます。ピン留めしたレポートはユースケースに専用タブとして表示され、ワークスペースの全員が最新の結果を確認できます。
* 「AI で開く」をクリックすると、Agent でレポートを開き直し、チャットで変更できます。完了したら「変更を保存」をクリックしてください。それまでは、保存済みのバージョンが引き続き実行されます。
* レポートを削除します。

{% hint style="warning" %}
レポートを削除すると、そのレポートから生成された過去のレポートもすべて削除されます。メールを停止して履歴を残すには、レポートを削除せず、一時停止してください。
{% endhint %}

カードには、直近の実行結果が表示されます。送信された場合は「送信済み」と時刻および送信先の人数が表示されます。生成に失敗した場合は「前回のレポートの生成に失敗しました」、メールの送信に失敗した場合は「生成済み」とその理由が表示されます。

Vision Events ページのユースケース表には「レポート」列があり、各ユースケースのレポート数が表示されます。クリックすると「レポート」タブが開きます。レポートがないユースケースには「追加」と表示されます。

## 過去のレポート

実行のたびに、送信時の状態でレポートが保存されます。保存済みのレポートは、対象イベントがデータ保持期間を過ぎた後も変更されません。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-6017d862c87f88995686b173455d42c95d455e52%2Fsummary-report-history.png?alt=media" alt="Report history with a Nov 2 to Nov 9 run marked Notified, its headline numbers, and View report and Re-notify buttons"><figcaption><p>各実行のレポートは、主要な数値とともに保存されます。</p></figcaption></figure>

レポートカードの「さらに表示」をクリックすると、履歴を確認できます。過去のレポートごとに、次の操作ができます。

* 「レポートを表示」をクリックして開きます。
* 「再通知」をクリックすると、現在のレポートの宛先にリンクをメールで再送信できます。

過去のレポートを表示しているときに「最新データで更新」をクリックすると、最新データを使って同じレポートを実行できます。更新した表示は保存もメール送信もされません。

スケジュールを待たずに今すぐレポートを送信するには、「AIで開く」をクリックし、次に「今すぐメール送信」をクリックします。対象期間は「ルックバック日数」から現在までです。履歴には「オンデマンド」として保存され、次回のスケジュール送信には影響しません。

## 上限とコスト

* セクション：レポートごとに1～8件。イベントリストには最大25行が表示されます。
* 宛先：Workspaceメンバー最大25人。
* ルックバック期間：1～90日。Workspaceのデータ保持期間を超えることはできません。後から保持期間が短縮された場合、レポートの対象期間も短くなり、その旨が表示されます。
* ピン留め：ユースケースごとに最大5件。
* 再試行：レポートの生成またはメール送信に失敗すると、Roboflowは当日中、1時間ごとに再試行します。1つのセクションで失敗してもレポートは送信され、欠落したセクションが記載されます。
* アーカイブ済みのユースケース：ユースケースがアーカイブされている間はレポートが停止し、アーカイブ解除後に再開します。
* Workspaceのメール送信上限：各Workspaceは1分あたり10通、1日あたり1,000通を送信できます。この上限は、 [イベントなしアラート](https://docs.roboflow.com/deployment/ja/to/vision-events/no-events-alerts.md), [自動化](https://docs.roboflow.com/deployment/ja/to/vision-events/automations.md) のメールや、ワークフローのメールブロックと共有されます。上限に達したレポートは、次の1時間に再試行されます。同じWorkspace内で多数のレポートの送信時刻が重なる場合は、異なる時間帯に分散させてください。
* クレジット：Agentでのレポートの作成と編集には、他のAgentでの会話と同様にAgentクレジットを使用します。スケジュール実行ではAIを使用しません。レポートメール1通につき、宛先の人数にかかわらず0.01クレジットを使用します。Workspaceの使用が一時停止中、またはクレジットが不足している場合、メールは送信されません。
* レポートはRoboflowのウェブアプリまたはAgentから設定します。API経由では作成できません。

## 権限

2つの [権限が](https://docs.roboflow.com/platform/enterprise-features/role-based-access-control) レポートを制御します。

* Vision Eventsレポートの表示： 「レポート」タブ、レポートとその履歴、およびメール内のリンクから開くレポート全体を確認できます。
* Vision Eventsレポートの管理：作成、編集、名前変更、ピン留め、一時停止、削除、再通知、今すぐメール送信ができます。

Workspaceのオーナーには、デフォルトで両方の権限があります。Agentはユーザーの権限で動作するため、ユーザーに権限がある場合にのみレポートを保存または送信できます。レポートの作成、変更、削除、再送信、オンデマンド送信はWorkspaceの [監査ログ](https://docs.roboflow.com/platform/enterprise-features/audit-logs-and-siem-export).

## よくある質問

### Workspace外の人にレポートを送信できますか？

直接は送信できません。宛先になれるのはWorkspaceメンバーのみです。「Vision Eventsレポートの表示」権限を持つロールで招待するか、メールを転送してください。概要の数値はメール本文に記載されます。リンクを開くにはRoboflowへのサインインが必要です。

### 毎日のレポートに今朝のイベントが含まれていないのはなぜですか？

レポートの対象となるのは、すでに終了した日の全体です。9:00に送信される日次レポートには昨日のイベントが含まれるため、今朝のイベントは明日のレポートに表示されます。詳しくは、 [各レポートの対象範囲](#what-each-report-covers).

### レポート送信後にイベントが届きました。レポートは更新されますか？

いいえ。送信済みレポートは固定されたスナップショットです。レポートを開いて「最新データで更新」をクリックすると、その後に受信したすべてのイベントを含めることができます。イベントはそれぞれのタイムスタンプに基づいて分類されるため、オフラインだったエッジデバイスから届いたイベントなど、遅れて届いたイベントも、発生した日の分としてカウントされます。

### レポートが届かないようにするにはどうすればよいですか？

「Vision Eventsレポートの管理」権限を持つ人に、宛先から自分を削除してもらってください。宛先のユーザー自身がメールから配信停止することはできません。

### レポートに合格率や不合格率をパーセンテージで表示できますか？

レポートには合格数と不合格数を並べて表示できます。パーセンテージで表示されるのは、オペレーターのフィードバック判定（例：誤りとしてマークされたもの）があるイベントの割合のみです。

### 複数のユースケースを対象としたレポートを作成できますか？

いいえ。各レポートが対象とするユースケースは1つです。それぞれのユースケースでレポートを作成するか、 [Agentに依頼して](https://docs.roboflow.com/deployment/ja/to/vision-events/query-events.md#ask-the-agent) 複数のユースケースを対象とする単発の質問をしてください。
