Template

Узел Template преобразует и форматирует данные из нескольких источников в структурированный текст с помощью шаблонизатора Jinja2. Используйте его, чтобы объединять переменные, форматировать результаты и подготавливать данные для последующих узлов или конечных пользователей.

Шаблонизатор Jinja2

Узлы Template используют синтаксис шаблонизатора Jinja2 для создания динамического содержимого, которое адаптируется в зависимости от данных рабочего процесса. Это даёт возможности, близкие к программированию: циклы, условия и фильтры для сложной генерации текста.

Подстановка переменных

Ссылайтесь на переменные рабочего процесса с помощью двойных фигурных скобок: {{ variable_name }}. Вы можете обращаться к свойствам вложенных объектов и элементам массивов через точечную нотацию и квадратные скобки.

{{ user.name }}
{{ items[0].title }}
{{ data.metrics.score }}

Условная логика

Показывайте разное содержимое в зависимости от значений данных с помощью конструкций if-else:

{% if user.subscription == 'premium' %}
Welcome back, Premium Member! You have access to all features.
{% else %}
Consider upgrading to Premium for additional capabilities.
{% endif %}

Циклы и итерации

Обрабатывайте массивы и объекты с помощью циклов for для генерации повторяющегося содержимого:

{% for item in search_results %}
### Result {{ loop.index }}
**Score**: {{ item.score | round(2) }}
{{ item.content }}
---
{% endfor %}

Обработка результатов поиска по базе знаний с помощью узла Template

Форматирование данных

Фильтры

Фильтры Jinja2 преобразуют данные при отрисовке шаблона:

{{ name | upper }}
{{ price | round(2) }}
{{ content | replace('\n', '<br>') }}
{{ tags | join(', ') }}
{{ score | default('No score available') }}

Обработка ошибок

Корректно обрабатывайте отсутствующие или некорректные данные с помощью значений по умолчанию и условных проверок:

{{ user.email | default('No email provided') }}
{{ metrics.accuracy | round(2) if metrics.accuracy else 'Not calculated' }}

Интерактивные формы

Шаблоны могут генерировать интерактивные HTML-формы для структурированного сбора данных в Chatflow. При отправке значения формы передаются в чат как следующее сообщение конечного пользователя. Формат зависит от атрибута data-format элемента <form>:

data-format="json": значения сериализуются как объект JSON. Последующий узел Code или Экстрактор параметров может выполнить JSON.parse (или сопоставить по шаблону), чтобы извлечь каждое поле.
Не задан (или любое другое значение): значения передаются как обычный текст, по одной паре name: value в строке. Так проще для чтения LLM.

Например:

<form data-format="json">
  <label for="username">Username:</label>
  <input type="text" name="username" placeholder="Please enter" />
  <label for="password">Password:</label>
  <input type="password" name="password" placeholder="Please enter" />
  <label for="content">Content:</label>
  <textarea name="content"></textarea>
  <label for="date">Date:</label>
  <input type="date" name="date" />
  <label for="time">Time:</label>
  <input type="time" name="time" />
  <label for="datetime">Datetime:</label>
  <input type="datetime" name="datetime" />
  <label for="select">Select:</label>
  <input type="select" name="select" data-options='["Option A","Option B","Option C"]' />
  <input type="checkbox" name="agreed" data-tip="By checking this means you agreed" />
  <button data-variant="primary">Login</button>
</form>

Интерактивная форма, отрисованная в интерфейсе чата

Поддерживаемые теги

Тег	Атрибуты	Примечания
`<form>`	`data-format`	Контейнер для полей формы. Установите `data-format="json"`, чтобы получать отправленные данные в формате JSON; любое другое значение (или отсутствие значения) передаёт обычный текст.
`<label>`	`for`	Отрисовывает внутренний текст как метку поля. Установите `for` равным значению `name` поля, чтобы связать их. Разместите `<label>` перед его полем в исходном коде, чтобы метка отображалась сверху.
`<input>`	`type`, `name`, `value`, `placeholder`, `checked`, `data-tip`, `data-options`	См. типы полей ввода ниже. Атрибут `name` обязателен, чтобы поле попало в отправленные данные, и должен соответствовать шаблону `[A-Za-z][A-Za-z0-9_-]*`.
`<textarea>`	`name`, `placeholder`, `value`	Многострочное поле ввода текста.
`<button>`	`data-variant`, `data-size`	Отправляет форму. Варианты: `primary`, `warning`, `secondary`, `secondary-accent`, `ghost`, `ghost-accent`, `tertiary`. Размеры: `small`, `medium`, `large`. Значения вне этих списков игнорируются, и кнопка возвращается к стилю по умолчанию. Игнорирует `data-message` и `data-link`, которые применяются только к кнопкам быстрого ответа.

