> 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/burokku/blocks/data-storage/roboflow-asset-library-attributes.md).

# 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` あるか確認してください。

<details>

<summary>入力と出力のバインディング</summary>

* 入力
  * `source_id` ([*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)): Asset Library の更新対象ソース画像 ID。バッチワークフローでは、画像ごとに 1 つのソース ID を指定してください。
  * `metadata` (*Union\[*[*`*`*](/workflows/ja/gaido/developer-guide/kinds/wildcard.md)*,* [*`辞書`*](/workflows/ja/gaido/developer-guide/kinds/dictionary.md)*]*): Asset Library 画像に設定する任意のキーと値の属性。属性は画像メタデータとして保存されます。値が静的値またはセレクター参照（例： `$inputs.camera_id`）、または上流ステップによって生成された行ごとの dict への全フィールドセレクター。
  * `tags` (*Union\[*[*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)*,* [*`string`*](/workflows/ja/gaido/developer-guide/kinds/string.md)*]*): Asset Library 画像に追加する任意のタグ。各エントリは静的文字列またはワークフロー入力/ステップへの参照（例： `$inputs.label`)..
  * `disable_sink` ([*`boolean`*](/workflows/ja/gaido/developer-guide/kinds/boolean.md)): True の場合、ブロックの実行は無効になり、Asset Library の属性書き込みは行われません。
* 出力
  * `error_status` ([`boolean`](/workflows/ja/gaido/developer-guide/kinds/boolean.md)) : ブールフラグ。
  * `message` ([`string`](/workflows/ja/gaido/developer-guide/kinds/string.md)) : 文字列値。

</details>

<details>

<summary>JSON 定義の例</summary>

```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
	}
```

</details>