Docs

История релизов

НАЧАЛО РАБОТЫ С ПЛАТФОРМОЙ

ПЕРЕД СОЗДАНИЕМ АГЕНТА

КОНСТРУКТОР СЦЕНАРИЯ АГЕНТА

СОЗДАНИЕ АГЕНТА НА ПЛАТФОРМЕ

ОБУЧЕНИЕ И ТЕСТИРОВАНИЕ АГЕНТА

РАЗМЕЩЕНИЕ АГЕНТА В КАНАЛАХ

ЭКСПЛУАТАЦИЯ АГЕНТА

АНАЛИТИКА ОБЩЕНИЯ АГЕНТА

Explore

СОЗДАНИЕ АГЕНТА НА ПЛАТФОРМЕ

Синтаксис

Общая информация о синтаксисе

Синтаксис может использоваться в следующих

@Слот⁠

ах:

⁠

@Text⁠

: допустимо использование

@Выражение⁠

@Выражение с управляющей конструкцией⁠

в поле Text List

⁠

@Attachment⁠

: допустимо использование

@Выражение⁠

@Выражение с управляющей конструкцией⁠

в полях Source и Caption

⁠

@Slot Filling⁠

: допустимо использование

@Выражение⁠

@Выражение с управляющей конструкцией⁠

в поле Question

⁠

@button⁠

: допустимо использование

@Выражение⁠

в поле Label

⁠

@condition⁠

: допустимо использование

@Выражение⁠

в поле Condition

⁠

@Timer⁠

: допустимо использование

@Выражение⁠

в поле If

⁠

@Memory⁠

: допустимо использование

@Выражение⁠

@Выражение с управляющей конструкцией⁠

в поле Value

⁠

@External Request⁠

: допустимо использование

@Выражение⁠

@Выражение с управляющей конструкцией⁠

в полях URL, Value на вкладке Headers и Query parameters, Data, поле Name на вкладке Response

⁠

@Incoming Request⁠

: допустимо использование

@Выражение⁠

@Выражение с управляющей конструкцией⁠

в поле Value

⁠

@Synonym⁠

: допустимо использование

@Выражение⁠

@Выражение с управляющей конструкцией⁠

в поле Source

Синтаксис

@Платформа⁠

использует синтаксис шаблонизатора Jinja:

⁠

https://jinja.palletsprojects.com/en/3.0.x/templates/⁠

⁠

@Шаблон⁠

ы в синтаксисе делятся на 2 концепции:

⁠

@Выражение⁠

. Заключаются в двойные фигурные скобки.

⁠

https://jinja.palletsprojects.com/en/3.0.x/templates/#expressions⁠

⁠

Примеры:

⁠

@Выражение с управляющей конструкцией⁠

. Заключаются в фигурные скобки с символом %.

https://jinja.palletsprojects.com/en/3.0.x/templates/#list-of-control-structures⁠

⁠

Примеры:

{% if client_message == ‘привет’ %}Hi{% else %}Bye{% endif %}

{% for number in [1, 2, 3] %}{{ number }}{% endfor %}

Поддерживаемые типы данных

Поддерживаемые типы данных

Тип данных

Memory

Примеры вывода в текстовом слоте

Примечание

Строки

Пустая строка: {{ '' }} или {{ "" }}

string Пустая строка выводится в виде отсутcтвия значения

Если строка обрамлена двойными кавычками и внутри строки присутствует символ двойных кавычек в качестве знака препинания, то символ кавычек внутри строки необходимо экранировать символом \ для прохождения

Валидация сценария

⁠

и корректного отображения. Пример: {{ "кинотеатр \"Победа\" " }} Если строка обрамлена одинарными кавычками и внутри строки присутствует символ одинарных кавычек в качестве знака препинания, то символ кавычек внутри строки необходимо экранировать символом \ для прохождения

Валидация сценария

⁠

и корректного отображения. Пример: {{ 'I\'ve made an order' }} В случаях, когда строка обрамлена двойными кавычками и внутри строки присутствует символ одинарных кавычек, либо если строка обрамлена одинарными кавычками и внутри строки присутствует символ двойных кавычек, экранирование не требуется.

Числа

42.23

Булевы

True

False

Отсутствие значения

Выводится в виде отсутcтвия значения

Объекты

{{ {"one": 1, "two": 2, "colors": ["red", "green", "blue"]} }}

{"one": 1, "two": 2, "colors": ["red", "green", "blue"]}

Платформа

⁠

доступны

Зарезервированные методы объектов

⁠

Зарезервированные методы объектов

⁠

Массивы

Чисел: [1, 2, 3, 4, 5]

Строк: ["one", "two", "three"]

Массивов: [["one", "two", "three"], ["cat", "dog", "bird"], ["green", "blue", "red"]]

[1, 2, 3, 4, 5]

["one", "two", "three"]

[['one', 'two', 'three'], ['cat', 'dog', 'bird'], ['green', 'blue', 'red']]

