> 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/roboflow-cloud/cloud-streaming/run-a-workflow.md).

# Workflow を実行する

Cloud Streaming ソース上の Workflow を、バージョンと sink の動作が明確な状態でプレビュー、デプロイ、更新、停止します。

ワークフローを実行 [接続済みのソースで](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/connect-a-source.md) ライブ動画を予測、注釈付き動画、後続アクションに変換します。テスト中のドラフトには時間制限付きのプレビューを、視聴者がいなくても処理を継続する場合はデプロイを選択してください。

最初の実行を一通り行うには、 [クイックスタート](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/quickstart.md) をご利用ください。プレビューとデプロイのどちらも、処理にはクレジットを使用します。

## Webアプリ

### ドラフトをプレビュー

保存済みのワークフローを開き、「Run」をクリックして、接続済みのストリーム、または一時的なウェブカメラ／スマートフォンのセッションを選択します。「Enable Sinks」はデフォルトでオンです。テストで外部システムに書き込みたくない場合は、オフにしてください。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-d4d9281f1fbd8ab679e4a32957c3782414869078%2Fcloud-streaming-shot05-editor-preview.png?alt=media" alt="Workflow editor with a stream preview and JSON output."><figcaption><p>「Run」はエディターでワークフローをテストし、動画と構造化出力を表示します。</p></figcaption></figure>

### 公開済みワークフローをデプロイ

「Deployments」を開き、「Cloud Streaming」を選択してソースを選び、「Run a Workflow」を選択します。または、ワークフローエディターで「Deploy」をクリックし、「Cloud Streaming」を選択します。必須の「Workflow Inputs」に値を入力します。変更した値は処理開始時にそのソース用として保存され、次にそのソースでワークフローを実行するときにも読み込まれます。ワークフローのデフォルト値に戻すには、「Reset to Workflow Default」をクリックします。注釈付き動画を取得するには、「Visual Preview Output」で画像出力を選択します。JSONのみのワークフローは画像出力なしで実行できますが、動画は生成されません。見積もりを確認し、「Start Processing」をクリックします。

処理が30秒間安定して続くと、自動復旧が有効になります。デプロイに「Enable Automatic Recovery」と表示された場合は、クリックしてください。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-a2c37f334171d61022f87f911199aec658af4e62%2Fcloud-streaming-shot05-use-workflow.png?alt=media" alt="Use Workflow dialog with Cloud Streaming selected and available sources."><figcaption><p>Agentでは、「Use」からCloud Streamingのデプロイオプションを開けます。表示価格は参考値です。</p></figcaption></figure>

見積もりは時間あたりの料金であり、合計額ではありません。「Start Processing」は、同じソース上の他のデプロイと並行して実行されます。

### 実行中のプレビューを昇格

