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

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

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

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

{{ 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字程度のサマリーを作成してください。

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

{% 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) }}