> 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

JediDesk AI - асистент на основі штучного інтелекту, інтегрований в систему #jedidesk для швидких відповідей та роботи 24/7

{% hint style="info" %}
**AI та кредити.** AI доступний як окреме підключення на MINI, PRO та PRO+; START не підтримує AI. MINI: $10/міс. без AI або $20/міс. з AI; PRO: $25 або $70; PRO+: $85 або $130. При купівлі платного тарифу нараховуються **1 500 / 4 550 / 7 500 кредитів на місяць** відповідно, незалежно від підключення AI. Витрата на одну AI-відповідь змінюється залежно від обсягу інформації для її формування. Кількість діалогів — лише порівняльний еквівалент пакета, не ліміт і не гарантований мінімум. Ліміти запитів у налаштуваннях асистента — окремі обмеження, які задає користувач. [Докладніше про тарифи й оплату](https://docs.jedidesk.com/znaiomstvo/oplata-pidpiski-na-servis-jedidesk).
{% endhint %}

<figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2Fsv9INuCTv8hWL0Kz3IU6%2Fimage.png?alt=media&amp;token=6fe4053b-8d3b-4d51-989a-bad9cb9c1b3a" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

***

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

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

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

<figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F4EEoBWaQiTmNGFx0EKjB%2Fimage.png?alt=media&amp;token=94fd3263-1b1e-4e52-afa8-ce8aa9d56c67" 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="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FUx9zTRBfgB8P59N4PxpV%2Fclean-p070-03.jpg?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FD9mavcsxfCuO81Jjd5pE%2Fcurrent-ai-instruction.jpg?alt=media" 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="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FdbdNT7DTI3ustmaUinVl%2Fclosure-ai-settings.jpg?alt=media" alt="Поточні налаштування AI"><figcaption><p>Поточні налаштування AI</p></figcaption></figure>

***

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

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

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

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

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

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

> **Кейс.** Клієнт запитує: «Які у вас тарифи?»
>
> При `temperature: 0.10` — «PRO без AI — $25/міс., до 5 операторів. PRO+ без AI — $85/міс., до 10 операторів.» *(Стабільно. Завжди та сама відповідь.)*
>
> При `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 нічого не отримує → або мовчить, або вигадує ❌

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

**Рекомендація:** Починайте з `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. Ліміти та робочий час**

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

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

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

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

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

***

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

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

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

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

***

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

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

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

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

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

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

***

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

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

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

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

***

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

<figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FiGHo18QLmsXWF9TXgyPt%2Fclosure-ai-knowledge.jpg?alt=media" alt="Поточна база знань"><figcaption><p>Поточна база знань</p></figcaption></figure>

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

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

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

* До **50 файлів**
* Рекомендований формат: **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" %}
Після оновлення бази знань збережіть зміни та перевірте відповідь у новому діалозі, щоб попередній контекст розмови не впливав на перевірку.
{% endhint %}

***

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

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

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

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

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

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

***

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

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

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

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

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

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

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

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

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

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

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

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

***

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

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

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

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

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

***

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

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

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

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

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

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

***

**Канали**

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

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

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

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

***

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

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

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

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

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

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

***

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

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

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

***

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

**Баланс**

![Приклад доступного балансу кредитів у підписці MINI з AI](https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FvjMRflAKwezxNLFzhJ8r%2Fjedidesk-subscription-01-current-mini.jpg?alt=media)

*Показано баланс у розділі «Підписка», а не екран налаштувань AI.*

Баланс — це доступна кількість кредитів. Витрата на AI-відповідь залежить від обсягу інформації, використаної для її формування; кількість кредитів не дорівнює кількості запитів.

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

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

**Статистика**

<figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FLdgcm5tnO7V0wlqxn9kO%2F%7B8671D81B-5AB5-4F82-9BA4-98E7F2C2517C%7D.png?alt=media&amp;token=5257e9f3-2a1c-4b2a-b304-eb9067c346b5" 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 або перегляньте пов'язані розділи документації.*

{% hint style="info" %}
**Поточна база знань:** завантажуйте doc, docx, html, txt, json або pdf, дочекайтеся обробки та збережіть зміни. Джерело «Дані із вашого сайту» налаштовується через окреме посилання в цьому розділі. Для «Власних функцій» потрібен PRO+; вбудовані функції та інтеграції мають власну доступність за тарифом.
{% endhint %}
