プロンプトテンプレート
インスペクターにリッチなPrompt templateエディターが表示されるステップ(Generate Textやカスタムノードから作成したステップなど)では、同じ構文を使用できます。@nameと記述すると、そのステップが処理しているコンテンツバージョンに対応する値へ置き換えられます。終端ステップの通常の書き出しファイル名フィールドでも同じマーカー構文を使用できますが、ファイル名固有の動作があります。
ルール
@nameはラベル(ビューアーが期待する人間が読める文字列)に解決されます。
以下のドキュメントを@Languageに翻訳しています。
ドキュメント:
@text
エディターでは色で区別される2種類の名称が利用可能です。
- 入力スロット(緑色)—
@text、@imageなど、上流のステップから接続されたもの。このコンテンツバージョンにおける上流ステップの出力として展開されます。 - バージョングループ(シアン)—
@Language、@Platform、@Lengthなど、スペースで宣言されたバージョングループごとに1つ。値の人間が読めるラベル(中文、TikTok)としてレンダリングされます。
バージョングループを追加すると、その正確な名前がマーカーになります。Platform は @Platform、Content Length は @{Content Length}、内容平台 は @{内容平台} を作成します。プロンプトの名前は大文字と小文字を区別し、各マーカーが1つのグループだけを示すよう、重複するグループ名は拒否されます。
不明な名前には赤い破線の下線と「〜のことですか?」という候補が表示されます。解決できない名前は最終的なプロンプト内にそのまま残り、IceFoldが自動的に削除することはありません。
境界形式: @{name}
隣接するテキストが識別子の一部のように見える場合、名前を波括弧で囲みます。2つの形式は同一に置換されます。波括弧は単なる曖昧さ回避のツールです。
report_@{Target Language}.v1.txt → report_中文.v1.txt
エスケープ: @@
リテラルな@(例:文章内のHello @user)としてレンダリングするには、二重にします。
Hello @@user → Hello @user
二重化は自然に拡張されます:@@@@は@@としてレンダリングされます。注意すべき点は、直前に文字または数字がある@はすでに無視されるため、[email protected]はエスケープなしでリテラルのまま維持されます。
エディターの機能
Prompt templateフィールドは単なるテキストエリア以上です。入力中に以下の機能が利用可能です。
- チップツールバー: エディター上部には、このステップで使用可能なすべてのプレースホルダーが一覧表示され、ソースごとにグループ化されています。クリックして挿入できます。配線されていない入力スロットは薄く表示されます。
- オートコンプリート:
@を入力すると候補が開きます。@{と入力すると、メニューが境界形式の候補に切り替わります。 - ピルにカーソルを合わせる: 任意のピルにカーソルを合わせると、その種類と、現在プレビューされているコンテンツバージョンに対して何に解決されるかを確認できます。
- プレビューパネル: エディター下部のプレビューパネルは、実際のバックエンドの置換を反映します。ドロップダウンからコンテンツバージョンを選択し、LLMが受け取るプロンプトが正確にどうなるかを確認できます。
文法の概要
| 形式 | レンダリング結果 |
|---|---|
@name |
このコンテンツバージョンにおけるnameのラベル |
@{name} |
同上(明示的な境界付き) |
@@ |
リテラルな@ |
[email protected] |
リテラル — 単語文字の後の@は文章の一部 |
@unknown |
リテラルな@unknown、エディターで赤くフラグ付き |
書き出しファイル名ではバージョングループのマーカーだけが置換され、値IDが使われます。たとえば
@Languageは人が読むラベルの中文ではなくzhになります。これにより、書き出し名を安定させます。Prompt templateフィールドでは、@Languageにラベルが使われます。
