> 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.md). # Як налаштувати AI-асистентів #jedidesk Навігація: 1. [Параметри JediDesk AI](#id-1.-parametri-jedidesk-ai) 2. [Огляд #jedidesk AI-асистентів](#id-2.-oglyad-jedidesk-ai-asistentiv) 3. [Налаштування AI-асистента](#id-3.-nalashtuvannya-ai-asistenta)\ [3.1. Налаштування інструкції (промт)](#id-3.1.-nalashtuvannya-instrukciyi-promt)\ [3.2. Налаштування файлів](#id-3.2.-nalashtuvannya-failiv) [3.3. Можливість приєднати менеджера](#id-3.3-mozhlivist-priyednati-menedzhera)\ [3.4 Закритий ШІ-асистент](#id-3.4-zakritii-shi-asistent)\ [3.5 Оновлення історії переписки](#id-3.5-onovlennya-istoriyi-perepiski)\ [3.6 Канали](#id-3.6-kanali) 4. [База знань](#id-4.-baza-znan) 5. [Стоп-слова](#id-5.-stop-slova) 6. [Ідентифікатор спрацювання стоп-слова](#identifikator-spracyuvannya-stop-slova) *** #### 1. Параметри JediDesk AI **Баланс на використання JediDesk AI** – кількість безкоштовних запитів, які може обробити підключений JediDesk AI. Баланс можна поповнювати. **Статистика JediDesk AI** – Можна обирати певний період, натиснувши на календар. **Налаштування** – Активація/Деактивація JediDesk AI. **Ліміт на навчання JediDesk AI** – Кількість символів з наданої для навчання інформації. Враховується блок Інструкція та База знань.

Статистика та баланс JediDesk AI

*** #### 2. Огляд #jedidesk AI-асистентів \#jedidesk пропонує 6 готових моделей поведінки під різний тип бізнесу:

Готові моделі поведінки для AI-асистента

* **Lexi - ШІ-асистент для онлайн-магазинів** Lexi є експертом у вашому інтернет-магазині, знає все про товари і готова допомогти клієнтам з консультаціями, порівнянням товарів та підбором комплектів. * **Nova - ШІ-асистент для агенцій** Nova допомагає агенціям з попереднім бріфуваням клієнтів, збиранням необхідної інформації та передачею менеджерам для подальшої роботи. * **Bella - ШІ-асистент для бьюті-індустрії (салони краси)** Bella спеціалізується на допомозі салонам краси, консультує щодо посуг та акцій, допомагає з бронюванням і рекомендує додаткові послуги клієнтам. * **Luna - ШІ-асистент для блогерів** Luna спеціалізується на Instagram-магазинах, консультує та домопагає з підбором товарів, оформлює замовлення до етапу підтвердження менеджером. * **Max - ШІ-асистент для продажів**\ Max підтримує процеси продажів, допомагаючи виявляти потреби клієнтів, консультує та продає ваші продукти 24/7. * **Zara - ШІ-асистент для підтримки клієнтів**\ Zara надає швидкі та точні відповіді на запитання клієнтів, допомагає з консультацією та підтримкою, а також повідомляє менеджера про проблему за необхідності. *** **Можливості AI-асистентів:** **🎤 Розуміння голосових повідомлень**\ AI-асистент розуміє та відповідає на голосові повідомлення, забезпечуючи зручність та оперативність спілкування:
**🖼 Пошук по фото та відео**\ Якщо клієнт надішле фото, AI-асистент знайде подібні товари у вашому асортименті, забезпечуючи індивідуальний підхід до кожного клієнта:
*** #### 3. Налаштування AI-асистента #### **3.1. Налаштування інструкції (промт)** Для налаштування штучного інтелекту, перейдіть до вкладки [**JediDesk AI**](https://app.jedidesk.com/settings-ai). **Вибір асистента** – виберіть одну з готових моделей поведінки. Для прикладу налаштування візьмемо магазин туристичного обладнання на 4000 товарних позицій. В даному випадку підійде AI-асистент Lexi. Після вибору AI-асистента, у вас автоматично з'явиться готовий промт (інструкція) в блоці **Налаштування картки бізнесу -> Інструкція**. Обов'язково відкоригуйте ім'я вашого AI-асистента та назви файлів, на які він буде посилатися при обробці інформації в блоці База знань:

