> For the complete documentation index, see [llms.txt](https://docs.jedidesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jedidesk.com/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1.md).

# Як налаштувати AI-асистентів #jedidesk

<figure><img src="/files/zYVPEJVB7JTuicRMOzcM" alt=""><figcaption></figcaption></figure>

## Як налаштувати AI-асистента JediDesk

Цей розділ проведе вас від нуля до повністю налаштованого AI-асистента. Кожен крок пояснює не тільки **що** робити, але й **чому** це важливо і **які помилки** найчастіше виникають.\
\
**Навігація:**\
\
[Крок 1. Вибір моделі поведінки](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-1.-vibir-modeli-povedinki)\
[Крок 2. Написання інструкції (промт)](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-2.-napisannya-instrukciyi-promt)\
[Крок 3. Три параметри якості відповідей](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-3.-tri-parametri-yakosti-vidpovidei)\
[Крок 4. Ліміти та робочий час](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-4.-limiti-ta-robochii-chas)\
[Крок 5. База знань](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-5.-baza-znan)\
[Крок 6. Стоп-слова та передача менеджеру](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-6.-stop-slova-ta-peredacha-menedzheru)\
[Крок 7. Додаткові налаштування](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#krok-7.-dodatkovi-nalashtuvannya)\
\
[Перевірка перед запуском: чеклист](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#perevirka-pered-zapuskom-cheklist)\
[Статистика та баланс](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#statistika-ta-balans)\
[Поширені проблеми та їх вирішення](https://app.gitbook.com/o/l4JC5IRyf6z3LewrMfQY/s/XkehX3Ue2D5LVuBJjMnb/~/edit/~/changes/478/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1#poshireni-problemi-ta-yikh-virishennya)

### Перш ніж починати: як це взагалі працює

Перш ніж переходити до налаштувань, корисно зрозуміти логіку роботи системи.

AI-асистент — це не просто чат-бот з готовими відповідями. Він читає **вашу базу знань, товарний фід** (файли з товарами, FAQ, умовами доставки тощо), отримує **інструкцію від вас** (як поводитись, що говорити, як продавати) і на основі цього відповідає клієнтам.

Схема проста:

```
Клієнт пише повідомлення
        ↓
AI шукає відповідь у ваших файлах (база знань та фід)
        ↓
AI формулює відповідь згідно з вашою інструкцією (промт)
        ↓
Клієнт отримує відповідь
```

Якщо щось із цього ланцюжка налаштовано погано — AI або відповідає неточно, або «вигадує» інформацію, або відповідає не в тому стилі. Саме тому важливо налаштувати кожен елемент правильно.

***

### Крок 1. Вибір моделі поведінки

#### Що це таке і навіщо

JediDesk пропонує 6 готових моделей поведінки — це попередньо написані інструкції для AI під різні типи бізнесу. Вибір правильної моделі економить час: замість написання інструкції з нуля ви отримуєте готовий шаблон, який залишається лише відкоригувати під себе.

<figure><img src="/files/gn20jExbg0lgAp6N4su8" alt=""><figcaption></figcaption></figure>

#### Огляд моделей

| Модель    | Підходить для              | Що вміє                                                     |
| --------- | -------------------------- | ----------------------------------------------------------- |
| **Lexi**  | Інтернет-магазини          | Консультує по товарах, порівнює позиції, підбирає комплекти |
| **Nova**  | Агенції                    | Збирає бриф від клієнта, передає менеджеру                  |
| **Bella** | Салони краси               | Консультує по послугах, допомагає з бронюванням             |
| **Luna**  | Instagram-магазини         | Консультує, оформляє замовлення до підтвердження            |
| **Max**   | Продажі (будь-який бізнес) | Виявляє потреби, консультує, закриває угоди 24/7            |
| **Zara**  | Підтримка клієнтів         | Відповідає на типові запитання, передає складне менеджеру   |

#### Як обрати правильну модель

Запитайте себе: **яке головне завдання AI у вашому бізнесі?**

* Якщо AI має **продавати** — Lexi, Luna або Max
* Якщо AI має **збирати інформацію** від клієнта і передавати менеджеру — Nova
* Якщо AI має **записувати на послуги** — Bella
* Якщо AI має **відповідати на питання** (доставка, повернення, гарантії) — Zara

> **Приклад.** У вас інтернет-магазин туристичного спорядження з 4 000 товарів. Клієнти постійно запитують: «А є цей намет у синьому кольорі?», «Що краще — ця куртка чи ота?». Підходить **Lexi** — вона вміє порівнювати товари та підбирати комплекти.

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

Після вибору моделі система автоматично підставляє готовий промт (інструкцію) у поле **Інструкція**. Це відправна точка, яку ви далі редагуєте під свій бізнес.<br>

<figure><img src="/files/PvKMw4T78SJlnfkJT1ze" alt=""><figcaption></figcaption></figure>

&#x20;**Не пропускайте редагування промту!** Готовий шаблон містить плейсхолдери типу `[Назва магазину]` або посилання на файли, яких ще немає. Якщо запустити AI без правок — він буде відповідати некоректно.<br>

<figure><img src="/files/SUaJtjS7JfGfGzSWHb4E" alt=""><figcaption></figcaption></figure>

***

### Крок 2. Написання інструкції (промт)

#### Що це таке і навіщо

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

**Без хорошої інструкції навіть ідеальна база знань не допоможе.** AI може мати всі дані про ваші товари, але відповідати холодно, не продавати, або давати інформацію безладно.

#### Що обов'язково має бути в інструкції

**1. Ім'я та роль**

Назвіть AI і скажіть, хто він.

```
Ти — Lexi, AI-асистент інтернет-магазину «Трек Про». 
Ти допомагаєш клієнтам обрати туристичне спорядження.
```

**2. Тон спілкування**

Опишіть, як саме спілкуватись.

```
Спілкуйся дружньо і по-діловому. Не використовуй складні технічні 
терміни без пояснень. Звертайся до клієнта на «Ви».
```

**3. З яких файлів брати інформацію**

Це критично важливий пункт. AI не знає автоматично, які файли ви завантажили і що в них. Йому потрібно сказати явно.

```
Дані про товари бери з файлу Products.json.
Дані про доставку та оплату бери з файлу FAQ.json.
Якщо інформації в файлах немає — так і скажи клієнту, 
не вигадуй відповідь.
```

{% hint style="danger" %} **Найпоширеніша помилка.** Якщо не вказати в інструкції, з яких файлів брати дані, AI може «вигадувати» відповіді з власної пам'яті. Наприклад, написати неіснуючу ціну або умову доставки. Завжди явно вказуйте джерело. {% endhint %}

**4. Етапи консультації**

Опишіть, як виглядає ідеальний діалог.

```
При консультації дотримуйся такої послідовності:
1. Привітайся і запитай, що шукає клієнт
2. Уточни деталі (для кого, який бюджет, які умови використання)
3. Запропонуй 2-3 варіанти з коротким порівнянням
4. Відповідай на уточнюючі запитання
5. Якщо клієнт готовий купити — надай посилання на товар
```

**5. Коли кликати менеджера**

```
Передай діалог менеджеру якщо:
- Клієнт скаржиться або незадоволений
- Запитує про повернення або гарантійний випадок
- Хоче індивідуальне замовлення або опт
- Питає про знижку більше 10%
```

#### Як покращити інструкцію якщо не знаєте з чого почати

Скористайтеся [ChatGPT Prompt Engineering](https://chatgpt.com/g/g-bNiLAvz8R-prompt-engineering). Опишіть свій бізнес і що має робити AI — інструмент допоможе скласти промт.

#### Мови бота

Виберіть мови, якими AI спілкуватиметься з клієнтами. Якщо у вас є клієнти з різних країн, можна додати кілька мов — AI автоматично визначить мову клієнта і відповість нею.<br>

<figure><img src="/files/z2ztbZSxN7Q1KizR5TCY" alt=""><figcaption></figcaption></figure>

***

### Крок 3. Три параметри якості відповідей

Це найважливіший технічний розділ. Три параметри визначають, наскільки точними і стабільними будуть відповіді AI.

<figure><img src="/files/VyM1m1oNjjlFroFYCfDF" alt=""><figcaption></figcaption></figure>

#### Параметр 1: Креативність (`temperature`)

**Що це:** Контролює, наскільки «передбачуваними» будуть відповіді AI. Значення від 0 до 1.

**Навіщо це потрібно:** Іноді потрібен стабільний, чіткий бот (підтримка клієнтів). Іноді — живий, варіативний (продажі, залучення). Цей параметр дозволяє знайти баланс.

| Значення    | Поведінка                                           | Підходить для               |
| ----------- | --------------------------------------------------- | --------------------------- |
| `0.10–0.30` | Відповіді однакові при кожному запиті, дуже точні   | Підтримка, FAQ, техдопомога |
| `0.40–0.60` | Невелика варіація формулювань, відповіді природніші | Універсально                |
| `0.70–1.00` | Щоразу різні формулювання, творчі відповіді         | Контент, креатив            |

> **Кейс.** Клієнт запитує: «Які у вас тарифи?»
>
> При `temperature: 0.10` — «Тариф Pro — 1 099 грн/міс, до 5 операторів. Тариф Business — 2 499 грн/міс, необмежена кількість операторів.» *(Стабільно. Завжди та сама відповідь.)*
>
> При `temperature: 0.90` — щоразу інше формулювання, можуть з'явитися «творчі» інтерпретації тарифів, яких немає в базі. *(Ризиковано для фактичної інформації.)*

**Рекомендація для більшості бізнесів:** `0.10–0.30`

***

#### Параметр 2: Сфокусованість (`top_p`)

**Що це:** Обмежує словниковий запас AI — залишає тільки найімовірніші слова при формуванні відповіді. Значення від 0 до 1.

**Навіщо це потрібно:** Впливає не на «сміливість» вибору, а на різноманітність словника. Низький `top_p` = короткі, прості, однорідні відповіді. Високий = живіша мова, більше синонімів.

> **Кейс.** Клієнт питає: «Як скасувати підписку?»
>
> При `top_p: 0.30` — AI відповідає найпростішими словами, чіткий алгоритм дій, без «зайвого».
>
> При `top_p: 0.95` — AI варіює формулювання, відповідь звучить природніше, але може бути трохи довшою.

**Рекомендація:** `0.90–0.95` — відповіді звучать природно, але залишаються адекватними.

***

#### Параметр 3: Поріг релевантності (`search_threshold`)

**Що це:** Фільтр для пошуку по базі знань. Кожен знайдений фрагмент отримує оцінку від 0 до 1 — наскільки він відповідає запиту. Поріг визначає мінімальну оцінку, при якій фрагмент передається AI.

**Навіщо це потрібно:** Щоб AI не отримував нерелевантні дані і не «галюцинував» на їх основі.

> **Кейс.** Клієнт запитує: «Які у вас тарифи?». Векторний пошук знаходить фрагмент у базі знань і повертає оцінку `0.84`.
>
> При `threshold: 0.00` → фрагмент передається AI → відповідь на основі реальних даних ✅
>
> При `threshold: 0.90` → `0.84 < 0.90` → фрагмент відсіюється → AI нічого не отримує → або мовчить, або вигадує ❌

&#x20;**Типова проблема з завищеним порогом.** Якщо виставити `threshold: 0.70`, фрагменти з оцінкою `0.65–0.69` будуть відкидатись — хоча вони містять потрібну інформацію. AI не скаже «я не знаю» — він почне відповідати з власної пам'яті і може вигадати неіснуючі ціни, умови або терміни доставки.&#x20;

**Рекомендація:** Починайте з `0.00` і підвищуйте тільки якщо AI стабільно отримує нерелевантні фрагменти. Для більшості бізнесів `0.00` — оптимальне значення, а фільтрацію краще контролювати через якість самих файлів.

***

#### Як ці три параметри взаємодіють між собою

Ці параметри не незалежні — вони підсилюють або нейтралізують один одного.

| Ситуація                              | `temperature` | `top_p` | `search_threshold` |
| ------------------------------------- | ------------- | ------- | ------------------ |
| Максимальна точність (підтримка, FAQ) | `0.10`        | `0.90`  | `0.00`             |
| Природні відповіді (продажі)          | `0.30`        | `0.95`  | `0.00`             |
| Творчий бот (контент, блог)           | `0.70`        | `0.95`  | `0.00`             |

> **Антиприклад.** `temperature: 0.10` + `top_p: 0.10` + `threshold: 0.80` = AI відповідає дуже сухо, однотипно і при цьому часто не знаходить інформацію в базі та галюцинує. Погана комбінація для будь-якого бізнесу.

***

### Крок 4. Ліміти та робочий час

#### Ліміт запитів на один діалог

<figure><img src="/files/uRXW5LrcZTA58U0GP7pu" alt=""><figcaption></figcaption></figure>

**Що це:** Максимальна кількість повідомлень AI в одному чаті з клієнтом.

**Навіщо:** Захист балансу від «нескінченних» розмов. Якщо клієнт веде безкінечний діалог або тестує бота — ліміт зупиняє зайві витрати.

> **Приклад.** Ви встановили ліміт 5 повідомлень. Якщо діалог затягнувся понад 5 обмінів — AI зупиняється, а менеджер може підключитись вручну.

**Рекомендація:** 15–30 повідомлень залежно від складності ваших консультацій.

***

#### Ліміт запитів на тиждень

<figure><img src="/files/fyFp3dNY0Ciy0XNlAyUW" alt=""><figcaption></figcaption></figure>

**Що це:** Максимальна кількість нових діалогів (унікальних чатів), які AI обробляє за тиждень.

**Навіщо:** Корисно на старті, коли ви ще не впевнені в якості відповідей і хочете контролювати масштаб.

> **Приклад.** Ви щойно налаштували AI і хочете спочатку перевірити якість на 100 діалогах на тиждень, перш ніж відкривати на весь трафік. Виставляєте ліміт 200 — і спокійно моніторите.

***

#### Робочі години

<figure><img src="/files/ZP8FXQuaG3xc5EI7As9y" alt=""><figcaption></figcaption></figure>

**Що це:** Налаштування, в які години AI активний.

**Навіщо:** AI може працювати цілодобово або тільки в неробочий час, поки менеджери не онлайн.

**Два корисних режими:**

* **Тільки в неробочі години** — вдень відповідають менеджери, вночі та у вихідні — AI
* **Цілодобово** — AI завжди активний, менеджери підключаються тільки якщо AI не впорався

> &#x20;**Критична помилка!** Не вмикайте одночасно «Автоматично включати в неробочі години» та «Автоматично виключати в робочі години» — ці налаштування суперечать одне одному і AI не буде працювати взагалі. Вмикайте **тільки одне** з них. <br>

***

#### Автоматично вимикати, коли до чату підключений менеджер

<figure><img src="/files/7PqS8pdagf2jSe73AAoU" alt=""><figcaption></figcaption></figure>

**Що це:** Якщо менеджер вручну відкриває чат і починає відповідати — AI автоматично замовкає.

**Навіщо:** Щоб AI і менеджер не відповідали одночасно — це виглядає хаотично для клієнта.

**Рекомендація:** Тримайте цю опцію **увімкненою** завжди.

***

### Крок 5. База знань

<figure><img src="/files/A1rfy3WlPxv033mv4qDt" alt=""><figcaption></figcaption></figure>

#### Що це таке і чому це найважливіша частина

База знань — це файли, з яких AI бере інформацію для відповідей. Якість бази знань напряму визначає якість відповідей. Навіть ідеальний промт і правильні параметри не врятують, якщо файли погано структуровані або містять неточності.

**Технічні обмеження:**

* До **50 файлів**
* Кожен файл — до **10 МБ**
* Рекомендований формат: **JSON**

#### Як підготувати файли правильно

**Файл з товарами** має містити чіткі, однозначні колонки:

| Артикул | Назва        | Опис                | Розмір/Вага | Ціна      | Посилання           |
| ------- | ------------ | ------------------- | ----------- | --------- | ------------------- |
| TRK-001 | Намет Trek 2 | Двомісний, 3 сезони | 2.8 кг      | 4 200 грн | shop.com/tent-trek2 |

> **Погано:** «Ціна договірна», «Уточнюйте в менеджера», порожні поля — AI не зможе дати чітку відповідь і або буде мовчати, або вигадає.

**Файл FAQ** (Поширені запитання) має охоплювати:

* Умови доставки (терміни, вартість, перевізники)
* Способи оплати
* Умови повернення та обміну
* Гарантійні умови
* Контакти

> **Приклад структури FAQ.json:**
>
> ```json
> [
>   {
>     "питання": "Яка вартість доставки?",
>     "відповідь": "Доставка Новою Поштою — 80 грн. При замовленні від 2 000 грн — безкоштовно."
>   },
>   {
>     "питання": "Чи можна повернути товар?",
>     "відповідь": "Так, протягом 14 днів з моменту отримання, якщо товар не був у використанні."
>   }
> ]
> ```

#### Конвертація файлів у JSON

Підготуйте таблицю в Excel або Google Sheets, потім конвертуйте у JSON через [Online XLSX to JSON Converter](https://products.aspose.app/cells/conversion/xlsx-to-json).

#### Типові помилки при підготовці файлів

**Помилка 1: Змішана інформація в одному файлі** Не кладіть товари, FAQ і контакти в один файл. AI важче орієнтуватись, а ви не можете оновлювати частину інформації окремо.

**Помилка 2: Скорочення без розшифровки** «Д-ка НП 2-3 д» замість «Доставка Новою Поштою 2-3 дні» — AI може неправильно інтерпретувати.

**Помилка 3: Не оновлювати файли при зміні цін або умов** AI відповідає на основі завантажених файлів. Якщо ви підняли ціни, але не оновили файл — бот буде називати старі ціни.

{% hint style="info" %} Після оновлення файлів у базі знань рекомендується натиснути **«Видалити історію ШІ-діалогів»** — щоб AI не спирався на старі відповіді з попередніх розмов. {% endhint %}

***

### Крок 6. Стоп-слова та передача менеджеру

#### Стоп-слова: що це і як працюють

Стоп-слова — це конкретні слова або фрази, при появі яких AI автоматично зупиняється і передає діалог менеджеру.

**Як це виглядає в чаті:** значок «AI» на діалозі стає **червоним** — це сигнал менеджеру, що потрібна його увага. Після прийняття діалогу позначка знімається.

> **Приклад стоп-слів для магазину:**
>
> * «повернення» — клієнт хоче повернути товар
> * «скарга» — незадоволений клієнт
> * «брак» — проблема з якістю
> * «опт» — оптове замовлення, яке потребує індивідуального підходу

**Обмеження стоп-слів:** вони спрацьовують тільки при **точному збігу** тексту. Якщо клієнт напише «хочу повернути», але у вас стоп-слово «повернення» — спрацювання може не відбутись.

***

#### Функція `stop_conversation`: розумна передача менеджеру

На відміну від стоп-слів, ця функція дозволяє AI **самостійно аналізувати контекст** і вирішувати, коли передавати діалог.

**Навіщо це потрібно:** Клієнт може бути незадоволений або в скрутній ситуації, але не написати жодного стоп-слова. Функція `stop_conversation` дозволяє AI «відчути» це і відреагувати.

**Як налаштувати:**

1. У полі **«Опис для ШІ»** опишіть ситуації, коли AI має передавати діалог:

   ```
   Передай діалог менеджеру якщо:
   - Клієнт виражає незадоволення або роздратування
   - Клієнт просить про послугу, якої немає в базі знань
   - Клієнт задав одне й те саме питання більше 2 разів і не отримав задовільної відповіді
   - Клієнт хоче поговорити з живою людиною
   ```
2. У полі **«Текст відповіді клієнту»** напишіть повідомлення, яке отримає клієнт при передачі:

   ```
   Зараз я передам ваш запит менеджеру. Він зв'яжеться з вами протягом декількох хвилин. Дякуємо за терпіння!
   ```

**Що відбувається при спрацюванні:**

1. AI зупиняється в цьому діалозі
2. Діалог призначається на менеджера
3. Менеджер отримує сповіщення
4. Клієнт отримує ваше повідомлення про очікування

**Системне повідомлення для менеджера** (видно тільки менеджеру, клієнт не бачить):

```
Тригер ШІ: функція зупинки — клієнт виражає незадоволення якістю товару
```

Це дозволяє менеджеру одразу зрозуміти ситуацію без перечитування всього діалогу.

***

### Крок 7. Додаткові налаштування

#### Можливість приєднати менеджера (кнопка для клієнта)

<figure><img src="/files/Dgoluwf5Du7SL8IftmBx" alt=""><figcaption></figcaption></figure>

За замовчуванням після **третьої відповіді AI** клієнт бачить кнопку «Покликати менеджера» в Telegram, Viber і Widget.

**Навіщо:** Клієнт може самостійно запросити живого оператора, не чекаючи поки AI «здогадається».

**Коли варто вимкнути:** Якщо AI у вас повністю автономний і ви не хочете, щоб клієнти переходили на менеджерів без вагомої причини.

***

#### Закритий AI-асистент

<figure><img src="/files/ME9SsNbHF8cngedGY9nd" alt=""><figcaption></figcaption></figure>

**Що це:** Бот відповідає **не всім**, а тільки тим користувачам, яким ви надали доступ.

**Коли це потрібно:**

* Внутрішній корпоративний бот (тільки для співробітників)
* Бот для VIP-клієнтів
* Тестовий режим: ви налаштовуєте AI і перевіряєте його на конкретних людях перед повним запуском

**Як надати доступ конкретному користувачу:**

1. Перейдіть у вкладку **«Користувачі»**
2. Знайдіть потрібного користувача → натисніть іконку олівця
3. Змініть **«Доступ до ШІ-асистента»** на **«Активний»**

***

#### Канали

<figure><img src="/files/6KE9zjmg43dODVLPhvSZ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/cBniIt4zK3B7WTHkAOSB" alt=""><figcaption></figcaption></figure>

**Що це:** Вибір конкретних каналів (Telegram, Viber, Instagram тощо), де AI буде активний.

**Навіщо:** Ви можете включити AI тільки в одному каналі для тестування, не зачіпаючи роботу менеджерів в інших каналах.

> **Приклад.** У вас є Telegram, Viber і Instagram. Ви хочете спочатку протестувати AI тільки в Telegram. Додаєте тільки Telegram у поле «Канали» — в Viber і Instagram AI не відповідає, менеджери працюють як звичайно.

Якщо поле залишити **порожнім** — AI активний у всіх підключених каналах.

***

#### Оновлення історії переписки

<figure><img src="/files/337MBcZ8cwYlwbIbcAh5" alt=""><figcaption></figcaption></figure>

AI запам'ятовує контекст розмови в межах одного діалогу — це допомагає відповідати на уточнюючі запитання без повторення.

**Проблема:** Після того як ви змінили промт, додали нові файли або відкоригували параметри — AI в активних діалогах може продовжувати спиратись на старі відповіді, ігноруючи нові дані.

**Рішення:**

* **Вручну** — кнопка **«Видалити історію ШІ-діалогів»** стирає всі попередні розмови. Після цього AI стартує в кожному діалозі «з чистого аркуша».
* **Автоматично** — увімкніть **«Очищати ШІ-історію чату після закриття бесіди»**. Кожен завершений діалог автоматично очищається — наступна розмова з цим клієнтом починається наново.

Рекомендуємо вмикати автоочищення за замовчуванням. Це гарантує, що AI завжди працює з актуальними даними і не «пам'ятає» застарілих відповідей.&#x20;

***

### Перевірка перед запуском: чеклист

Перш ніж запустити AI на реальних клієнтах, перевірте кожен пункт:<br>

* Обрана модель поведінки відповідає типу бізнесу
* &#x20;У промті вказано ім'я AI та його роль
* &#x20;У промті явно вказано, з яких файлів брати інформацію
* &#x20;Прописані етапи консультації та умови передачі менеджеру
* &#x20;Файли бази знань завантажені та містять актуальні дані
* &#x20;У файлах немає порожніх полів, скорочень без розшифровки
* &#x20;Назви файлів у промті точно співпадають з назвами завантажених файлів
* &#x20;`temperature` встановлено `0.10–0.30` для підтримки
* &#x20;`search_threshold` встановлено `0.00`
* Увімкнено «Автоматично вимикати, коли до чату підключений менеджер»
* &#x20;Налаштовані стоп-слова або функція `stop_conversation`
* &#x20;Перевірено, що не увімкнено одночасно два суперечливих налаштування робочих годин

***

### Статистика та баланс

#### Баланс

<figure><img src="/files/kbBu66UF41qB5EuFLK50" alt=""><figcaption></figcaption></figure>

Баланс — це кількість запитів, які може обробити AI. Кожне повідомлення від клієнта, на яке відповідає AI, витрачає певну кількість запитів.

**Де дивитись:** Розділ **JediDesk AI → Параметри**.

Баланс можна поповнювати в будь-який момент.

#### Статистика

<figure><img src="/files/iKFICnDLzYeFz0QmFBzB" alt=""><figcaption></figcaption></figure>

Дозволяє аналізувати активність AI за будь-який період: скільки діалогів обробив, скільки запитів витратив, скільки разів спрацювали тригери передачі менеджеру.

**Навіщо це дивитись:**

* Якщо AI часто передає діалоги менеджеру — можливо, база знань неповна або промт потребує уточнення
* Якщо баланс витрачається дуже швидко — можливо, варто переглянути ліміти запитів

***

### Поширені проблеми та їх вирішення

| Проблема                                                 | Можлива причина                                              | Що зробити                                                             |
| -------------------------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------- |
| AI вигадує ціни або умови                                | Не вказано джерело файлів у промті або `threshold` завищений | Додайте в промт явне посилання на файли; знизьте `threshold` до `0.00` |
| AI відповідає занадто сухо                               | Занадто низький `top_p`                                      | Підвищте `top_p` до `0.90–0.95`                                        |
| AI і менеджер відповідають одночасно                     | Не увімкнено автовимкнення при підключенні менеджера         | Увімкніть «Автоматично вимикати, коли до чату підключений менеджер»    |
| AI не працює в неробочі години                           | Увімкнено два суперечливих налаштування часу                 | Залиште тільки одне з налаштувань робочого часу                        |
| AI не знаходить інформацію в базі після оновлення файлів | Старі відповіді збережені в історії діалогів                 | Натисніть «Видалити історію ШІ-діалогів»                               |
| Стоп-слово не спрацювало                                 | Клієнт написав близьке, але не точне слово                   | Додайте більше варіантів стоп-слів або налаштуйте `stop_conversation`  |

***

*Якщо у вас залишились запитання — зверніться до підтримки JediDesk або перегляньте пов'язані розділи документації.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.jedidesk.com/nalashtuvannya-jedidesk-ai/yak-nalashtuvati-ai-asistentiv-jedidesk-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
