Python

Если нужна разработка скрипта под вашу задачу - то обращайтесь к нам

Основная информация

Для использования Python Script необходимо приобрести подписку уровня Бизнес.

Вызов Python Script тарифицируется следующим образом

• 0.01 botcoin за вызов - при выключенном режиме отладки

• 0.05 botcoin за вызов - при включенном режиме отладки

Функция может выполнять Python-скрипты для различных задач, например: отправка запросов по REST API, чтение или запись в Google Таблицы и т.д.

Используется RestrictedPython, доступны только встроенные библиотеки. Подключение сторонних библиотек через import отключено.

Доступные возможности:

# Математика: abs, round, pow, sum, max, min, divmod, math (модуль)
# Типы данных: bool, int, float, str, chr, ord, bin, oct, hex
# Структуры: dict, list, tuple, set, frozenset, len, sorted, reversed, any, all
# Итерация: range, enumerate, zip, iter, next, filter, map
# Операторы присваивания: +=, -=, *=, /=, //=, %=, **=, <<=, >>=, &=, ^=, |=
# HTTP: requests.get(), requests.post(), requests.put(), requests.delete()
# JSON: json.loads(), json.dumps()
# Кодирование: base64 (модуль) - для кодирования/декодирования в base64
# Хеширование: hashlib (модуль) - для создания хешей (md5, sha1, sha256 и др.)
# Работа с CSV: csv (модуль) - для чтения/записи CSV файлов
# Структуры данных: collections (модуль) - Counter, defaultdict, deque и др.
# Функциональное программирование: itertools, functools (модули)
# Регулярные выражения: re (модуль)
# Дата и время: datetime (модуль), time (модуль), dateutil (модуль)
# Случайные числа: random (модуль)
# Статистика: statistics (модуль)
# URL обработка: urllib.parse (модуль)
# Логирование: debug() - для отладочных сообщений

Работа с аргументами

Параметры функции доступны в скрипте через словарь args.

Например, если у вас в функции есть переменная event_type, вы можете передать её значение в скрипт следующим образом:

event_type = args.get("event_type", "")

Пользовательские переменные в args

Если у агента созданы пользовательские переменные, они тоже передаются в Python Script.

Они доступны в словаре args по следующим путям:

# Пользовательские переменные агента в args["variables"]["agent"]:
# args["variables"]["agent"]["Unique_Agent_ID"] - ID Агента: Уникальный ID Агента (тип: string)

# Пользовательские переменные диалога в args["variables"]["dialog"]:
# args["variables"]["dialog"]["ClientName"] - Имя Клиента: Переменная для имени клиента (тип: string)
# args["variables"]["dialog"]["Order_ID"] - Номер заказа: Номер заказа (тип: number)

На практике удобнее сначала получить оба словаря, а потом обращаться к нужным ключам:

agent_vars = args.get("variables", {}).get("agent", {})
dialog_vars = args.get("variables", {}).get("dialog", {})

agent_id = agent_vars.get("Unique_Agent_ID", "")
client_name = dialog_vars.get("ClientName", "")
order_id = dialog_vars.get("Order_ID", 0)

Такой подход особенно удобен, если вы хотите передавать пользовательские переменные в Custom API, CRM или использовать их в собственной логике внутри скрипта.

Обязательная переменная result

В скрипте обязательно должна быть переменная result. Содержимое этой переменной будет доступно вашему ИИ-ассистенту. Пример:

result = {'status': 'success',
          'data': received_data # например массив с полученными данными
          }

В этом случае ИИ-ассистент получит результат выполнения функции и доступ к данным.

---

Тестирование кода

Вы можете протестировать код перед запуском. Если необходимо — включите режим отладки и нажмите "Сохранить".

В режиме отладки выводится больше логов. Всё, что обёрнуто в debug(), будет отображаться в журнале выполнения.

Тестирование кода также тарифицируется.

Чтобы протестировать код:

нажмите "Тестировать код" и прокрутите страницу вниз

1. Нажмите "Тестировать код"

1. Прокрутите страницу вниз

2. В разделе "Тестовые аргументы" укажите необходимые значения переменных функции

   
3. Нажмите "Запустить тест".

Результат с включенным режимом отладки

Результат без режима отладки