Через точку (.) происходит обращение к элементам массивов;

Обращение к соответствующему номеру элемента массива происходит с помощью чисел. Нумерация элементов массива начинается с нуля, поэтому обращение к первому элементу массива обозначается как 0.

Примеры: {{ array.0 }}

Даты

Привести данные к формату даты возможно только с помощью фильтра string_to_time Пример: {{ "2000-06-15 18:50:47" | string_to_time("%Y-%m-%d %H:%M:%S") }} Подробнее:

Преобразование строки в дату

⁠

2000-06-15 18:50:47

Часовой пояс не хранится

There are no rows in this table

⁠

Зарезервированные методы объектов

Зарезервированные методы объектов

Метод

Доступность в Платформе

Смысл

Как использовать

Пример

items

Да

Возвращает пары "ключ-значение" словаря.

Результат: [('a', 1), ('b', 2)]

keys

Да

Возвращает ключи словаря

Результат: ['a', 'b']

values

Да

Возвращает значения словаря

Результат: [1, 2]

clear

Нет

copy

Нет

fromkeys

Нет

get

Нет

pop

Нет

popitem

Нет

setdefault

Нет

update

Нет

There are no rows in this table

⁠

Важно: при парсинге
@Входящий запрос⁠
, ответа на
@Внешний запрос⁠
или на
@Notification⁠
обращение к ключу объекта, если его имя совпадает с именем
Зарезервированные методы объектов⁠
происходит через квадратные скобки и кавычки. Пример: {{ data["keys"] }}

Выражения

Литералы

Литералы

Оператор

Тип

Обозначение

Область применения

Как использовать

Пример

Строка

Литералы

"string"

Объявление строки

Объявление пустой строки

Объявление строки

Пустая строка

{{ '' }} или {{ "" }}

Непустая строка

{{ 'str' }} или {{ "str" }}

Обращение к символам строки

str == {{ 'string' }}

{{ str[0] }} = s

{{ str[1] }} = t

...

Срез строки

str == {{ 'string' }}

{{ str[:2] }} = st

{{ str[2:] }} = ring

{{ str[2:5] }} = rin

Результат: Hello World.

Результат: e.

Результат: Hello.

Результат: World.

Целое число

Литералы

123_456

Объявление целого числа

Результат: 123.

Число с точкой

Литералы

42.23

42.1e2

123_456.789

Объявление вещественного числа

Результат: 42.23.

Результат: 4210.0.

Результат: 42.23.

Списки

Литералы

['list', 'of', 'objects']

Объявление списка с произвольными типами объектов

Обращение к элементу из списка

Объявление списка

Пустой список

Список чисел

Список строк

Обращение к элементам списка

list = {{ [A, B, ...] }}

{{ list[0] }} = A

{{ list[1] }} = B

...

Результат: [1, 2, 3].

Результат: ['one', 'two'].

{{ ['one', 'two'] }}[0]

Результат: one.

Словари

Литералы

{'dict': 'of', 'key': 'and', 'value': 'pairs'}

Объявление словаря

Обращение к элементу из словаря

Объявление словаря

{{ { key1:val1, key2:val2, ... } }}

Обращение к элементам словаря

dict = {{ { key1:val1, key2:val2, ... } }}

{{ dict[key1] }} = val1

{{ dict[key2] }} = val2

...

{{ {1:'A', 2:'B', 3:'C'} }}

Результат: {1: 'A', 2: 'B', 3: 'C'}.

{{ {1:'A', 2:'B', 3:'C'}[1] }}

Результат: A.

{{ {'one': 'A', 'two': 'B', 'three': 'C'} }}

Результат: {'one': 'A', 'two': 'B', 'three': 'C'}.

{{ {'one': 'A', 'two': 'B', 'three': 'C'}['three'] }}

Результат: C.

Массивы

Литералы

{{ [{'id': 3, 'name': 'O'}, {'id': 1, 'name': 'E'}, {'id': 2, 'name': 'S'}] }}

Объявление массива данных

Обращение к элементу из массива

Объявление массива

{{ [{'id': id1, 'value': val1 }, {'id': id2, 'value': val2 }, ...] }}

Обращение к элементам массива

array = {{ [{'id': id1, 'value': val1 }, {'id': id2, 'value': val2 }, ...] }}

{{ array[0] }} = {'id': id1, 'value': val1 }

...

{{ [{'id': 3, 'name': 'O'}, {'id': 1, 'name': 'E'}, {'id': 2, 'name': 'S'}] }}

Результат: [{'id': 3, 'name': 'O'}, {'id': 1, 'name': 'E'}, {'id': 2, 'name': 'S'}].

{{ [{'id': 3, 'name': 'O'}, {'id': 1, 'name': 'E'}, {'id': 2, 'name': 'S'}] [0] }}

Результат: {'id': 3, 'name': 'O'}.

Булевы значения

Литералы

true

false

Выражения и булевы переменные

Результат: True, если булева переменная A истинна.

