Налаштування AI-генератора в ActionJail (Адміністратор)

AI-генератор у редакторі дій ActionJail дозволяє швидко генерувати код, JSON-конфіг та документацію за допомогою LLM (без підключення агента). Для роботи потрібно налаштувати API-ключ (OpenAI-токен) для обраного процесу (бота).

Коли стане в пригоді

Потрібно використовувати кнопки «Швидка генерація», «Згенерувати з коду», «Згенерувати документацію» в редакторі дій.
AI-генерація не працює або показує помилку «Оберіть процес (бот) у бічній панелі».

Що важливо знати

Токен зберігається на рівні процесу (бота) — кожен бот може мати свій ключ.
Резервне джерело — якщо у бота немає ключа, використовується глобальний openai_token з Instance Settings.
Без агента — генерація йде напряму через ендпоінт POST /kw/fast_line/ai_text_editor/, без Instance Agent або MCP.

Перед початком

У вас є API-ключ OpenAI (або сумісного провайдера через Portkey).
Ви маєте права на налаштування процесу (бота) або налаштувань інстансу.
Обрано процес (бот) у бічній панелі Constructor — інакше AI-генерація покаже помилку.

Покрокова інструкція

Варіант 1: Токен для конкретного процесу (бота)

Відкрийте Fast Line (або інший модуль, де налаштовується OpenAI-токен для бота).
Оберіть потрібний процес (бот) у бічній панелі.
У розділі Import (або аналогічному) знайдіть блок «OpenAI Token» / «Add Token».
Введіть API-ключ і збережіть.
Після цього в ActionJail оберіть той самий процес у бічній панелі — AI-генерація працюватиме для цього бота.

Технічні деталі: Токен зберігається в kw_bots.custom_json.openai.token для обраного bot_id.

Варіант 2: Глобальний токен (Instance Settings)

Відкрийте Налаштування → Instance Settings (або еквівалент для вашого інстансу).
Знайдіть ключ openai_token.
Встановіть значення — API-ключ OpenAI.
Збережіть. Цей токен використовується, якщо у бота немає власного ключа.

Технічні деталі: Значення зберігається в kw_engine_settings з key = 'openai_token'.

Де видно групи та описи

Групи дій — у бібліотеці ActionJail у випадаючому списку «Оберіть action групу» (сайдбар зліва при відкритті дії).
Опис дії — у полі «Опишіть функціональність дії...» у секції «Інформація про дію»; використовується для підказок і довідників.
Опис параметра — у кожному параметрі в JSON-конфігу / UI-схемі; відображається як підказка біля поля в формі Scenario Builder.

Як переконатися, що все вдалось

У ActionJail обрано процес (бот) у бічній панелі.
Натискання «Швидка генерація» або «Згенерувати з коду» не показує помилку «Оберіть процес».
Генерація повертає результат (код, JSON або текст) замість помилки мережі або 422.

Усунення несправностей

Проблема	Рішення
«Оберіть процес (бот) у бічній панелі»	Оберіть бота в сайдбарі Constructor перед використанням AI-генерації.
422 / token data error	Перевірте, що токен збережено для обраного бота або в Instance Settings.
Генерація не відповідає	Перевірте, що використовується коректний API-ключ і провайдер (OpenAI/Portkey) підтримується.