Roboflowアセットライブラリアトリビュート

アセットライブラリ画像の属性とタグを更新します。

既存の Asset Library 画像に対する属性とタグの更新を送信し、モデル出力をフィルタ可能な画像フィールドにできるエンリッチメントワークフローを有効にします。

このブロックの仕組み

このブロックは、Roboflow ワークスペース内の既存の Asset Library 画像に対して、キーと値の属性およびタグを送信します。属性値は画像メタデータとして保存されます。このブロックは次のことを行います：

1. Asset Library のソース画像 ID、任意の属性、任意のタグを受け取ります

2. 設定された Roboflow API キーから対象ワークスペースを解決します

3. 属性とタグの両方が空の行はスキップします

4. 逐次セマンティクスを使用して重複するソース ID をマージします。後の属性値が優先され、タグは重複除去されたセットとして追加されます

5. 1 回のバッチ更新リクエストを送信し、入力順で入力ソース ID ごとに 1 件の送信ステータスを返します

同じソース ID に対して同じワークフローを再実行しても安全です。属性キーは upsert され（最後の書き込みが優先）、タグは和集合になります。破壊的書き込みはありません。

このブロックは画像バイトを送信せず、新しい画像も作成しません。既存の Asset Library ソース画像のみを更新します。属性キーの削除、タグの削除、注釈の書き込み、画像の作成は、このワークフローブロックの対象外として意図的に扱われません。

要件

このブロックには有効な Roboflow API キーが必要です。API キーによって、更新可能な Asset Library 画像が属するワークスペースが決まります。

型識別子

ステップで次の識別子を使用してください "type" フィールド： roboflow_core/asset_library_attributes@v1 ワークフローにこのブロックをステップとして追加するには。

プロパティ

名前	型	説明	参照
name	str	このステップの一意の識別子を入力してください。	❌
source_id	str	更新する Asset Library のソース画像 ID。バッチワークフローでは、画像ごとに 1 つのソース ID を指定してください。	✅
metadata	Dict[str, Union[bool, float, int, str]]	Asset Library 画像に設定する任意のキーと値の属性。属性は画像メタデータとして保存されます。値が静的値またはセレクター参照（例： $inputs.camera_id）、または上流ステップによって生成された行ごとの dict への全フィールドセレクター。	✅
tags	List[str]	Asset Library 画像に追加する任意のタグ。各エントリは静的文字列またはワークフロー入力/ステップへの参照（例： $inputs.label)..	✅
disable_sink	bool	True の場合、ブロックの実行は無効になり、Asset Library の属性書き込みは行われません。	✅

この 参照 列は、で利用可能な動的値を使ってプロパティをパラメータ化できる可能性を示します ワークフロー 実行時。参照 バインディング 詳細は。

ランタイム互換性

requires_internet - エアギャップ／オフライン環境: このブロックは、完全にオフライン／エアギャップ環境から到達できないサービスに依存しています。

入力と出力のバインディング

利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が Roboflow Asset Library 属性 のバージョン v1 あるか確認してください。

入力と出力のバインディング

• 入力

  • source_id (string): Asset Library の更新対象ソース画像 ID。バッチワークフローでは、画像ごとに 1 つのソース ID を指定してください。

  • metadata (Union[*, 辞書]): Asset Library 画像に設定する任意のキーと値の属性。属性は画像メタデータとして保存されます。値が静的値またはセレクター参照（例： $inputs.camera_id）、または上流ステップによって生成された行ごとの dict への全フィールドセレクター。

  • tags (Union[list_of_values, string]): Asset Library 画像に追加する任意のタグ。各エントリは静的文字列またはワークフロー入力/ステップへの参照（例： $inputs.label)..

  • disable_sink (boolean): True の場合、ブロックの実行は無効になり、Asset Library の属性書き込みは行われません。

• 出力

  • error_status (boolean) : ブールフラグ。

  • message (string) : 文字列値。

JSON 定義の例

{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/asset_library_attributes@v1",
	    "source_id": "$inputs.source_id",
	    "metadata": {
	        "color": "red",
	        "score": 0.98
	    },
	    "tags": [
	        "auto-labeled",
	        "red"
	    ],
	    "disable_sink": false
	}