Результат: True, если выражение (A == B) истинно.

There are no rows in this table

⁠

Математические операции

Математические операции

Оператор

Тип

Обозначение

Область применения

Как использовать

Пример

Сложение

Математические выражения

Сложение целых и вещественных чисел

Конкатенация строк

Объединение элементов массивов в один массив

Результат: 6.

Результат: abc.

Результат: 2.0.

Результат: [0, 1, 2, 3, 4, 5].

Вычитание

Математические выражения

Вычитание целых и вещественных чисел

Результат: 1.

Результат: -1.0.

Деление

Математические выражения

Деление целых и вещественных чисел

Результат: 0.5.

Результат: -3.0.

Результат: 1.0.

Деление, при котором будет возвращена только целая часть результата

Математические выражения

Деление целых и вещественных чисел

Ограничения:

Оператор // возвращает целое число только при делении целых чисел. Если одним из операндов является вещественное число, то результатом также будет вещественное число.

Результат: 1.

Результат: 3.0.

Вычисление остатка от деления

Математические выражения

Вычисление остатка от деления целых и вещественных чисел

Результат: 2.

Результат: 0.0.

Умножение

Математические выражения

Умножение целых и вещественных чисел

Результат: 0.75.

Результат: -24.

There are no rows in this table

⁠

Ограничения:

Максимальное число (по модулю), которое можно использовать в арифметических операциях — 4294967296 . Если использовать большие числа, то будет ошибка (в memory в переменную сохранится False, например).

Если складывать строки / массивы, то максимально допустимая длина строки / массива — 1000 . При попытке сложения/конкатенации строк/массивов, дающих результат длиннее 1000 символов, в

@Контекстная переменная⁠

⁠

записывается значение “Addition of objects with length greater than 1000 is not allowed”.

Для конкатенации строк/массивов, дающих результат длиннее 1000 символов, можно использовать запись {{ string_1 }}{{ string_2 }}.

Операции сравнения

Операции сравнения

Оператор

Тип

Обозначение

Область применения

Как использовать

Пример

Проверка равенства

Операции сравнения

Любые контекстные переменные и значения

Результат: True, если переменная A равна переменной B.

Результат: True, если переменная A равна 1.

Результат: True, если переменная A равна 'один'.

Проверка неравенства

Операции сравнения

Любые контекстные переменные и значения

Результат: True, если переменная A не равна переменной B.

Результат: True, если переменная A не равна 1.

Результат: True, если переменная A не равна 'один'.

Проверка, что первый операнд больше второго

Операции сравнения

Числовые переменные и числа

Результат: True, если переменная A больше переменной B.

Результат: True, если переменная A больше 1.

Проверка, что первый операнд больше либо равен второго

Операции сравнения

Числовые переменные и числа

Результат: True, если переменная A больше или равна переменной B.

Результат: True, если переменная A больше или равна 1.

Проверка, что первый операнд меньше второго

Операции сравнения

Числовые переменные и числа

Результат: True, если переменная A меньше переменной B.

Результат: True, если переменная A меньше 1.

Проверка, что первый операнд меньше либо равен второго

Операции сравнения

Числовые переменные и числа

Результат: True, если переменная A меньше или равна переменной B.

Результат: True, если переменная A меньше или равна 1.

There are no rows in this table

⁠

Логические операции

Логические операции

Оператор

Тип

Обозначение

Область применения

Как использовать

Пример

“И”

Логические операции

and

Выражения и булевы переменные

Результат: True, если если обе булевы переменные A и B истинны.

"ИЛИ”

Логические операции

Выражения и булевы переменные

Результат: True, если если одна из булевых переменных A и B истинны.

"НЕ”

Логические операции

not

Выражения и булевы переменные

Результат: True, если если булева переменная A ложна.

Результат: False, если переменная A равна 1.

Скобки для группировки выражения

Логические операции

(expr)

Выражения и булевы переменные

Результат: True, если переменная A больше 0 и меньше 10.

There are no rows in this table

⁠

Другие операции

Другие операции

Оператор

Тип

Обозначение

Область применения

Как использовать

Пример

Поиск первого операнда во втором

Другие операции

Контекстные переменные и выражения

Строка

Список чисел

Список строк

Словарь

{{ key in { key1:val1, key2:val2, ... } }}

Результат: True.

{{ 1 in {1: 'A', 2: 'B', 3: 'C'} }}

Результат: True.

Проверка операнда на свойство

Другие операции

Тесты

Описано в таблице:

Проверки значений переменных

⁠

Применяет фильтр по отношению к операнду

Другие операции

Фильтры

Описано в таблице:

Фильтры синтаксиса

⁠

Приведение операндов к строкам и их конкатенация

Другие операции

Контекстные переменные и строки

Результат: Hello John! (если переменная name содержит значение John).

Получение артибута объекта

Другие операции

. / []

Любые контекстные переменные

Результат: A.

{{ {'one': 'A', 'two': 'B', 'three': 'C'}['two'] }}

