Python

Официальный плагин Python добавляет в задачи тип шага Python. Шаг выполняет код на Python 3.12 или другой выбранной версии, берёт результаты прошлых шагов и возвращает строки, как любой другой шаг. pandas готов сразу, а добавить можно любой пакет из PyPI.

Плагину нужен QueryLane 1.4.0 или новее, он запрашивает Доступ к сети, Скачивание компонентов, Запуск программ и Файлы пользователя. Работает на Mac с Apple silicon и Intel и в Windows на x64 и Arm.

Установка плагина

1. Откройте Настройки > Плагины и установите Python. Подробнее в разделе Работа с плагинами.
2. Дождитесь, пока статус пройдёт Установка компонентов и Подготовка к работе. Плагин ставит Python 3.12 и pandas в папку плагина, поэтому устанавливать Python на компьютер не нужно.

Загрузки идут через прокси из Настройки > Обновления > Режим прокси.

Шаг на Python

1. В редакторе задачи добавьте шаг и выберите тип Python.
2. Напишите код. Это тело функции: то, что вы вернёте через return, становится строками шага.
3. Запустите шаг или задачу.

${step_<id>} даёт результат прошлого шага (для таблицы это список словарей) и делает этот шаг зависимостью, поэтому он выполняется раньше. ${name} даёт значение переменной задачи name. Ссылки в комментариях # остаются текстом. df(rows) превращает строки в DataFrame pandas.

import pandas as pd

orders = df(${step_orders})
orders["created_at"] = pd.to_datetime(orders["created_at"])
revenue = (
    orders.groupby(orders["created_at"].dt.to_period("M").astype(str))["amount"]
    .sum()
    .rename("revenue")
)
return revenue

Что возвращает шаг

• Список словарей становится таблицей, по словарю на строку.
• DataFrame становится строками по записям. Именованный индекс, например после groupby, становится столбцами.
• Словарь становится одной строкой, другие значения одним значением, а None — пустым результатом.
• Десятичные числа остаются точным текстом, даты и время становятся текстом ISO, NaN — пустым значением.

Вывод print() сохраняется вместе с запуском текстовым файлом. Файлы, которые код пишет в ARTIFACTS_DIR или в свою рабочую папку, и оставленные открытыми графики matplotlib тоже появляются в разделе Артефакты в истории запусков, а изображения показываются картинками. См. Запуски и артефакты.

Если код падает, шаг показывает ошибку и строку вашего кода, где она произошла.

Пакеты и версии Python

На странице плагина Версия Python выбирает Python для шагов, от 3.10 до 3.14, по умолчанию 3.12. Пакеты перечисляет их пакеты, по умолчанию pandas. Добавьте имя, например numpy, или закреплённую версию, например requests==2.32.3.

Чтобы части шагов дать другую версию или другие пакеты, создайте с ними пресет и выберите его в этих шагах в поле Пресет плагина. Подробнее в разделе Настройки и пресеты. У каждой версии и списка пакетов своё окружение: оно устанавливается при первом запуске через тот же прокси, что и плагин, а переключение между пресетами ничего не переустанавливает. Если окружений больше восьми, самые давно не использованные удаляются.

Как выполняются шаги

Каждый запуск открывает свой процесс Python, поэтому запуск не видит того, что оставил в памяти предыдущий. Шаг останавливается, когда выходит его лимит времени или вы останавливаете запуск, и процесс завершается вместе с ним.

Код выполняется на вашем компьютере с вашим доступом к файлам и сети, как шаг JavaScript. Агенты, подключённые через MCP, могут запускать шаги Python, только пока включено Агенты могут запускать код в Настройки > CLI и MCP. Ассистент умеет писать шаги на Python.