> 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/advanced-blocks/string-template.md).

# 文字列テンプレート

テンプレートと実行時データから文字列を構築します。例: 動的なVLMプロンプト。

テンプレートから文字列を構築します。名前付きプレースホルダーはワークフロー入力とステップ出力から実行時に埋め込まれ、VLM ブロック向けの動的プロンプト生成、通知および sink ブロック向けのメッセージ整形、さらにワークフローデータからテキストを組み立てる必要があるあらゆる箇所を可能にします。

## このブロックの仕組み

このブロックは、名前付きプレースホルダーを実行時の値で置換してテンプレート文字列を描画します。このブロックは次のとおりです。

1. 波かっこで囲まれたプレースホルダーを含むテンプレート文字列を受け取ります。例: `「このフェーシングには次の製品のいずれかが含まれます: {sku_list}。製品名または NONE で答えてください。」`
2. 入力データを名前付き変数の辞書として受け取ります。値にはリテラル値、ワークフロー入力（`$inputs.*`）またはステップ出力（`$steps.*`)
3. 必要に応じて、置換前に各変数へ操作（Property Definition ブロックおよび Expression ブロックと同じ操作システム）を使ったデータ変換を適用します。たとえば、値のリストを 1 つの文字列に結合したり `SequenceJoin`、あるいは検出結果からクラス名を抽出したりできます。 `DetectionsPropertyExtract`
4. 各 `{variable_name}` プレースホルダーを対応する変数の（変換後の）値で置換し、文字列以外の値は文字列に変換します。標準の Python の書式指定がサポートされています（例: `{confidence:.2f}`)
5. 描画された文字列を、種類が次の出力として返します: `string`。文字列を受け付ける任意のブロックフィールドにそのまま接続できます。たとえば、 `prompt` VLM ブロックのフィールド

リテラルの波かっこは、2 つ重ねることで生成できます（`{{` は次のように描画されます `{`, `}}` は次のように描画されます `}`).

テンプレートがデータ内で定義されていない変数を参照した場合、位置指定プレースホルダー（`{}` または `{0}`）を使用した場合、またはプレースホルダーが属性アクセスやインデックスアクセス（`{var.attr}`, `{var[0]}`）を使う場合、ブロックは実行時に説明的なエラーで失敗します。代わりにデータ操作を使ってネストした値を抽出してください。テンプレートとデータの不一致を明示的に失敗させることで、静かに壊れた出力（例: 製品リストが欠けたプロンプト）が下流に伝播するのを防ぎます。

## 一般的な使用例

* **制約付き VLM プロンプト**：ランタイムのコンテキスト（例: プラノグラム、マニフェスト、または BOM から得た期待製品リスト）を設計済みのプロンプトテンプレートに埋め込んだプロンプトを組み立てます。これにより、ユーザーはデータのみを提供し、検証済みのプロンプト文言はワークフロー内に保持されるため、期待値駆動の検査ワークフローを実現できます
* **sink と通知の動的メッセージ**：検出数、クラス名、タイムスタンプを含む人間が読めるメッセージを、email、Slack、Twilio、または webhook の sink ブロック向けに整形し、読みやすいアラートワークフローを実現します
* **構造化テキストレコード**：複数のステップ出力から 1 行のテキストレコードを作成し、ログ記録や下流処理に利用できるようにして、テキストシリアライズのワークフローを実現します

## 他のブロックへの接続

このブロックはワークフロー入力とステップ出力を受け取り、文字列を生成します:

* **VLM ブロックの前** （例: Qwen-VL、Florence-2、OpenAI、Anthropic Claude、Google Gemini）で次を構築します: `prompt` ランタイムデータから、動的プロンプト作成ワークフローを可能にします
* **モデルおよび分析ブロックの後** それらの出力を読みやすいテキストに描画し、結果整形ワークフローを可能にします
* **sink ブロックの前** （email、webhook、MQTT、OPC）でメッセージペイロードを整形し、通知ワークフローを可能にします

## セキュリティに関する考慮事項

テンプレートまたはデータがワークフロー入力や上流のモデル出力を参照する場合、それらのソースを制御する者が組み立てられたプロンプトに影響を与え、ひいては描画された文字列を受け取る下流のモデルの挙動にも影響します（OWASP LLM01、プロンプトインジェクション）。このブロックは構造上の安全性 - 属性アクセスやインデックスアクセスなし、位置指定プレースホルダーなし、テンプレート/データの不一致時には明示的に失敗 - を保証しますが、プレースホルダーの値はそのまま置換されるため、意味的なインジェクションを防ぐことはできません。したがって、これらの入力を誰が供給できるかを決める責任はワークフローのデプロイ担当者にあります。描画された文字列がモデルに渡る箇所では、自由記述テキストよりも、制約されたドメイン固有の入力（たとえば許可リストに登録された SKU カタログ）を優先してください。