Результат: B.

There are no rows in this table

⁠

Проверки значений переменных

Проверки значений переменных

Тест

Обозначение

Как использовать

Пример

Проверка, что переменная существует в контексте

defined

{{ A is defined }}, A существует

Результат: True.

{{ A is defined }}, A не существует

Результат: False.

Проверка, что переменная не существует в контексте

undefined

{{ A is undefined }}, A существует

Результат: False.

{{ A is undefined }}, A не существует

Результат: True.

Проверка на соответствие регулярному выражению

match

{{ A is match("[regular_expression]") }} Результат:

True, если A соответствует регулярному выражению;

False, если A НЕ соответствует регулярному выражению;

False, если A имеет не строковый формат;

False, если регулярное выражение прописано некорректно

Важно: проверка чувствительна к регистру.

Проверка, что объект является числом

number

Результат: True.

Результат: False.

Проверка, что объект является четным числом

even

Результат: True.

Результат: False.

Проверка, что объект является нечетным числом

odd

Результат: False.

Результат: True.

Проверка, что объект является целым числом

integer

Результат: True.

Результат: False.

Проверка, что объект является вещественным числом

float

Результат: True.

Результат: False.

Проверка, что объект делится нацело на число

divisibleby

Важно:

Если A = True, а B = 1, то вернется True, т.к True это 1, а 1 делится на 1.

Если A = False, то вернется True, т.к False это 0, а 0 делится на любое число (кроме 0).

Результат: True.

Результат: False.

Результат: True.

Проверка, что объект является строкой

string

Результат: True.

Результат: False.

Проверка, что строка находится в нижнем регистре

lower

Результат: True.

Результат: False.

Проверка, что строка находится в верхнем регистре

upper

Результат: True.

Результат: False.

Проверка, что объект является словарем

mapping

{{ {1:'A', 2:'B', 3:'C'} is mapping }}

Результат: True.

Результат: False.

Проверка, что объект является последовательностью (строкой, списком или словарем)

sequence

Результат: True.

{{ {1:'A', 2:'B', 3:'C'} is sequence }}

Результат: True.

Результат: False.

Проверка, что объект является булевым

boolean

{{ A is boolean }}, A = true

Результат: True.

{{ A is boolean }}, A = 4

Результат: False.

Проверка, что объект является истинным

true

{{ A is true }}, A = true

Результат: True.

{{ A is true }}, A = 1

Результат: False.

Проверка, что объект является ложным

false

{{ A is false }}, A = false

Результат: True.

{{ A is false }}, A = 2

Результат: False.

Проверка, что у объекта отсутствует значение (значение None или Null (преобразуется при парсинге ER в None))

none

{{ A is none }}, A = none

Результат: True.

{{ A is none }}, A = ''

Результат: False.

Проверка равенства (эквивалентно оператору ==)

Результат: True.

Результат: False.

Проверка неравенства (эквивалентно оператору !=)

Результат: True.

Результат: False.

Проверка, что первый операнд больше второго (эквивалентно оператору >)

Результат: True.

Результат: False.

Результат: True.

Результат: False.

Проверка, что первый операнд больше либо равен второго (эквивалентно оператору >=)

Результат: True.

Результат: False.

Проверка, что первый операнд меньше второго (эквивалентно оператору <)

Результат: True.

Результат: False.

Проверка, что первый операнд меньше либо равен второго (эквивалентно оператору <=)

Результат: True.

Результат: False.

Поиск первого операнда во втором

Описано в таблице:

Поиск первого операнда во втором

⁠

There are no rows in this table

⁠

Фильтры синтаксиса

Фильтры синтаксиса

Фильтр

Обозначение

Как использовать

Пример

Добавление дефолтного значения

default

Значение B будет использоваться только в случае, если переменной A нет в контексте.

Значение B будет использоваться в случаях, если переменной A нет в контексте или если значение переменной A приводится к False (0, пустая строка, пустой массив, пустой список).

{{ A|default('A is not defined') }}, A = 1

Результат: 1.

{{ A|default('A is not defined') }}, A не существует

Результат: A is not defined.

{{ A|default('A is empty', true) }}, A = ''

Результат: A is empty.

{{ A|default('A is not defined', true) }},

A не существует

Результат: A is not defined.

Преобразование в целое число

int

Результат: 2.

Результат: -15.

Результат: 0.

Преобразование в вещественное число

float

Результат: 2.0.

Результат: -122.0.

Результат: 0.0.

Возвращение абсолютного значения числа

abs

Ограничения: работает только с целыми и вещественными числами.

Результат: 1.

Результат: 0.1111.

Округление числа

round

Округление до целой части.

B - число знаков после запятой.

C - тип округления:

common - округление в большую или меньшую сторону.

ceil - округление в большую сторону.

floor - округление в меньшую сторону.

Результат: 42.0.

Результат: -1.539.

Результат: 0.58.

Результат: 121.673.

Результат: 0.

Преобразование в строку

string