Налаштування промту (інструкції)

Натисніть **Зберегти зміни**. {% hint style="info" %} Ви можете редагувати дану інструкцію за власним бажанням, або замість готового шаблону прописувати модель поведінки власноруч з нуля. {% endhint %} {% hint style="info" %} Ви можете генерувати промт в [ChatGPT Promt Engineering](https://chatgpt.com/g/g-bNiLAvz8R-prompt-engineering), описавши ключові моменти поведінки вашого АІ-асистента: Як він має вітатися, які етапи консультації та продажу проходити, що уточнювати у клієнта тощо. {% endhint %} {% hint style="info" %} Обов'язково вкажіть в Інструкції, що АІ має брати інформацію з завантажених файлів. Наприклад: "Т*и береш дані про доставку з файлу Delivery.json, ти береш дані про товари з файлу Products.json*". {% endhint %} **Мови вашого бота** – виберіть мови, на яких відповідатиме AI-асистент. Ось стислий опис усіх трьох параметрів з кейс-прикладами: *** **Креативність (`temperature`)** Контролює «сміливість» АІ при виборі слів і формулювань. Низькі значення роблять відповіді передбачуваними і точними, високі — більш різноманітними і творчими, але менш стабільними. Для підтримки клієнтів рекомендується тримати низько — `0.10–0.30`. **Кейс:** Клієнт запитує «Які у вас тарифи?» * `temperature: 0.10` → «Тариф Pro — 1099 грн/місяць, 5 операторів.» *(стабільно, одна й та ж відповідь щоразу)* * `temperature: 0.90` → щоразу інакше сформульована відповідь, можливі «вільні інтерпретації» *(ризиковано для підтримки)* *** **Сфокусованість (`top_p`)** Обмежує вибір слів лише найімовірнішими варіантами. Нижче значення `top_p` — відповідь більш передбачувана і повторювана; вище — різноманітніші формулювання. На відміну від `temperature`, цей параметр фільтрує словниковий пул, а не «силу» вибору. **Кейс:** Клієнт питає «Як скасувати підписку?» * `top_p: 0.30` → АІ використовує найпростіші, найчастотніші слова → чіткий, короткий алгоритм дій * `top_p: 0.95` → АІ може варіювати формулювання, додавати синоніми → відповіді «живіші», але менш однорідні *** **Поріг релевантності (`search_threshold`)** Це фільтр впевненості: кожен знайдений у базі знань фрагмент отримує оцінку від 0 до 1, що показує наскільки він відповідає запиту. Поріг визначає мінімальний бал, нижче якого фрагмент не передається АІ. Без порогу АІ може отримати слабко релевантні фрагменти лише тому, що вони найближчі з наявних — і галюцинувати на їх основі.
**Кейс:** Клієнт питає «Які у вас тарифи?». Векторний пошук знаходить фрагмент із базі знань і повертає `score: 0.8388` (видно на твоїх скріншотах). * `threshold: 0.00` → цей фрагмент **передається** АІ → відповідь на основі реальних даних ✅ * `threshold: 0.90` → `0.8388 < 0.90` → фрагмент **відсіюється**, АІ нічого не отримує → або мовчить, або вигадує ❌
**Ліміт запитів на один діалог** – Ви можете встановити ліміт повідомлень, щоб AI-асистент не витрачав баланс на кожне повідомлення від користувача. **Ліміт запитів на тиждень** – Ви можете встановити ліміт запитів (чатів), щоб AI-асистент не витрачав баланс на кожен запит від нового користувача. **Робочі години** – Якщо в розділі **Налаштування ->** [**Компанія**](https://app.jedidesk.com/settings-company) ви налаштовували робочі дні та години, ви можете адаптувати AI-асистента під ваш робочий графік. **Автоматично вимикати, коли до чату підключений менеджер** – параметр, який відповідає за те, що бот працюватиме коли менеджер розпочне розмову з користувачем. **Модель вашого бота** — тут ви можете обрати модель для бота. Залежно від обраної моделі, бот працюватиме по-різному {% hint style="danger" %} **Увага!** Не вмикайте одночасно налаштування **Автоматично включати в** [**неробочі години**](https://app.jedidesk.com/settings-company) та **Автоматично виключати в** [**робочі години**](https://app.jedidesk.com/settings-company) - інакше AI-асистент не буде працювати! **Вмикайте лише одне з налаштувань.** {% endhint %} *** #### **3.2. Налаштування файлів** Важливо, щоб файли містили якомога чіткішу інформацію. Наприклад, для файлу з товарами такі колонки як: Артикул, Назва товару, Розмір / Вага, Короткий опис, Ціна, Посилання:

Налаштування файлу з товарами для AI-асистента

*** Для файлу FAQ (Поширені запитання) додати інформацію з сайту (Оплата, Доставка, Повернення, Гарантії, Контакти):

Налаштування файлу з інформацією для AI-асистента

По завершенню, конвертуйте файли у формат .json на будь-якому онлайн сервісі, наприклад [Online XLSX to JSON Converter](https://products.aspose.app/cells/conversion/xlsx-to-json). *** #### 3.3 Можливість приєднати менеджера По замовчуванню в системі Jedidesk ввімкнений параметр, що користувач може приєднати менеджера до діалогу. Ця можливість буде з'являтись після третьої відповіді АІ асистента в таких месенджерах як: Telegram, Viber, Widget. Це зручно коли асистент виконує роль помічника тільки на початкових етапах спілкування, а не повністю керує діалогом.

Можливість вимкнення або ввімкнення цієї можливості

#### 3.4 Закритий ШІ-асистент За замовчуванням у системі Jedidesk всі користувачі можуть спілкуватися з чат-ботом. Однак у деяких випадках може знадобитися обмежити доступ і надати можливість взаємодії з ботом лише певним користувачам. Для цього в нашому сервісі передбачена функція «Закритий ШІ-асистент».

Функція "Закритий ШІ-асистент" в JediDesk AI

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

Можливість надати доступ до ШІ клієнту

#### 3.5 Оновлення історії переписки Під час спілкування з чат-ботом він запам'ятовує вашу переписку та враховує попередні запитання у відповідях. Це зручно, але після оновлення бота (зміни промту, додавання нових файлів до бази даних або коригування параметрів, як "температура" відповідей) ця функція може заважати. Бот продовжує опиратися на старі відповіді, ігноруючи нові зміни. Щоб не видаляти історію діалогів вручну для кожного користувача, передбачена функція **"Видалення історії ШІ-діалогів"**. Вона реалізована у вигляді кнопки **"Видалити історію ШІ-діалогів"**, яка повністю стирає попередні розмови, дозволяючи боту працювати з актуальними даними.

Кнопка "Видалити історію ШІ-діалогів"

Також ви можете автоматизувати цей процес за допомогою функції **"Очищати ШІ-історію чату після закриття бесіди"**. Якщо вона активована, історія кожного завершеного діалогу автоматично видалятиметься, забезпечуючи актуальність відповідей у наступних розмовах.

Перемикач "Очищати ШІ історію чату після закриття бесіди"

#### **3.6 Канали** Для зручності роботи з нашим сервісом ви можете налаштувати, в яких каналах чат-бот буде активний. Завдяки функції "Канали" ви можете додати певні канали з якими буде працювати чат-бот, і тоді він відповідатиме на запити клієнтів лише у них. Водночас ваші менеджери збережуть можливість спілкуватися з клієнтами без обмежень. Якщо залишити поле пустим, то бот працюватиме з усіма каналами. Це дуже зручно, якщо ви хочете перевірити роботу ШІ на окремому каналі, не порушуючи взаємодії з іншими клієнтами.

Місце знаходження "Канали"

Опис на сайті

**4. База знань** Ви можете додати до 50-ти файлів, з яких АІ-асистент буде брати інформацію. Кожен файл має важити до 10МБ:

Завантаження файлів для АІ-асистента

Натисніть **Зберегти зміни**. **Пов'язано:** Щоб контролювати, як саме АІ шукає інформацію у створеній базі знань — скористайтесь функцією Пошук у базі знань (search\_knowledge\_base). {% content-ref url="/pages/c18cRVa9pRtMtxZDD7mS" %} [Ручне налаштування функції пошуку по базі знань](/nalashtuvannya-jedidesk-ai/ruchne-nalashtuvannya-funkciyi-poshuku-po-bazi-znan.md) {% endcontent-ref %} *** #### **5. Стоп-слова, з**упинка ШІ та передача менеджеру Вкажіть стоп-слова, які зупинять AI-асистента, або сповістять менеджера про звернення клієнта для подальшого опрацювання запиту:
Натисніть **Зберегти зміни**.
#### Налаштуйте AI функцію: «Зупинка ШІ та передача менеджеру» > AI функція stop\_conversation, дозволяє ШІ-асистенту самостійно визначати, коли діалог потрібно передати живому менеджеру. На відміну від стоп-слів (які працюють по точному збігу тексту), ця функція дає ШІ можливість аналізувати контекст розмови і приймати рішення на основі опису, який налаштовує компанія. #### Як це працює? Функція відображається першою у списку AI функцій на сторінці налаштувань ШІ. При ввімкненні та збереженні — ШІ отримує інструкцію, в яких ситуаціях потрібно зупинитись і передати діалог менеджеру.
Коли ШІ викликає цю функцію, відбувається: 1. ШІ-бот зупиняється для поточного діалогу 2. Діалог розподіляється на менеджера 3. Менеджери отримують[ сповіщення (тригер)](#identifikator-spracyuvannya-stop-slova) 4. Клієнту надсилається повідомлення про очікування (наприклад, «Очікуйте, зараз з вами зв'яжеться менеджер») #### Налаштування У модалі налаштувань функції доступні два поля: 1. Опис для ШІ - текст, який пояснює ШІ, в яких ситуаціях викликати функцію. Можна написати вручну або натиснути кнопку «Згенерувати» - система автоматично створить опис на основі промпту компанії та списку стоп-слів.
2. Текст відповіді клієнту - повідомлення, яке отримає клієнт при передачі менеджеру. #### Системні повідомлення про тригери Тепер при спрацюванні будь-якого AI тригера менеджер бачить у чаті системне повідомлення з причиною (видно тільки менеджерам, клієнт не бачить): «Тригер ШІ: клієнт написав стоп-слово «{слово}»»\ «Тригер ШІ: відповідь ШІ містить стоп-слово «{слово}»»\ «Тригер ШІ: функція зупинки — {причина}»\ «Тригер ШІ: клієнт натиснув «Покликати менеджера»»\ «Тригер ШІ: клієнт підключив менеджера»
Це допомагає менеджеру одразу зрозуміти, чому саме спрацював тригер, не витрачаючи час на перечитування діалогу. #### Аналітика Функція має повну аналітику (як і інші AI функції): кількість викликів, успішні/помилкові, середній час виконання, лог по кожному виклику з посиланням на діалог.
### Ідентифікатор спрацювання стоп-слова Для діалогів, у яких задіяно стоп-слово або коли користувач підключає менеджера\ позначка "АІ" на діалозі стає червоного кольору. Для зняття позначки треба прийняти діалог.
--- # 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.md?ask= ``` 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.