実行中のプレビューを選択し、「Deploy Stream」をクリックします。カメラで他のデプロイが実行中の場合は、「Replace」をクリックして停止するか、「Keep All」を選択します。プレビューは再起動せずにデプロイへ移行します。詳しくは、 [昇格](#promotion).

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-a3261a56bb282891bf8d6955842b2a64f934cf55%2Fcloud-streaming-shot06-promote-preview.png?alt=media" alt="Deploy Stream confirmation explaining continued billing and preserved Workflow settings."><figcaption><p>をご覧ください。</p></figcaption></figure>

### 継続処理と料金を確認してから、デプロイを確定してください。表示価格は参考値です。

ワークフローを公開しても、実行中のデプロイには反映されません。公開後、デプロイを再起動するか、停止して新たに実行してください。詳しくは、 [再起動の動作](#restarts) と [再起動の操作](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/manage-and-monitor.md#restart-processing).

### 実行を停止または置き換える

「Stop」をクリックし、確認画面で「Stop processing」をクリックします。プレーヤーを閉じたりページを離れたりしても、デプロイとその料金は停止しません。

## ワークフローのライフサイクル

プレビューでは、視聴しながらドラフトをテストできます。デプロイでは、視聴者がいなくても公開済みワークフローが継続的に実行されます。以下の各操作によって、実行するワークフローのバージョンと、トラッカーやカウンターを引き継ぐかどうかが決まります。

<table data-search="false"><thead><tr><th>操作</th><th>ワークフローのバージョン</th><th>状態とシンク</th></tr></thead><tbody><tr><td>プレビュー</td><td>プレビュー開始時点のドラフト</td><td>独立した短時間の実行です。シンクは「Enable Sinks」の設定に従います（デフォルトでオン）。</td></tr><tr><td>デプロイ</td><td>デプロイ開始時点の公開済みバージョン</td><td>トラッカーとカウンターは初期状態から開始します。公開済みのシンク設定を使用します。</td></tr><tr><td>Deploy Stream（プレビューを昇格）</td><td>実行中のプレビューそのもの</td><td>同じ実行と状態を引き継ぎます。無効化されたシンクは無効のままです。公開も再起動も行われません。</td></tr><tr><td>再起動</td><td>最新の公開済みバージョン</td><td>同じ入力で新たに実行します。トラッカーとカウンターはリセットされます。</td></tr><tr><td>カメラ実行の開始から30秒以内に再起動</td><td>テスト中のバージョン</td><td>新たに実行します。編集内容をテストするには、新しい実行を開始してください。</td></tr><tr><td>より大きなGPUで再試行</td><td>メモリ不足になったバージョン</td><td>より大きなGPUで新たに実行します。トラッカーとカウンターはリセットされます。</td></tr><tr><td>自動復旧</td><td>デプロイのバージョン</td><td>新しい実行です。トラッカーとカウンターはリセットされます。復旧は待機または一時停止できます。</td></tr></tbody></table>

### プレビュー

プレビューでは、ソース上の既存のデプロイと並行して、下書きを公開せずに実行します。最後の視聴者が離れてから2分後（誰も視聴していない場合は10分後）、または1時間後に停止します。Webカメラとスマートフォンのプレビューは、ブラウザーが切断された場合も終了します。

### デプロイ

デプロイでは、開始時に公開されていたバージョンを実行します。その後の編集は再起動後にのみ反映されます。

### 昇格

昇格すると、実行中のプレビューを再起動せずにデプロイへ切り替えられます。実行中のWorkflow、入力、GPU、状態、Sinkの設定はそのまま引き継がれます。下書きは公開されず、無効になっているSinkも再び有効にはなりません。

プレビューを昇格できるのは、次の条件をすべて満たす場合のみです。

* アプリで開始しており、「ソース動画の管理」権限を持っている。
* Webカメラやスマートフォンのセッションではなく、カメラ上で保存済みのWorkflowを実行している。
* 実行中で、停止、再起動、GPU変更のいずれも進行中ではない。

### 再起動

再起動すると、最新の公開済みWorkflowが読み込まれ、同じ入力と設定で新しい実行が開始されます。未公開の下書きを保存しただけでは不十分です。トラッカー、カウンター、クールダウンタイマーなどのメモリ内状態はすべて初期化され、古い実行の停止から新しい実行の開始まで、結果に空白が生じます。その後の自動復旧では、新たに固定されたバージョンが使われます。

次の2つの場合は、古いスナップショットが引き続き使われます。

* カメラ実行の最初の30秒間に再起動した場合は、テスト中のバージョンが維持されます。
* GPUメモリ不足のエラー後に、より大きなGPUで再試行した場合は、エラーが発生したバージョンが維持されます。アプリの実行は自動的に再試行されます。APIジョブには「再試行先」ボタンが表示されます。

### 停止

ジョブの停止、一時セッションの終了、カメラの無効化、ソースの削除は、それぞれ異なる操作です。処理を終了するには、ジョブを停止してください。プレーヤーを閉じる、ページを離れる、視聴者を切断する、カメラのプラグを抜く、またはカメラの配信を停止しても、デプロイやその料金は停止しません。有効なデプロイは、復旧が待機状態となり、動画が戻ると再開します。古いプレビューが自動的にクリーンアップされても、昇格済みのデプロイは停止しません。カメラを削除または取り外しても、そのWorkflowを更新することはできません。

「ストリームをデプロイ」とAgentでは、ほかのデプロイを置き換えるかどうか確認されます。「処理を開始」は常にほかのデプロイと並行して実行されます。

## Roboflow Agent

Agentにソースを選択してWorkflowの下書きをプレビューするよう依頼できます。Agentはライブ結果を確認し、アクティブなデプロイを変更せずに改善を支援できます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-1d699f47676beb99be6882b70d4daba5fe79b593%2Fcloud-streaming-shot06-agent-preview.png?alt=media" alt="Agent stream preview with detected people and Deploy Stream above the composer."><figcaption><p>「ストリームをデプロイ」を選択する前に、プレビューを確認してください。</p></figcaption></figure>

プレビューを実行し続けるには、Agentにデプロイするよう依頼するか、チャットボックスの上にある「ストリームをデプロイ」をクリックしてください。

別のWorkflowを開始するには、カメラにデプロイするよう依頼してください。Agentによる編集をデプロイに反映するには、更新するよう依頼してください。Agentが下書きを公開し、処理を再起動します。

停止を依頼する際は、対象を具体的に指定してください。停止したいデプロイの名前を伝えます。プレビューの切断を依頼しても、デプロイは停止しません。

## HTTP API

次の権限を持つAPIキーでジョブを開始します。 `video-inference-job:create`, `workflow:read`および `model:infer`。読み取りには `video-inference-job:read`が必要です。 [API認証](https://docs.roboflow.com/reference/platform/rest-api/authenticate-with-the-rest-api).

APIには再起動、昇格、価格確認の操作はありません。これらの操作にはWebアプリを使用してください。

### Workflowの入力と出力を確認する

ジョブを開始する前に、保存済みWorkflowで必要なものと返されるものを確認してください。注釈付き動画を取得するには、 `isImage: true` である出力を `imageOutput` として使用します。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-sources/v1/workflow-interface" method="get" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### ジョブを開始する

ジョブごとに新しい `Idempotency-Key` を送信し、同じリクエストの再試行に限って再利用してください。APIプレビューではWorkflowのSinkは無効になりません。APIジョブでは、送信した `processorSize` が使用されます。指定がない場合はSmallが使われます。Workflowに基づいてジョブのサイズを決め、メモリエラー後により大きなGPUへ移行するには、 `autoSize: true` なしで `processorSize`。ジョブでは、別の値を送信しない限り、Webアプリでソースに保存されたワークフローの入力値も使用されます。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-sources/v1/{sourceId}/jobs" method="post" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### ジョブを読み取り、処理を待つ

ジョブを作成しただけでは、まだ処理は始まっていません。ジョブが実行されるか終了するまで読み取り、別のジョブを開始するのではなく、エラーを確認してください。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-jobs/v1" method="get" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-jobs/v1/{jobId}" method="get" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

実行中は、 [動画と結果を消費し、](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/consume-results.md#http-api). `processingPrice` は現在の時間あたりの料金であり、合計費用ではありません。ライブ出力は保存されません。

### 一時プレビューを維持する

ウェブカメラまたはスマートフォンのプレビューは、所有者が更新を停止してから2分後に停止します。30秒ごとに更新してください。動画の再生を続けるには、 [watch](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/consume-results.md#watch-live-output).

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-jobs/v1/{jobId}/hold-preview" method="post" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

### ジョブを停止する

ジョブをキャンセルし、終了するまで読み取ってください。キャンセルしたデプロイメントは復旧できません。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-jobs/v1/{jobId}/cancel" method="post" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

一時的なカメラの場合は、さらに [そのセッションを停止してください](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/connect-a-source.md#stop-a-temporary-session) ワークフローの実行を1回だけ止めるのではなく、配信を終了するときに。