Результат: 12345.

Результат: [1, 2, 3, 4, 5] (весь список является строкой).

{{ {1: 'A', 2: 'B', 3: 'C'}|string }}

Результат: {1: 'A', 2: 'B', 3: 'C'} (весь словарь является строкой).

Преобразование в список

list

Результат: ['a', 'b', 'c', 'd', 'e', 'f', 'g'].

{{ {'one': 'A', 'two': 'B', 'three': 'C'}|list }}

Результат: ['one', 'two', 'three'].

Результат: False.

Преобразование в нижний регистр

lower

Результат: abcdefg.

Результат: ['a', 'b', 'c'].

{{ {'one': 'A', 'two': 'B', 'three': 'C'}|lower }}

Результат: {'one': 'a', 'two': 'b', 'three': 'c'}.

Преобразование в верхний регистр

upper

Результат: ABCDEFG.

Результат: ['A', 'B', 'C'].

{{ {'one': 'a', 'two': 'b', 'three': 'c'}|upper }}

Результат: {'ONE': 'A', 'TWO': 'B', 'THREE': 'C'}.

Приведение первой буквы в строке к верхнему регистру

capitalize

Ограничения: работает только со строками.

Результат: Abc.

Преобразование в заглавный регистр (т.е. слова будут начинаться с прописных букв, все остальные символы будут строчными)

title

Важно: элементы списка и словаря приводятся к нижнему регистру.

Результат: Hello.

{{ {'one': 'A', 'two': 'B', 'three': 'C'}|title }}

Результат: {'one': 'a', 'two': 'b', 'three': 'c'}.

Первый элемент последовательности (строки, списка или словаря)

first

Результат: 1.

{{ {1:'A', 2:'B', 3:'C'}|first }}

Результат: 1.

Результат: False.

Последний элемент последовательности (строки, списка или словаря)

last

Результат: 5.

Результат: 3.

{{ {1:'A', 2:'B', 3:'C'}|last }}

Результат: 3.

Результат: False.

Число элементов в последовательности (строке, списке или словаре)

length

Результат: 7.

Результат: 3.

{{ {1:'A'}|length }}

Результат: 1.

Результат: False.

Сумма элементов последовательности

sum

Важно: если последовательность пустая, то возвращается 0.

Результат: 15.

{{ {1: 'A', 2: 'B', 3: 'C'}|sum }}

Результат: 6.

Результат: 0.

Получение наименьшего значения элемента последовательности

min

Результат: -1.

Результат: a.

{{ {'1': 'A', '2': 'B', '3': 'C'}|min }}

Результат: 1.

Получение наибольшего значения элемента последовательности

max

Результат: 1.

Результат: f.

{{ {'1': 'A', '2': 'B', '3': 'C'}|max }}

Результат: 3.

Получение случайного элемента

random

Ограничения: работает только со списками и массивами.

Результат: 4.110263.

Результат: -22.

Результат: banana.

Замена элемента последовательности

replace

Результат: Goodbye World.

Результат: ['D', 'B', 'C'].

Переворачивание последовательности

reverse

Важно: чтобы перевернуть список или словарь, нужно добавить |list для преобразования результата в список, иначе переменная будет пустой.

Результат: gfedcba.

Результат: 54321.

Результат: ['c', 'b', 'a'].

{{ {'1': 'A', '2': 'B', '3': 'C'}|reverse|list }}

Результат: ['3', '2', '1'].

Добавление разделителя элементов последовательности (строки, списка или словаря)

join

Результат: (1, 2, 3).

Результат: 123.

{{ {'one': 'A', 'two': 'B', 'three': 'C'}|join('!') }}

Результат: one!two!three.

{{ {1:'A', 2:'B', 3:'C'}.values()|join(", ") }}

Результат: A, B, C.

{{ {1:'A', 2:'B', 3:'C'}.keys()|join("!")|list }}

Результат: ['1', '!', '2', '!', '3'].

Преобразование последовательности в уникальный список

unique

Ограничения: работает только с добавлением |list.

Результат: gfedcba.

Результат: 54321.

Результат: ['c', 'b', 'a'].

{{ {'1': 'A', '2': 'B', '3': 'C'}|reverse|list }}

Результат: ['3', '2', '1'].

Сортировка последовательности

sort

r(reverse) - сортировка по убыванию, а не по возрастанию.

c(case_sensitive) - сортировка верхнего и нижнего регистров отдельно.

a(attribute) - значение или ключ для сортировки.

Результат: [1, 2, 3, 4, 5].

Результат: ['c', 'b', 'a'].

{{ [{'id': 3, 'name': 'O'}, {'id': 1, 'name': 'E'}, {'id': 2, 'name': 'S'}]|sort(attribute='name') }}

Результат: [{'id': 1, 'name': 'E'}, {'id': 3, 'name': 'O'}, {'id': 2, 'name': 'S'}].

{{ {4: 'c', 2: 'a', 3: 'b', 1:'d'}.values()|sort }}

