Як користуватися AI Помічником?

AI Помічник відкривається поверх поточної сторінки — ви не виходите з розділу, в якому працюєте, і одразу ставите питання в контексті цієї сторінки.

Коли знадобиться

Потрібна підказка, що робить поточний розділ або де знайти функцію.
Хочете швидко змінити налаштування описом словами (якщо дозволено вашою роллю).
Складна задача з кількох кроків — спочатку переглянути план, потім підтвердити.
Потрібна покрокова навігація в інтерфейсі — UI-тур.
Потрібна актуальна інформація з інтернету або дані з публічного сайту — якщо адмін увімкнув веб-пошук / читання URL (див. окремий гайд).

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

Кнопка помічника — іконка «іскра» у верхній панелі (якщо функцію увімкнено для інстансу та вашої ролі).
Заголовок панелі: «AI Помічник».
Історія чатів зберігається локально в браузері — на іншому пристрої або після очищення даних сайту розмови можуть зникнути.

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

Адміністратор увімкнув AI-помічник на інстансі.
У вашої ролі є доступ до модуля AI-асистент.

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

1. Відкрити AI Помічник

Натисніть кнопку з іконкою «іскра» у верхній панелі.
Зліва або справа відкриється панель «AI Помічник».
Якщо бачите порожній екран — текст «Чим можу допомогти?»; якщо вже спілкувалися — історія повідомлень.

Порада: панель можна закріпити зліва/справа або зробити плаваючим вікном — кнопки в заголовку панелі.

2. Обрати режим (за потреби)

Під полем вводу відкрийте список «Режим».
Оберіть:
- Запитати — тільки відповіді, без змін у системі;
- Агент — звичайна робота з діями;
- План — спочатку план, потім підтвердження.

3. Надіслати запит

Введіть питання або задачу в поле «Задайте питання про вашу платформу...».
За потреби прикріпіть файл (іконка скріпки), якщо тип файлу дозволений у налаштуваннях операторської панелі.
Натисніть кнопку відправки або Enter.

Під час обробки з’являється статус (наприклад, «Шукаю в документації…», «Генерую відповідь…»). Щоб зупинити генерацію — Стоп.

4. Обрати навичку агента (опційно)

У полі вводу наберіть /.
У списку навичок (Skills у інтерфейсі) знайдіть потрібну область (наприклад, налаштування, клієнти).
Оберіть навичку — з’явиться чіп з назвою.
Додайте текст запиту й надішліть.

Щоб прибрати навичку — натисніть × на чіпі (підказка в UI: «Прибрати skill»).

5. Пройти UI-тур (якщо запропоновано)

Коли помічник пропонує показати шлях в інтерфейсі, у чаті з’явиться картка з кнопками «Показати» та «Ні, дякую».
Натисніть «Показати» — на екрані з’являться покрокові підказки з підсвіткою.
Виконуйте кроки туру або закрийте його, якщо вже зрозуміло.

6. Підтвердити план (режим «План»)

Після запиту перегляньте блок «План виконання» — список кроків і рівень ризику.
Підтвердити — помічник виконує кроки.
Змінити — опишіть, що потрібно інше; з’явиться оновлений план.
Скасувати — жодних змін не буде.

7. Підтвердити зміну

Коли помічник у режимі Агент хоче змінити дані на інстансі, він не записує їх одразу — у чаті з’являється картка підтвердження.

Прочитайте картку: що саме змінюється.
Натисніть:
- «Лише цей раз» — записати цю зміну;
- «У цій розмові для таких дій» — записати й більше не питати про такі самі дії в цій розмові (кнопки немає для небезпечних змін, наприклад видалення);
- «Відхилити» — нічого не записувати.
Під карткою з’явиться результат: «Застосовано», «Відхилено» або «Не вдалося застосувати» (кнопки лишаються — можна спробувати ще раз).

Приклад: правка критерію AI QA. Попросіть: «У чек-листі 7 для критерію 11 заміни інструкцію для перевірки на «Оператор вітається і називає своє ім'я.»». Картка «Зміна критерію AI QA» показує:

шлях: Контроль якості → Чек-листи → «Демо QA» (#7) → критерій «Привітання» (#11) → Інструкція для перевірки;
«Що змінюється»: вилучене позначено −, додане — +, з частиною тексту навколо;
довжину тексту до і після (наприклад, «19 → 39 симв.»);
«Було» і «Стане» — повний текст, кнопки «Показати повністю» і «Копіювати»;
коли зміна почне діяти (наприклад, «Діє з наступної оцінки за цим чек-листом.»).

Для критеріїв і налаштувань AI QA є лише «Лише цей раз» і «Відхилити» — кожну правку підтверджують окремо. Таку картку бачить той, хто може зробити зміну: для критерію — з правом зберігати чек-листи, для налаштувань AI QA — лише root.

Так само працюють 8 налаштувань AI QA в Налаштування → Налаштування інстансу (наприклад, системний промпт чек-листа і таймаут перевірки зв'язку). Якщо значення ще не задано, у «Було» видно «не задано — діє типове: …». Значення поза допустимим діапазоном помічник не пропонує — він назве допустимі межі.

Якщо прав немає. Без права на зміну помічник картки не показує і нічого не записує — він відповідає текстом:

що планувалось змінити: шлях, «Було» і «Стане»;
якого права бракує: для критерію — зберігати чек-листи, для налаштувань AI QA — лише root;
як зробити вручну: Контроль якості → Чек-листи (критерій) або Налаштування → Налаштування інстансу (ключ, лише root).

Скопіюйте шлях і текст і передайте адміністратору. Так само помічник відповідає в режимі лише читання. Якщо право забрали вже після показу картки, запис не пройде: під карткою з’явиться «Немає права зберігати чек-листи…» (для налаштування — «Змінювати налаштування інстансу може лише root…»), а кнопки запису зникнуть.

Якщо картка показує «Значення змінилось після показу картки» або «Картка застаріла», нічого не записано — попросіть помічника підготувати правку заново.

8. Історія чатів

У заголовку панелі відкрийте «Історія чатів».
Новий чат — окрема тема розмови.
Перейменування або видалення — через меню біля назви чату.

Що відбувається після

Відповідь з’являється в чаті; за складних дій помічник може оновити сторінку, щоб ви побачили зміни.
Рекомендуємо перевіряти важливі результати — помічник спирається на документацію і може помилятися в складних кейсах.

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

Відповідь відповідає на запит і (за потреби) зміни видно в інтерфейсі після оновлення сторінки.
У режимі План зміни з’являються лише після Підтвердити.
Зміна з карткою підтвердження записана, лише коли під карткою видно «Застосовано».