> 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/workflows/ja/guan-li/manage-workflows.md).

# Workflowの管理

フォルダでワークフローを整理し、ウェブアプリ、REST API、Python SDK、CLI から管理できます。

## 概要

[Roboflow Workflows](https://docs.roboflow.com/workflows/ja/gou-zhu/create-a-workflow.md) は、Webアプリで構築し、ホスト型エンドポイントとしてデプロイするビジュアルなコンピュータービジョンパイプラインです。このページでは、Webアプリ、HTTP API、Python SDK、CLIを使って、Workspace内のWorkflowsを整理、一覧表示、取得、作成、更新、フォークする方法を説明します。画像または動画ストリームでWorkflowを実行する方法については、 [Workflowをデプロイする](https://docs.roboflow.com/workflows/ja/depuroi/deploy-a-workflow.md).

## Webアプリ

### Workflowsを整理する

関連するWorkflowsをグループ化するには、Workflowsページでフォルダー追加ボタンをクリックし、名前を入力して「Create Folder」をクリックします。Workflowを移動するには、三点メニューを開き、「Move Workflow」を選択して移動先を指定し、「Move Workflow」をクリックします。

自分のロールで [フォルダーの権限](https://docs.roboflow.com/datasets/manage/project-folders/project-folder-permissions)を管理できる場合は、フォルダーの三点メニューを開き、「Set Permissions」を選択して、その中のWorkflowsを閲覧または編集できるユーザーを設定します。

## HTTP API

これらのエンドポイントはWorkflowsを管理するものであり、実行するものではありません。WorkflowsはServerless Hosted API（例： `https://serverless.roboflow.com`).

### ProjectのベースWorkflow

各Projectには、ホスト型モデルエンドポイントの基盤となるベースWorkflowがあります。これらのエンドポイントを使って、そのWorkflowを取得したり、実行するモデルを選択したりできます。データ収集の有効化、収集上限の設定、レビューキュー内の画像の一覧表示には、 [Active Learning HTTP API](https://docs.roboflow.com/deployment/monitoring-and-analytics/active-learning#http-api).

#### ProjectのベースWorkflowを取得する

{% openapi src="/files/9eba728a9589c03d1443c669dab9fa8adc675c2f" path="/{workspace}/{project}/deploy" method="get" %}
[manage-workflows.yaml](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

#### ProjectのベースWorkflowモデルを選択する

{% openapi src="/files/9eba728a9589c03d1443c669dab9fa8adc675c2f" path="/{workspace}/{project}/deploy/model" method="post" %}
[manage-workflows.yaml](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### Workflowsを一覧表示する

{% openapi src="/files/9eba728a9589c03d1443c669dab9fa8adc675c2f" path="/{workspace}/workflows" method="get" %}
[manage-workflows.yaml](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### Workflowを取得する

{% openapi src="/files/9eba728a9589c03d1443c669dab9fa8adc675c2f" path="/{workspace}/workflows/{workflowId}" method="get" %}
[manage-workflows.yaml](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### Workflowのバージョンを一覧表示する

{% openapi src="/files/9eba728a9589c03d1443c669dab9fa8adc675c2f" path="/{workspace}/workflows/{workflowId}/versions" method="get" %}
[manage-workflows.yaml](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### Workflowを作成する

仕様を次の形式でラップし、 `{"specification": {...}}` JSON文字列として `config`で送信します。Python SDKでは自動的にラップされますが、HTTPを直接呼び出す場合は自分でラップする必要があります。

{% openapi src="/files/9eba728a9589c03d1443c669dab9fa8adc675c2f" path="/{workspace}/createWorkflow" method="post" %}
[manage-workflows.yaml](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### Workflowを更新する

更新すると仕様全体が置き換えられ、新しいバージョンが保存されます。Workflowにデプロイゲートがない場合は、そのバージョンが公開されます。ゲート付きWorkflowでは、この方法による直接公開は拒否されます。その場合は、 [バージョンを保存して公開する](#save-and-publish-a-version)を使用してください。Workflowの `id` には、URLスラッグではなく「Workflowsを一覧表示する」で取得した値を指定します。ProjectのベースWorkflowはここから更新できません。

{% openapi src="/files/9eba728a9589c03d1443c669dab9fa8adc675c2f" path="/{workspace}/updateWorkflow" method="post" %}
[manage-workflows.yaml](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### バージョンを保存して公開する

保存済みのバージョンを選択するか、新しい候補を公開せずに保存してから、必要なチェックを実行し、合格したバージョンを公開します。操作スキーマと必要なスコープについては、Workspaceのデプロイゲート用OpenAPIドキュメントを取得してください。

{% openapi src="/files/9eba728a9589c03d1443c669dab9fa8adc675c2f" path="/workspaces/{workspace}/workflows/deploy-gates/openapi.json" method="get" %}
[manage-workflows.yaml](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

以下のすべてのパスの起点は `https://api.roboflow.com/workspaces/{workspace}/workflows`:

1. 意図した定義を持つ保存済みバージョンがある場合は、それを再利用します。新しい候補が必要な場合は、完全な定義を指定して `POST /{workflowId}/versions` を送信します。これにより、Auto-Publishモードでも、公開やチェックの開始を行わずにドラフトが保存されます。
2. Evalゲートの場合は、 `POST /{workflowId}/versions/{versionId}/deploy-gates/run`を送信します。推論クレジットを消費する場合があります。手動承認の場合は、 `GET /{workflowId}/versions/{versionId}/deploy-gates/manual-approval` を読み取り、承認資格のあるユーザーにRoboflowアプリで承認してもらいます。手動承認のみのバージョンでは実行呼び出しは不要で、APIから承認することはできません。
3. チェックが保留中の間は、 `GET /{workflowId}/versions/{versionId}/deploy-gates` をポーリングします。ゲートが失敗、エラー、またはキャンセルになった場合、あるいは承認者がバージョンを却下した場合は、処理を停止して結果を報告します。 `POST /{workflowId}/versions/{versionId}/deploy` の場合にのみ `publishable` が `true`です。自動公開モードでは、すべてのゲートを通過すると、最後に保存された下書きが自動的に公開されます。

保存操作とチェック実行操作には UUID v4 が必要です。 `Idempotency-Key` ヘッダー。同じリクエストを再試行するときは、同じ値を再利用してください。

### ワークフローをフォークする

このワークスペース内のワークフロー、または Roboflow テンプレートをこのワークスペースにコピーします。フォルダーにスコープされた API キーを使用すると、コピー先は「ワークフローを作成」と同じフォルダールールに従います。別のワークスペースからワークフローをコピーするには、その [共有リンク](https://docs.roboflow.com/workflows/ja/guan-li/share-a-workflow.md) そこでフォークします。

{% openapi src="/files/9eba728a9589c03d1443c669dab9fa8adc675c2f" path="/{workspace}/forkWorkflow" method="post" %}
[manage-workflows.yaml](https://4077895066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-cb5465e92b4a63ad94cd20d120789841c53a3a27%2Fmanage-workflows.yaml?alt=media)
{% endopenapi %}

### ワークフローを削除する

ワークフローを削除するとゴミ箱に移動し、後で復元できます。詳しくは [ゴミ箱を管理する](https://docs.roboflow.com/platform/workspaces/trash#delete-a-workflow).

## Python SDK

[Roboflow Workflows](https://docs.roboflow.com/workflows/ja/gou-zhu/create-a-workflow.md) は、視覚的に構築できるコンピュータービジョンのパイプラインです。SDKでは、 `Workspace`で一覧表示・取得・作成を直接行えます。更新、フォーク、削除には、低レベルの `rfapi` アダプター。

### ワークフローの一覧表示

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
workspace = rf.workspace()

workflows = workspace.list_workflows()
for w in workflows:
    print(w["id"], w["name"], w["url"])
```

### ワークフローを取得

```python
workflow = workspace.get_workflow("slow-webhooks")
print(workflow["specification"])
```

この `url` 引数はワークフローのスラッグ（WebアプリのURLバーに表示されるもの）であり、Firestore IDではありません。

### ワークフローを作成する

```python
workflow = workspace.create_workflow(
    name="My Workflow",
    definition={
        "version": "1.0",
        "inputs": [...],
        "steps": [...],
        "outputs": [...],
    },
)
print(workflow["id"], workflow["url"])
```

渡す `definition=None` 空のワークフローのひな形を作成し、その後ウェブアプリで編集できます。

SDK では、ラップされていない仕様の辞書（`{"version": ..., "steps": ...}`）またはラップされた仕様の辞書（`{"specification": {...}}`); ラップを自動的に正規化し、存在する場合は UTF-8 BOM を削除します。

### ワークフローを更新する

`Workspace` には更新用のメソッドが直接用意されていないため、低レベルのアダプターを使用します。

```python
from roboflow.adapters import rfapi

rfapi.update_workflow(
    api_key="YOUR_API_KEY",
    workspace_url=workspace.url,
    workflow_id=workflow["id"],
    workflow_name="My Workflow",
    workflow_url="my-workflow",
    config={"version": "1.0", "steps": [...]},
)
```

### ワークフローをフォークする

ワークスペース内でワークフローをコピーします。Roboflow のテンプレートを元にするには、 `source_workspace` を `templates`:

```python
from roboflow.adapters import rfapi

forked = rfapi.fork_workflow(
    api_key="YOUR_API_KEY",
    workspace_url=workspace.url,
    source_workspace=workspace.url,
    source_workflow="my-workflow",
    name="My Fork",       # optional; defaults to the source name
    url="my-fork",        # optional; defaults to a generated slug
)
```

### ワークフローのバージョンを一覧表示する

```python
versions = rfapi.list_workflow_versions(
    api_key="YOUR_API_KEY",
    workspace_url=workspace.url,
    workflow_url="my-workflow",
)
```

### ワークフローを削除（論理削除）する

```python
rfapi.delete_workflow(api_key="YOUR_API_KEY", workspace_url=workspace.url, workflow_url="my-workflow")
```

ワークフローはワークスペースの [ゴミ箱](https://docs.roboflow.com/platform/workspaces/trash#python-sdk) に移動され、完全に削除されるまで30日間保管されます。次の方法で復元できます。 `Workspace.restore_from_trash("workflow", id)` —詳しくは [削除と復元](https://docs.roboflow.com/platform/workspaces/trash#workflows).

### ワークフローを実行する

ワークフローの実行には [Inference SDK](https://inference.roboflow.com) と [Workflows runtime](https://docs.roboflow.com/workflows/ja/depuroi/deploy-a-workflow.md)を使用します。 `roboflow` パッケージではありません。Python では次のようにします。

```python
from inference_sdk import InferenceHTTPClient, InferenceConfiguration

client = InferenceHTTPClient(
    api_url="https://serverless.roboflow.com",
    api_key="YOUR_API_KEY",
).configure(InferenceConfiguration(api_key_transport="header"))
result = client.run_workflow(
    workspace_name="my-workspace",
    workflow_id="my-workflow",
    images={"image": "photo.jpg"},
)
```

## CLI

コマンドラインからワークフローの一覧表示、作成、更新、フォーク、バージョン管理を行えます。

### Workflowsを一覧表示する

```bash
roboflow workflow list
```

```bash
roboflow workflow list --json
```

### ワークフローの詳細を取得

```bash
roboflow workflow get my-workflow
```

```bash
roboflow workflow get my-workflow --json
```

### Workflowを作成する

```bash
roboflow workflow create --name "My Workflow"
```

JSON定義ファイルを使用する場合:

```bash
roboflow workflow create --name "My Workflow" --definition workflow.json
```

#### オプション

| フラグ             | 説明             |
| --------------- | -------------- |
| `--name`        | ワークフロー名（必須）    |
| `--definition`  | JSON定義ファイルへのパス |
| `--description` | ワークフローの説明      |

### Workflowを更新する

ワークフローの定義を更新する:

```bash
roboflow workflow update my-workflow --definition updated.json
```

### Workflowのバージョンを一覧表示する

```bash
roboflow workflow version list my-workflow
```

```bash
roboflow workflow version list my-workflow --json
```

### ワークフローをフォークする

現在のワークスペースからワークフローをフォークする:

```bash
roboflow workflow fork my-workflow
```

Roboflowテンプレートをフォークする:

```bash
roboflow workflow fork templates/general-segmentation-api
```

### JSON出力

すべてのワークフローコマンドは `--json` による構造化出力に対応しています:

```bash
roboflow workflow list --json | jq '.[].name'
roboflow workflow create --name "Test" --json
```

終了コード: 0 = 成功、1 = エラー、2 = 認証エラー、3 = 見つかりません。

## MCPサーバー

AIエージェントを [MCPサーバー](https://docs.roboflow.com/agents/mcp-server) に接続して、ワークフローを作成・実行できます。

下書きを保存するには `workflow_versions_save` を使用し、Evalチェックには `workflow_version_deploy_gates_run` を使用します。また、すべてのゲートの判定を確認するには `workflow_version_deploy_gates_get` を使用します。手動承認の場合は、 `workflow_version_approval_get` を読み取り、承認資格のある人にRoboflowアプリで判断を依頼してください。 `workflow_version_deploy` を呼び出すのは、 `publishable` が `true`。MCP は Workflow のバージョンを承認できません。

<table data-search="false"><thead><tr><th width="290">ツール</th><th>説明</th></tr></thead><tbody><tr><td><code>workflows_list</code></td><td>ワークスペースに保存されている Workflow を一覧表示します。</td></tr><tr><td><code>workflows_get</code></td><td>保存されている Workflow の詳細を取得します。</td></tr><tr><td><code>workflows_create</code></td><td>新しい Workflow を作成して保存します。</td></tr><tr><td><code>workflows_update</code></td><td>保存されている Workflow の名前と定義を更新します。</td></tr><tr><td><code>workflows_run</code></td><td>保存されている Workflow を 1 つ以上の画像に対して実行します。</td></tr><tr><td><code>workflows_delete</code></td><td>保存されている Workflow を削除し、ワークスペースのゴミ箱に移動します。</td></tr></tbody></table>