Не оставляйте пустые строки между тегами внутри <form>. Пустая строка завершает блок HTML при разборе markdown, и любые теги после разрыва не будут отрисованы как поля формы.

Поддерживаемые типы полей ввода

Значение `type`	Отрисовывается как	Передаётся как
`text`, `password`, `email`, `number`	Однострочное поле ввода с соответствующей HTML-семантикой	Строка
`date`	Выбор даты	Строка даты в формате ISO (например, `2026-01-10`)
`datetime`	Выбор даты с указанием времени	Строка даты и времени в формате ISO (например, `2026-01-10T14:30:00.000+08:00`)
`time`	Выбор времени	Строка (включает полный префикс даты, а не только время)
`checkbox`	Флажок, за которым в качестве метки следует текст `data-tip`	Логическое значение (`true` или `false`)
`select`	Выпадающий список, построенный из JSON-массива строк `data-options`	Строка выбранного варианта
`hidden`	Отрисовывается как элемент `<input type="hidden">`; не виден в интерфейсе	Строка

Любое другое значение type отрисовывает заглушку «Unsupported tag» вместо поля.
Атрибуты валидации HTML5, такие как required, min, max и pattern, не применяются.
Браузеры могут автоматически заполнять <input type="password"> и <input type="email"> сохранёнными учётными данными для текущего сайта; используйте <input type="text"> для полей, которые не должны заполняться заранее.

Кнопки быстрого ответа

Отдельный элемент <button>, размещённый за пределами любой формы <form>, отрисовывается как кликабельная кнопка в чате. Используйте такие кнопки, чтобы предлагать готовые ответы или внешние ссылки прямо в сообщении ассистента. Например:

Would you like to see more options?
<button data-variant="primary" data-message="Yes, show me more">Yes</button> <button data-variant="secondary" data-message="No, that is enough">No</button> <button data-variant="secondary-accent" data-link="https://docs.dify.ai">Read the docs</button>

Атрибут	Поведение при нажатии
`data-message`	Передаёт текст как следующее сообщение конечного пользователя в чате.
`data-link`	Открывает URL в новой вкладке. Должен быть корректным URL.

Если заданы оба атрибута, приоритет имеет data-link. Кнопка без обоих атрибутов отрисовывается, но при нажатии не выполняет никаких действий. Применяйте data-variant и data-size для стилизации, используя те же значения, что перечислены для кнопок формы выше.

В отличие от кнопок формы, отдельные кнопки передают data-variant и data-size в базовый компонент без валидации. Нераспознанное значение может привести к тому, что кнопка отрисуется как обычный текст, а не как стилизованная кнопка.Используйте только перечисленные выше значения.

Ограничения вывода

Вывод узла Template ограничен 400 000 символами (настраивается через TEMPLATE_TRANSFORM_MAX_LENGTH). Это предотвращает проблемы с памятью и обеспечивает разумное время обработки для больших объёмов вывода шаблона.

Начало работы

Создание

Публикация

Мониторинг

База знаний

Рабочее пространство

Руководства

Шаблонизатор Jinja2

Подстановка переменных

Условная логика

Циклы и итерации

Форматирование данных

Фильтры

Обработка ошибок

Интерактивные формы

Поддерживаемые теги

Поддерживаемые типы полей ввода

Кнопки быстрого ответа

Ограничения вывода

​Шаблонизатор Jinja2

​Подстановка переменных

​Условная логика

​Циклы и итерации

​Форматирование данных

​Фильтры

​Обработка ошибок

​Интерактивные формы

​Поддерживаемые теги

​Поддерживаемые типы полей ввода

​Кнопки быстрого ответа

​Ограничения вывода

Шаблонизатор Jinja2

Подстановка переменных

Условная логика

Циклы и итерации

Форматирование данных

Фильтры

Обработка ошибок

Интерактивные формы

Поддерживаемые теги

Поддерживаемые типы полей ввода

Кнопки быстрого ответа

Ограничения вывода