Результат: ['a', 'b', 'c', 'd'].

{{ {4: 'c', 2: 'a', 3: 'b', 1:'d'}.keys()|sort }}

Результат: [1, 2, 3, 4].

Сортировка словаря по ключу или значению

dictsort

Важно: словарь по умолчанию превращается в строку.

{% for key, value in {"c": 1, "a": 4, "b": 2, "d": 3}|dictsort %} {{ key }}: {{ value }} {% endfor %}

Результат: aaa: 4 b: 2 c: 1 d: 3.

{% for key, value in {"c": 1, "a": 4, "b": 2, "d": 3}|dictsort(by="key") %} {{ key }}: {{ value }} {% endfor %}

Результат: a: 4 b: 2 c: 1 d: 3.

{{ {4: 'c', 2: 'a', 3: 'b', 1:'d'}|dictsort(by='value')|list }}

Результат: [(2, 'a'), (3, 'b'), (4, 'c'), (1, 'd')].

Фильтрация по атрибуту

map

Важно: если объект является массивом, то результат необходимо преобразовать в список.

{{ [{'name': 'Anna', 'number': '123'}, {'name': 'Olga', 'number': '456'}, {'name': 'Evgeniya', 'number': '789'}]| map(attribute='name')|list }}

Результат: ['Anna', 'Olga', 'Evgeniya'].

Группировка по числу элементов в цикле

batch

l(linecount) - число групп, на которые будет разбит объект.

f(fill_with) - значение, которое используется для заполнения отсутсвующих элементов.

{% for row in ['A','B','C']|batch(5, 'D') %}{{ row }}{% endfor %}

Результат: ['A', 'B', 'C', 'D', 'D'].

{% for row in [1, 2, 3, 4]|batch(2) %}

{% for i in row %}{{ i }}{% endfor %}

{% endfor %}

Результат:

34.

Преобразование в список списков

slice

s(slices) - число списков, на которые будет разбит объект.

f(fill_with) - значение, которое используется для заполнения отсутсвующих элементов.

Результат: [[1, 2, 3], [4, 5]].

Результат: [['a'], ['b'], ['c'], ['d'], ['d']].

Группировка по атрибуту

groupby

a(attribute) - атрибут.

d(default) - значение по умолчанию, использующееся, если объект в списке не имеет данного атрибута.

items = [ {"name": "james", "type": "green"}, {"name": "john", "type": "blue"}, {"name": "jim", "type": "blue"}, {"name": "jessie", "type": "green"} ]

{% for type, items in items|groupby('type') %}

{{ type }}:

{% for item in items %}{{ item.name }} {% endfor %}

{% endfor %}

Результат: blue: john jim green: james jessie.

Удаление элементов последовательности, которые не соответствуют тесту

select

B - тест из таблицы

Проверки значений переменных

⁠

C - аргумент, который передается в тест B.

Результат: [1, 3, 5] (нечетные числа).

Результат: [4, 5] (числа, которые больше 3).

Удаление элементов последовательности, которые не соответствуют тесту по атрибуту

selectattr

B - атрибут, который необходимо достать из последовательности.

C - тест из таблицы

Проверки значений переменных

⁠

D - аргумент, который передается в тест С.

users = [ {"name": "james", "email": "james@james.com", "password": "123"}, {"name": "john", "email": "john@john.com"}, {"name": "jim", "email": "jim@jim.com"}, {"name": "jessie", "email": "jessie@jessie.com", "password": "123"} ] .

{{ users|selectattr('password','undefined')| map(attribute='email')|list }}{{ email }}

Результат: ['john@john.com', 'jim@jim.com'].

table = [['685697115', 'evpolyntseva', 'Новосибирск'], ['658795243', 'Iourigaha', 'Москва'], ['683128920', 'jarondara', 'Казань'], ['630685929', 'blarar', 'Москва']] .

{{ table_all|selectattr(2, 'eq', "Москва")|map(attribute=1)|list }}

Результат: ['Iourigaha', 'blarar'].

Удаление элементов последовательности, которые соответствуют тесту

reject

B - тест из таблицы

Проверки значений переменных

⁠

C - аргумент, который передается в тест B.

Результат: [2, 4] (не нечетные числа).

Результат: [1, 2, 3] (числа, которые не больше 3).

Удаление элементов последовательности, которые соответствуют тесту по атрибуту

rejectattr

B - атрибут, который необходимо достать из последовательности.

C - тест из таблицы

Проверки значений переменных

⁠

D - аргумент, который передается в тест С.

table = [['685697115', 'evpolyntseva', 'Новосибирск'], ['658795243', 'Iourigaha', 'Москва'], ['683128920', 'jarondara', 'Казань'], ['630685929', 'blarar', 'Москва']] .

Результат: ['evpolyntseva', 'jarondara'].

Удаление символов в начале и конце строки

trim

c(chars) - символ или строка, которые будут удалены. По умолчанию пробел.

Результат: a.

Результат: c.

