Actions в сценаріях — що це та як працюють

Actions (дії) — це потужний механізм розширення функціональності сценаріїв ботів у ConnectiveOne. Через actions можна виконувати складну бізнес-логіку, інтегруватися з зовнішніми системами, обробляти дані та керувати потоком виконання сценарію.

Що таке actions?

Actions — це JavaScript функції, які виконуються під час виконання сценарію ботом. Коли бот досягає ноди типу Action в сценарії, він викликає відповідну функцію, передає їй параметри та обробляє результат.

Типи actions

Стандартні actions

Стандартні actions — це вбудовані в платформу ConnectiveOne actions, які доступні всім ботам без додаткового налаштування.

Характеристики:

  • ✅ Доступні всім ботам на платформі
  • ✅ Версіонуються разом з Engine
  • ❌ Не редагуються через UI (тільки через код)
  • ✅ Стабільні та протестовані
  • ✅ Загальна кількість: 98 стандартних actions

Групи стандартних actions:

  • Core Actions (63) — основні дії: валідація, HTTP запити, умовна логіка, цикли, робота з даними
  • Language (2) — робота з мовами
  • Loop (2) — цикли
  • Schedule (1) — перевірка розкладу
  • Interval (4) — робота з інтервалами
  • Custom modules (4) — робота з кастомними модулями
  • Operator panel (4) — інтеграція з операторською панеллю
  • FastLine Pro (6) — інтеграція з AI-агентами
  • та інші групи

Приклади стандартних actions:

  • action_validate — валідація вводу користувача
  • action_send_request — відправка HTTP запитів до зовнішніх API
  • action_send_email — відправка email повідомлень
  • action_if_else / action_switch — умовна логіка та перемикачі
  • action_set — встановлення змінних в state сценарію
  • action_fastline_pro — інтеграція з AI-агентами FastLine Pro
  • action_tickets_create — створення тікетів

Документація стандартних actions:

Кастомні actions (ActionJail)

Кастомні actions — це actions, створені під конкретні задачі проекту через модуль ActionJail.

Характеристики:

  • ✅ Створюються та редагуються через UI модуля ActionJail
  • ✅ Специфічні для конкретного інстансу ConnectiveOne
  • ✅ Можуть використовувати стандартні actions всередині себе
  • ✅ Підтримують AI-генерацію коду, конфігурації та документації
  • ✅ Можуть бути організовані в групи для кращої навігації

Коли використовувати кастомні actions:

  • Потрібна специфічна бізнес-логіка, якої немає серед стандартних actions
  • Потрібна інтеграція з унікальними зовнішніми системами клієнта
  • Потрібна кастомна обробка даних під конкретні вимоги
  • Потрібно об'єднати кілька стандартних actions в одну дію

Документація кастомних actions:

Як працюють actions в сценаріях

Виконання action

  1. Бот досягає ноди типу Action в сценарії
  2. Система шукає action спочатку в стандартних, потім в ActionJail
  3. Виконується функція action в контексті KwizbotEngine
  4. Обробляється результат — action може повернути значення для умовних переходів

Керування потоком виконання

Actions можуть повертати значення, які використовуються для умовних переходів у сценарії:

  • Успішне виконання → перехід до наступної ноди
  • Помилка → перехід до ноди обробки помилок
  • Умовні значення → перехід залежно від результату (наприклад, if_else повертає true або false)

Параметри та конфігурація

Кожен action має свою конфігурацію:

  • Параметри — налаштування, які передаються в action
  • UI схема — форма для введення параметрів в редакторі сценарію
  • Значення за замовчуванням — дефолтні параметри

Використання в Scenario Dialog

В Scenario Dialog actions використовуються через ноди типу Action:

  1. Додавання ноди — додайте ноду типу Action на рабочее полотно (canvas) через React Flow toolbar
  2. Вибір action — виберіть стандартний або кастомний action в компоненті конфігурації
  3. Налаштування параметрів — заповніть параметри action через UI форму
  4. З'єднання з іншими нодами — з'єднайте action з іншими нодами через edges для керування потоком

Пов'язані матеріали