DifyのテンプレートブロックとJinja2を完全解説：RAG・ループ・コードブロックとの使い分けまで

Difyのテンプレートブロックとは？Jinja2を使ったデータ変換の全貌

テンプレートブロックの基本: Jinja2テンプレートとは何か

{{ variable_name }}          ← 変数の参照
{{ user.name }}              ← ネストされたオブジェクトのプロパティ
{{ items[0].title }}         ← 配列の要素
{{ data.metrics.score }}     ← 深いネスト

テンプレートブロック vs コードブロック: どちらを使うべきか

Jinja2の条件分岐とループを使いこなす

{% if user.subscription == 'premium' %}
おかえりなさい、プレミアムメンバー様！全ての機能にアクセスできます。
{% elif user.subscription == 'basic' %}
ベーシックプランでご利用中です。プレミアムへのアップグレードも可能です。
{% else %}
ご利用ありがとうございます。プランを選択してください。
{% endif %}

{% for item in search_results %}
### 検索結果 {{ loop.index }}
**スコア**: {{ item.score | round(2) }}
{{ item.content }}
---
{% endfor %}

Jinja2フィルターで出力を整える

{{ name | upper }}                      ← 大文字変換
{{ price | round(2) }}                  ← 小数点以下2桁に丸め
{{ content | replace('\n', '<br>') }}   ← 改行をHTMLタグに変換
{{ score | default('未計算') }}          ← 値がなければデフォルト値
{{ text | truncate(100) }}              ← 100文字で切り詰め
{{ items | length }}                    ← 配列の要素数を取得

{{ metrics.accuracy | round(2) if metrics.accuracy else '計算中' }}

テンプレートブロックの実践パターン: プロンプトテンプレートとして使う

あなたは以下の情報をもとにレポートを作成するアシスタントです。

## 対象ユーザー
名前: {{ user.name }}
役職: {{ user.role }}
{% if user.department %}所属: {{ user.department }}{% endif %}

## 分析データ
{% for metric in metrics %}
- {{ metric.name }}: {{ metric.value | round(2) }}
{% endfor %}

## 指示
上記のデータを元に、{{ report_type }}形式で300字程度のサマリーを作成してください。

JSONテンプレートとRAGワークフローへの応用

{
  "user_id": "{{ user_id }}",
  "query": "{{ search_query | replace('"', '\\"') }}",
  "filters": {
    "category": "{{ category }}",
    "limit": {{ limit | default(10) }}
  }
}

1. ユーザーの質問を知識検索ブロックに渡す
2. 検索結果（複数のチャンク）が返ってくる
3. テンプレートブロックで検索結果を整形する
4. 整形されたコンテキストをLLMノードのプロンプトに埋め込む

ループブロックとテンプレートブロックの連携

{% for item in previous_results %}
{{ loop.index }}. {{ item }}
{% endfor %}

新しい結果: {{ current_result }}

テンプレートブロックのよくあるエラーと対処法

テンプレートブロックの応用: インタラクティブフォームの生成

<form data-format="json">
  <label for="category">カテゴリ:</label>
  <input type="select" name="category" 
    data-options='["技術","ビジネス","デザイン"]'/>
  
  <label for="priority">優先度:</label>
  <input type="select" name="priority" 
    data-options='["高","中","低"]'/>
  
  <label for="detail">詳細:</label>
  <textarea name="detail" placeholder="詳細を入力してください"></textarea>
  
  <button type="submit" variant="primary">送信</button>
</form>

テンプレートブロックのベストプラクティス

{{ user.email | default('メールアドレス未登録') }}
{{ score | default(0) | round(2) }}

テンプレートの一覧管理とチームでの使い方

テンプレートブロックでよくある質問

Q: テンプレートブロックを追加したいがメニューに見当たらない

Q: Jinjaテンプレートの構文エラーが出る

Q: Dify テンプレート 日本語の文字化けが起きる

Q: テンプレートブロックの出力をJSONとして次のノードで使いたい

まとめ: テンプレートブロックの使いどころを押さえよう

---

出典・参考資料

• テンプレートノード - Dify 公式ドキュメント（日本語）
• Template - Dify Docs（英語版）
• コードノード - Dify 公式ドキュメント（日本語）