Усечение строки

truncate

len(length) - длина урезанной строки. По умолчанию 255.

k(killwords) - True или False. True указывается если нужно обрезать строку по длине, False если нужно отбросить последнее обрезаемое слово.

e(end) - знак на месте усечения. По умолчанию многоточие.

l(leeway) - предел превышения длины.

Результат: foo... .

Результат: foo ba... .

Результат: foo bar.

Подсчет слов

wordcount

Результат: 2.

Результат: 5.

{{ {'one': 'a', 'two': 'b b b', 'three': 'c'}|wordcount }}

Результат: 8.

Форматирование числа в размер файла

filesizeformat

Результат: 100.0 kB.

Результат: 25.0 MB.

Кодирование в URL

urlencode

Важно: работает только со строками и словарями.

Результат: %D0%BF%D1%80%D0%B8%D0%B2%D0%B5%D1%82.

{{ {"aaa": "привет", "bbb": 1}|urlencode }}

Результат: aaa=%D0%BF%D1%80%D0%B8%D0%B2%D0%B5%D1%82&bbb=1.

Преобразование строки в дату

string_to_time

{{ "2000-06-15 18:50:47" | string_to_time("%Y-%m-%d %H:%M:%S") }} После string_to_time в скобках указывается необходимый формат даты. Подробнее:

https://docs.python.org/3/library/datetime.html?highlight=datetime#strftime-and-strptime-format-codes

⁠

{{ "2000-06-15 18:50:47" | string_to_time("%Y-%m-%d %H:%M:%S") }} Результат: 2000-06-15 18:50:47 (тип данных — дата)

Преобразование даты в строку

time_to_string

{{ "2000-06-15 18:50:47" | time_to_string("%Y-%m-%d %H:%M:%S") }} После time_to_string в скобках указывается необходимый формат даты. Подробнее:

https://docs.python.org/3/library/datetime.html?highlight=datetime#strftime-and-strptime-format-codes

⁠

{{ "2000-06-15 18:50:47" | time_to_string("%Y-%m-%d %H:%M:%S") }} Результат: 2000-06-15 18:50:47 (тип данных — строка)

There are no rows in this table

⁠

Выражения с управляющими конструкциями

For

For

Оператор

Тип

Обозначение

Область применения

Как использовать

Пример

Пройти циклом по каждому элементу последовательности

For

for, in, endfor

Любые контекстные переменные

{% for A in B %}{{ ... }}{% endfor %}

Важно: цикл может быть максимум двойной вложенности.

Внутри циклов можно использовать дополнительные переменные для проверки значений:

Проверки значений переменных внутри For-циклов

⁠

{% for number in [1, 2, 3] %}{{ number }}{% endfor %}

Результат: 123.

There are no rows in this table

⁠

Проверки значений переменных внутри For-циклов

Проверки значений переменных внутри For-циклов

Переменная

Обозначение

Как использовать

Пример

Номер итерации с начала цикла (1 проиндексирована)

loop.index

{% for i in [{'name': 'Молоко', 'quantity': '1'}, {'name': 'Яблоки', 'quantity': '4'}, {'name': 'Печенье', 'quantity': '1'}] %}{{ loop.index }}{{ ') ' }}{{ i.name }} {{ i.quantity }}

{% endfor %}

Результат:

1) Молоко 1

2) Яблоки 4

3) Печенье 1

Номер итерации с начала цикла (0 проиндексирован)

loop.index0

{% for i in ['A','B','C'] %}{{ loop.index0 }}{{ ': ' }}{{ i }}

{% endfor %}

Результат:

0: A

1: B

2: C.

Номер итерации с конца цикла (1 проиндексирована)

loop.revindex

dict = {{ {'one': 'A', 'two': 'B', 'three': 'C'} }}

{% for i in dict %}{{ loop.revindex }}{{ ': ' }}{{ i }}{{ ' is ' }}{{ dict[i] }}

{% endfor %}

Результат:

3: one is A

2: two is B

1: three is C.

Номер итерации с конца цикла (0 проиндексирован)

loop.revindex0

{% for i in ['apple','orange','cherry'] %}{{ loop.revindex0 }}{{ ' | ' }}{{ i }}

{% endfor %}

Результат:

2 | apple

1 | orange

0 | cherry.

Истина, если первая итерация

loop.first

{% for i in ['a','b','c','d','e'] %}{% if loop.first == true %}{{ i }}{{ ' is first' }}{% endif %}{% endfor %}

Результат: a is first.

Истина, если последняя итерация

loop.last

{% for i in ['a','b','c','d','e'] %}{% if loop.last == true %}{{ i }}{{ ' is last' }}{% endif %}{% endfor %}

Результат: e is last.

Количество элементов в последовательности

loop.length

{% for i in ['a','b','c','d','e'] %}{% if loop.last == true %}{{ 'длина: '}}{{ loop.length }}{% endif %}{% endfor %}

Результат: длина: 5.

Циклическое перемещение внутри объекта