レンダリングも、悪意あるテンプレートや偶発的なテンプレートがメモリを使い果たすのを防ぐために制限されています。書式指定における数値の幅と精度は 10,000 に上限があり、パディングされた文字列が確保される前に拒否されます。描画された出力はさらに 1,000,000 文字に制限され、その上限を超える出力は下流に伝播する代わりに、説明的なエラーでステップが失敗します。

## 要件

テンプレートは、属性アクセスやインデックスアクセスを使わず、データ辞書で定義された変数のみを参照しなければなりません。データ操作は任意であり、Property Definition ブロックと同じ操作システムを使用します。置換前に値を変換するために使用してください（例: リストの結合、プロパティの抽出）。

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/string_template@v1` を、ワークフローにステップとして追加します。

### プロパティ

| **名前**   | **型**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | **説明**                                                                                                                                             | 参照 |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name`   | `str`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | このステップの一意の識別子を入力してください。                                                                                                                            | ❌  |
| `テンプレート` | `str`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 波かっこ内の名前付きプレースホルダーを持つテンプレート文字列。実行時にデータから埋め込まれます。リテラルの波かっこには二重波かっこを使用します。例: 'このフェーシングには次のいずれかが含まれます: {sku\_list}。製品名または NONE で答えてください。'.            | ✅  |
| `データ`    | `Dict[str, Union[bool, float, int, str]]`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | テンプレートのプレースホルダーを埋めるために使用される名前付き変数の辞書です。キーはテンプレート内で参照される変数名で、値はワークフロー入力またはステップ出力を参照するセレクタ、またはリテラル値です。。                                              | ✅  |
| `データ操作`  | `Dict[str, List[Union[ClassificationPropertyExtract, ConvertDictionaryToJSON, ConvertImageToBase64, ConvertImageToJPEG, DetectionsFilter, DetectionsOffset, DetectionsPropertyExtract, DetectionsRename, DetectionsSelection, DetectionsShift, DetectionsToDictionary, Divide, ExtractDetectionProperty, ExtractFrameMetadata, ExtractImageProperty, LookupTable, Multiply, NumberRound, NumericSequenceAggregate, PickDetectionsByParentClass, RandomNumber, SequenceAggregate, SequenceApply, SequenceElementsCount, SequenceJoin, SequenceLength, SequenceMap, SortDetections, StringMatches, StringSubSequence, StringToLowerCase, StringToUpperCase, TimestampToISOFormat, ToBoolean, ToNumber, ToString]]]` | 置換前にデータ変数を変換するための任意の辞書です。キーは data の変数名で、値は操作のリストです（Property Definition ブロックと同じ）。リストをテキストに結合する（SequenceJoin）場合や、テンプレート化の前に予測結果からプロパティを抽出する場合に便利です。。 | ❌  |

この **参照** この列は、 `workflow` の実行時に利用可能な動的値でプロパティをパラメータ化できる可能性を示します。 *バインディング* の詳細を参照してください。

### 入力および出力バインディング

利用可能な接続は、そのバインディング種別に依存します。 `文字列テンプレート` バージョン `v1` に、どのバインディング種別があるか確認してください。

<details>

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

* input
  * `テンプレート` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)): 波かっこ内の名前付きプレースホルダーを持つテンプレート文字列。実行時にデータから埋め込まれます。リテラルの波かっこには二重波かっこを使用します。例: 'このフェーシングには次のいずれかが含まれます: {sku\_list}。製品名または NONE で答えてください。'.
  * `データ` ([*`*`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/wildcard.md)): テンプレートのプレースホルダーを埋めるために使用される名前付き変数の辞書です。キーはテンプレート内で参照される変数名で、値はワークフロー入力またはステップ出力を参照するセレクタ、またはリテラル値です。。
* output
  * `output` ([`string`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)): 文字列値。

</details>

<details>

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

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/string_template@v1",
	    "template": "このフェーシングには次のいずれかが含まれます: {sku_list}。製品名または NONE で答えてください。",
	    "data": {
	        "sku_list": "$inputs.expected_skus"
	    },
	    "data_operations": {
	        "sku_list": [
	            {
	                "separator": ", ",
	                "type": "SequenceJoin"
	            }
	        ]
	    }
	}
```

</details>
