# Налаштування 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: Токен для конкретного процесу (бота)

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

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

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

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

**Технічні деталі:** Значення зберігається в `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) підтримується. |

---

## Пов'язані інструкції

- [Як створити й підтримувати дію](/uk/actionjail/how-to/admin-manage-actions.md)
- [Секції редактора дій](/uk/actionjail/explanation/action-editor-sections.md)
- [Actions Reference](/uk/actionjail/reference/actions-reference.md)