loop.cycle

dict = {{ {'one': 'A', 'two': 'B', 'three': 'C'} }}

{% for i in dict %}{{ loop.cycle }}{{ dict[i] }}{% endfor %}

Результат: >A>B>C.

Глубина рекурсивного цикла (начиная с уровня 1)

loop.depth

{% for i in [1,2,3] %}{% if loop.last == true %}{{ 'глубина: '}}{{ loop.depth }}{% endif %}{% endfor %}

Результат: глубина: 1.

Глубина рекурсивного цикла (начиная с уровня 0)

loop.depth0

{% for i in [1,2,3] %}{% if loop.last == true %}{{ 'глубина: '}}{{ loop.depth0 }}{% endif %}{% endfor %}

Результат: глубина: 0.

Получение значения из предыдущей интерации цикла

loop.previtem

Важно: элемент не определен, если итерация является первой.

{% for i in [1,2,3] %}{% if loop.first == false %}{{ 'предыдущий элемент: '}}{{ loop.previtem }}

{% endif %}{% endfor %}

Результат:

предыдущий элемент: 1

предыдущий элемент: 2.

Получение значения из следующей интерации цикла

loop.nextitem

Важно: элемент не определен, если итерация является последней.

{% for i in [1,2,3] %}{% if loop.last == false %}{{ 'следующий элемент: '}}{{ loop.nextitem }}

{% endif %}{% endfor %}

Результат:

следующий элемент: 2

следующий элемент: 3.

Проверка изменялось ли значение переменной

loop.changed(val)

mass = [{'k': 3, 'v': 2}, {'k': 2, 'v': 3}, {'k': 2, 'v': 2}]

{% for row in mass %}{% if loop.changed(row.k) == true %}

{{ row.k }}{% endif %}{% endfor %}

Результат:

There are no rows in this table

⁠

If

Оператор

Тип

Обозначение

Область применения

Как использовать

Пример

Условные конструкции

if-выражения

if, elif, else

Любые контекстные переменные

Простые условные конструкции, например, для слота Memory:

{{ <do something> if <something is true> else <do something else> }}

Могут использоваться elif и else.

Часть с else необязательна: при ее отсутствии, если условие if <something is true> не выполняется, результатом станет ‘False’.

Результат: ‘42’, если переменная client_message содержит значение "Привет";

‘111’, если переменная client_message содержит любое другое значение.

Результат: ‘42’, если переменная client_message содержит значение "Привет";

‘False’, если переменная client_message содержит любое другое значение.

There are no rows in this table

⁠

Filters

Filters

Оператор

Тип

Обозначение

Область применения

Как использовать

Пример

Применяет фильтр по отношению к блоку данных шаблона

Filters

filter, endfilter

Любые контекстные переменные

Аналогично

@выражениям с использованием фильтров

⁠

, только для более больших условий

{% filter <фильтр> %}

TEXT

{% endfilter %}

Фильтры:

Фильтры синтаксиса

⁠

{% filter upper %}

This text becomes uppercase

{% endfilter %}

Результат: THIS TEXT BECOMES UPPERCASE.

There are no rows in this table

⁠

Assignments

Assignments

Оператор

Тип

Обозначение

Область применения

Как использовать

Пример

Присваивает значение операнду

Assignments

set

Любые контекстные переменные

{% set A = B%}

{% set x = 'apples' if age is even else 'oranges' %}{{ x }}

Результат: ‘apples’, если переменная age содержит четное число.

‘oranges’, если переменная age содержит нечетное число.

There are no rows in this table

⁠

Ошибки при рендеринге Шаблонов

При

@Обучение⁠

@Агент⁠

а в процессе

@Валидация сценария⁠

проверяется правильность используемых в

@Слот⁠

ах

@Выражение⁠

@Выражение с управляющей конструкцией⁠

. При обнаружении ошибок появится предупреждение:

⁠

Формат текста предупреждения:

Invalid template syntax:

Slot <id проблемного слота>. Error “<описание ошибки>” in expression “<проблемное выражение>”

Пример:

Invalid template syntax:

Slot 8848840. Error “unexpected char '@' at 3” in expression “{{ @foo }}”

Расшифровка ошибки: в

@Слот⁠

е 8848840 обнаружена ошибка — лишний символ '@' с порядковым номером 3 в выражении {{ @foo }}.

Важно: отсчет порядковых номеров символов в проблемном выражении начинается с 0.

Общая информация о синтаксисе

Поддерживаемые типы данных

Зарезервированные методы объектов

Выражения

Литералы

Математические операции

Операции сравнения

Логические операции

Другие операции

Проверки значений переменных

Фильтры синтаксиса

Выражения с управляющими конструкциями

For

Проверки значений переменных внутри For-циклов

Filters

Assignments

Ошибки при рендеринге Шаблонов

Want to print your doc?
This is not the way.

Try clicking the ⋯ next to your doc name or using a keyboard shortcut (

CtrlP

) instead.