# AI-чатбот

Асистент на базі ШІ — це справжній прорив: тепер ви можете налаштовувати чат-ботів із ШІ для взаємодії з вашими клієнтами, використовуючи готові ролі та попередньо налаштовані функції.

<div data-with-frame="true"><figure><img src="/files/0bcf16b50df349bf7d2fdafc80a9e3603d2aed97" alt="" width="375"><figcaption></figcaption></figure></div>

Налаштувавши чат-бота на базі ШІ, ви зможете:

1. Створити консультанта для всіх послуг, доступних у вашому відділенні.
2. Генерувати тексти для розсилок і презентацій: просто дайте чат-боту завдання та ключове повідомлення, а потім насолоджуйтеся результатом.
3. Розробити інтернет-магазин за допомогою Google Sheets.
4. Записувати клієнтів онлайн безпосередньо у вашу CRM-систему.
5. Поєднувати різні асистенти на базі ШІ з різними налаштуваннями.

{% hint style="success" %}
Він відповідає та генерує відповіді точно на основі ваших унікальних налаштувань — потужний інструмент, повністю адаптований до ваших точних потреб і вимог.

Просто поясніть боту своє завдання (ніби це людина), розслабтеся та насолоджуйтеся його роботою!
{% endhint %}

{% hint style="warning" %}

## Важливо

Одне повідомлення від асистента на базі ШІ дорівнює **10 звичайним повідомленням** у вашому використанні конструктора воронок.
{% endhint %}

{% hint style="success" %}

## Зверніть увагу

Асистент на базі ШІ є багатомовним і може спілкуватися з клієнтами різними мовами. Зверніть увагу, що для мов, відмінних від його основного навчального набору, точність синтаксису та правопису може відрізнятися.
{% endhint %}

{% hint style="danger" %}

## Увага

Система надає пріоритет блокам конструктора воронок над асистентом на базі ШІ. Усі блоки в конструкторі воронок виконуються перед будь-якою відповіддю асистента на базі ШІ, включно з блоками без умовної логіки.
{% endhint %}

{% hint style="danger" %}

## Увага&#x20;

Інтерфейс тестування є спільним для **Асистента ШІ** та **конструктора чат-бота**.

**Ключова поведінка, яку потрібно розуміти:**

1. **Єдина система:** Поле **Асистента ШІ** та **Конструктор чат-бота** не є окремими інструментами; вони працюють разом як єдиний, **уніфікований чат-бот**.
2. **Пріоритет обробки:** **Блоки конструктора чат-бота завжди мають пріоритет.** Якщо під час тестування ви отримуєте несподіване повідомлення, ймовірно, це тому, що спочатку було активовано блок у Конструкторі воронок.
3. **Крок усунення проблем:** якщо асистент на базі ШІ поводиться неочікувано або надсилає повідомлення, що не відповідають його налаштуванням, завжди **спочатку перевіряйте блоки Конструктора воронок**, оскільки вони перекривають відповіді асистента.
   {% endhint %}

{% hint style="warning" %}

## Зверніть увагу

Асистент на базі ШІ не працює в групових чатах.
{% endhint %}

## Що таке ролі чат-бота

Ролі визначають конкретні функціональні завдання та поведінкові характеристики, які асистент на базі ШІ налаштований виконувати та демонструвати під час взаємодії з користувачем.

<div data-with-frame="true"><figure><img src="/files/864e348b4fca26e4ee13652196dd776b92ae3361" alt="" width="563"><figcaption></figcaption></figure></div>

Для вашої зручності команда MaviBot уже налаштувала кілька ролей, готових до використання у ваших проєктах.

Однак, якщо ці боти не відповідають вашим конкретним потребам і ви знаєте, як працювати з ШІ, сміливо обирайте **опцію "Без попередніх налаштувань"**.

Якщо вам потрібен чат-бот на базі ШІ, адаптований до певної моделі поведінки, ви можете обрати одну з наведених нижче стандартних ролей

### **Асистент для текстових відповідей**

Модель суворо обмежена знаннями та інформацією, що містяться в її налаштуваннях. Вона відповідає лише на запитання, пов’язані з текстом, вбудованим у її конфігурацію.

<div data-with-frame="true"><figure><img src="/files/6e59913d6b813ce694980197caef9ac19a0f1c78" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/9e6431aeacffa33b5959d22c8d7776909cf93a29" alt="" width="375"><figcaption></figcaption></figure></div>

### **Універсальний асистент**&#x20;

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

<div data-with-frame="true"><figure><img src="/files/64b9b9948fada35fefdaa23aacae79a901ae45a0" alt=""><figcaption></figcaption></figure></div>

Відеоогляд

{% embed url="<https://www.youtube.com/watch?v=DDleWZYuyR0>" %}

### **Асистент із продажів**

У цій ролі бот може демонструвати товари клієнтам, ділитися подробицями про доступні позиції та — якщо це налаштовано — обчислювати підсумкову вартість.

<div data-with-frame="true"><figure><img src="/files/0f734df3811c02f24527a30c641b3f3425507e1d" alt=""><figcaption></figcaption></figure></div>

Ця модель побудована навколо команди **"Продавати будь-якою ціною."** Вона особливо добре працює в поєднанні з таблицею або налаштуванням "знань бота", що робить її ідеальною для динамічних списків товарів і розрахунку цін.

а) створіть таблицю та додайте необхідні відомості про товар;

б) вбудуйте значення з вашої таблиці в знання бота за допомогою функції, спеціально призначеної для Google Sheets.

{% hint style="info" %}
Інструкції щодо використання [функції Google Sheets](/doc/uk/chatbot/ai/google-tablici-dlya-ai-asistenta.md) або [функції таблиці MaviBot](/doc/uk/chatbot/ai/tables.md) можна знайти в розділі з такою ж назвою.&#x20;
{% endhint %}

### **Асистент на основі алгоритму**

Ця модель потребує чіткого покрокового плану дій — подібно до структурованого бота, створеного в конструкторі воронок.&#x20;

**Налаштування поведінки на основі алгоритму та параметрів бота**

<div data-with-frame="true"><figure><img src="/files/4a8a8082340618f755ad577a993c864b7873178c" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}

## **Зверніть увагу**

Написання власного алгоритму — це процес, який потребує багато часу та ретельної уваги до деталей.

Якщо вам потрібна алгоритмічна логіка для вашого асистента на базі ШІ, ми наполегливо рекомендуємо використовувати **готовий шаблон чат-бота** з конструктора воронок. Потім ви можете активувати та налаштувати його через **інтеграцію асистента ШІ** функцію.
{% endhint %}

#### Як працювати з квадратними дужками

Квадратні дужки використовуються для того, щоб дозволити моделі вставити потрібне слово на власний розсуд. Передусім модель спиратиметься на інформацію з контексту та історії діалогу.

Приклади:

1. **Розкажи мені більше про \[product]**\
   У цьому прикладі модель надасть більше деталей про товар, згаданий у діалозі. Якщо в контексті або розмові не згадано жодного товару, вона його вигадає.
2. **Допоможи мені написати листа \[другу/колезі/родичу]**\
   Тут косу риску використано для того, щоб модель написала універсального листа, який можна надіслати будь-кому зі списку.
3. **Відповідь не повинна перевищувати \[30-50] слів**\
   Це встановлює межі для моделі, обмежуючи довжину її відповіді.
4. **Розкажи мені про \[місто]**\
   **Модель згенерує текст про випадкове місто, якщо раніше не було згадано конкретне місто.**
5. **Ви продавець у магазині. Ваше завдання — продати клієнту \[товар/послугу]**\
   Бот діятиме як менеджер із продажів і допоможе продати товар.

Квадратні дужки також можна використовувати під час написання алгоритму для бота

### **Асистент онлайн-бронювання**

Асистент із роллю "Онлайн-бронювання" автоматизує запис клієнтів на зустрічі, використовуючи значення, вбудовані через змінні та функції.

Цей бот призначений для роботи з системою онлайн-бронювання та використовує попередньо налаштовану гілку бронювання, щоб проводити клієнтів через доступні послуги, відкриті дати й часові слоти — автоматично створюючи записи в календарному розділі Services.

<div data-with-frame="true"><figure><img src="/files/a7ffc2de9fec11d76c83131c930b0184e39033ef" alt=""><figcaption></figcaption></figure></div>

### **Асистент RAG** <a href="#rag-assistent" id="rag-assistent"></a>

Асистент RAG потрібен для роботи з документами, щоб надавати точні відповіді на основі вашого контексту.

<div data-with-frame="true"><figure><img src="/files/228251e61f58a2783210f6fa12ec60ef190f903d" alt="" width="375"><figcaption></figcaption></figure></div>

Додайте файли: FAQ, інструкції, статті або внутрішні матеріали. Асистент використовує їх, щоб знаходити відповіді на запитання користувачів.

<div data-with-frame="true"><figure><img src="/files/edfc775eb8efbe1e15efb990c6081aa59e5af1cd" alt="" width="563"><figcaption></figcaption></figure></div>

Як це працює:

* **Попередній пошук:** Перед відповіддю асистент шукає необхідну інформацію безпосередньо в завантаженому документі.
* **Точні відповіді:** Користувачі отримують відповіді безпосередньо з ваших матеріалів.

### Налаштування chunk'ів (для ролі RAG)

Chunk — це блок/фрагмент документа.

<div data-with-frame="true"><figure><img src="/files/4363ad82d12486b436443707d16b808ef0b0cb3d" alt="" width="563"><figcaption></figcaption></figure></div>

RAG розбиває документ на частини (chunks), виконує попередній пошук серед цих частин, знаходить ту(ті) частину(и), яка(і) найбільше подібна(і) до початкового запиту, і додає в контекст лише кілька chunk'ів замість усього документа. Існує висока ймовірність, що потрібна відповідь буде знайдена в прикріплених chunk'ах.

**Як працює роль RAG:** документ поділяється на частини (chunks). За замовчуванням один chunk — це приблизно 500 символів.

Рекомендований розмір текстового фрагмента — від 1000 до 2000 символів (вказується в полі розміру chunk).

Розбиття документа виконується автоматично, і для асистента краще, якщо одна частина містить змістовний фрагмент: наприклад, одне запитання та одну відповідь із FAQ або один/два повні абзаци документа.

<div data-with-frame="true"><figure><img src="/files/909481f1a5a4506e4e594ef5bff487cb1516b492" alt="" width="563"><figcaption></figcaption></figure></div>

Ви можете налаштувати ці chunks після автоматичного розбиття через інтерфейс: скоротити одні, додати інформацію до інших, видалити деякі або додати повністю нові.

#### **Як це налаштувати**

**Крок 1:** Завантажте документ.

<div data-with-frame="true"><figure><img src="/files/a1b350b76b1aecc73c5109a38d83f77190eae88d" alt="" width="563"><figcaption></figcaption></figure></div>

І, за потреби, вкажіть розмір chunk і overlap chunk.

**Крок 2:** Натисніть "Завантажити документ" (це запустить обробку вашого документа та розбивку його на частини (chunks)).

<div data-with-frame="true"><figure><img src="/files/fb7ee58ac08506d8b9e1d516635cfcd3c4894da8" alt="" width="563"><figcaption></figcaption></figure></div>

**Крок 3:** Ви можете перевірити chunks: наприклад, якщо частина відповіді розділена посередині слова, ви можете її відредагувати.

<div data-with-frame="true"><figure><img src="/files/ef50f3bf7c72832f0ddf23ecd5adef10c7e7bbb5" alt="" width="563"><figcaption></figcaption></figure></div>

Після цього ви можете протестувати асистента у вікні чату праворуч.

{% hint style="warning" %}

#### **Важливо**

* Ви можете будь-коли видалити будь-який chunk (частину) в налаштуваннях асистента.
* Ви також можете додати додаткову інформацію без потреби щоразу повторно завантажувати весь документ: просто завантажте txt-файл і створіть chunks.
* Ви можете замінити застарілу інформацію безпосередньо в межах chunk без завантаження документів.
  {% endhint %}

{% hint style="info" %}
Ви можете ввести фразу в полі "Знання бота", наприклад: "Назви документів зазначаються в дужках у контексті; за можливості звертайтеся до них." Таким чином, асистент додаватиме в дужках назву документа, у якому він знайшов інформацію.
{% endhint %}

## Попередньо налаштовані параметри

Попередньо налаштовані параметри — це заздалегідь визначені інструкції, які спрямовують поведінку чат-бота.

<div data-with-frame="true"><figure><img src="/files/cbcda8d838132dafb02779655f5ed9f58423bc1e" alt="" width="360"><figcaption></figcaption></figure></div>

**Кнопки**\
Ця опція є необхідною для створення кнопок, коли відповідь потребує вибору з кількох варіантів. Вона чудово працює для ролей продажів і онлайн-бронювання.

Приклад:

<div data-with-frame="true"><figure><img src="/files/4496307fdb93ec04e30a4eaf88cbe77ea42ec441" alt="" width="375"><figcaption></figcaption></figure></div>

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

**Уникайте обговорення політики**\
Бот залишатиметься мовчазним або відмовлятиметься відповідати на запитання, пов’язані з політикою, релігією, територіальними претензіями та іншими чутливими темами.

**Удосконалюйте відповіді**\
Ця функція дозволяє боту використовувати списки та акуратне форматування під час відповідей на повідомлення клієнтів.

**Мінімізувати креативність**\
Ця опція допомагає обмежити креативні відповіді бота.

**Покрокове введення даних**\
Ця функція збирає дані користувача крок за кроком — наприклад, для створення змінних і передавання їх у систему (ці змінні згодом можна знайти в профілі клієнта).

Цей підхід використовується для обробки замовлень і заповнення форм, які вимагають покрокового введення інформації.

{% hint style="info" %}
Щоб створити змінні та правильно передати їх у систему, будь ласка, зверніться до розділу "[Формат передачі даних.](#data-transfer-format)"
{% endhint %}

**Не навчатися на повідомленнях**\
Ця опція обмежує вплив повідомлень користувача на бота, захищаючи його від спроб зловмисних користувачів навмисно спотворити встановлений вами prompt.  &#x20;

## Умови спрацьовування

<div data-with-frame="true"><figure><img src="/files/de45786e0b461eff2ed33c5bf9a0f8cc8ddf45ef" alt="" width="563"><figcaption></figcaption></figure></div>

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

{% hint style="success" %}
Для чого це потрібно?

Ви можете налаштувати кілька асистентів для роботи в межах одного чат-бота та перемикатися між ними за допомогою умов. Як створити двох або більше асистентів і координувати їхню роботу в одному чаті, описано нижче.
{% endhint %}

### Конструктор тригерів

<div data-with-frame="true"><figure><img src="/files/4472d9d9712ec9d59acfde6eec8fcfb88d0cb5a7" alt=""><figcaption></figcaption></figure></div>

Ви можете вручну задати змінні з певними значеннями та вибрати оператор порівняння. Оператори порівняння є стандартними, як і в усіх тригерах MaviBot: дорівнює, не дорівнює; більше ніж, більше або дорівнює; менше ніж, менше або дорівнює відповідно.

<figure><img src="/files/df5160037b8f1546beb15d65a3eba232ddff0e41" alt="" width="360"><figcaption></figcaption></figure>

Поле **вкладка "Вибір бота"** містить ботів, підключених до проєкту з різних месенджерів, що дозволяє вам вибрати, який саме чат-бот виконуватиме налаштування ШІ.

<div data-with-frame="true"><figure><img src="/files/41851beaeb166c0a3150215340fd38fb0f41d528" alt="" width="563"><figcaption></figcaption></figure></div>

Важливо зазначити, що в конструкторі ви можете налаштувати тригери для роботи лише у вікні тестування з метою налагодження.

<div data-with-frame="true"><figure><img src="/files/9cb4da197404c5256743f440f351b40c136b0780" alt=""><figcaption></figcaption></figure></div>

Щоб скористатися цією функцією, виберіть вкладку "Вікно тестування" і натисніть "Додати тригер", а потім протестуйте свого бота в панелі тестування праворуч.

<div data-with-frame="true"><figure><img src="/files/975e649939be2efe89016a7204eb17c08143c2ea" alt=""><figcaption></figcaption></figure></div>

Це допомагає уникнути незручних ситуацій, коли клієнт пише вашому боту під час вашого налагодження, а замість вас відповідає ШІ.

## Налаштування бота

<div data-with-frame="true"><figure><img src="/files/159889cbbcf1126c812fe878381fe5e021e94a44" alt=""><figcaption></figcaption></figure></div>

У цьому полі вам потрібно вказати:

1. Роль, яку має виконувати бот;
2. Як він має поводитися;
3. Яких дій ви від нього очікуєте.

Налаштування слід писати як звернення до людини. Наприклад:

*"Ви — фахівець підтримки, який знає лише інформацію, надану вам у контексті. Ваше завдання — відповідати на запитання користувачів. Ви повинні бути проактивними та дружніми."*

{% hint style="success" %}
Якщо модель не дотримується інструкцій належним чином, ви можете додати приклади запитань і відповідей для уточнення:\
\&#xNAN;*"Ви не повинні відповідати на беззмістовні повідомлення, не пов’язані з контекстом. Ось кілька прикладів:*\
*Контекст — заєць — це пухнастий ссавець*\
*Питання — Привіт*\
*Відповідь — Я не знаю відповіді на ваше запитання.*\
*Контекст — Вугілля видобувають у шахті*\
*Питання — Вимкни воду*\
*Відповідь — Я не знаю відповіді на ваше запитання."*
{% endhint %}

Якщо ви налаштували бота відповідати на певні повідомлення, але в блоці конструктора воронок задали ті самі умови, блок конструктора воронок матиме пріоритет!

Це відбувається тому, що блоки конструктора воронок мають вищий пріоритет, ніж налаштування асистента.

{% hint style="danger" %}

## Важливо

Асистент на базі ШІ має **нижчий пріоритет обробки** ніж блоки в Конструкторі воронок. **Блоки Конструктора воронок завжди виконуються першими.**

**Ключова поведінка:**

* Такі блоки, як **"Trigger", "Start",** або **"Fallback"** будуть виконуватися **навіть якщо не мають умов**, маючи пріоритет над асистентом на базі ШІ.
* Лише після того, як відповідні блоки Конструктора воронок будуть оброблені, клієнт перейде далі за налаштованим шляхом чат-бота.
* Поле **Асистент ШІ підключається після цього**, на основі результативного стану розмови.
  {% endhint %}

Приклад:

Ви вказали певні слова/фрази в тригерах блоку:

<div data-with-frame="true"><figure><img src="/files/2b879912473d604e63213d7bfa41d79454ac0da5" alt=""><figcaption></figcaption></figure></div>

Ви також задали тригери в налаштуваннях асистента:

<div data-with-frame="true"><figure><img src="/files/86ae0e12bec4e460e7e38bd0040acd579cc816eb" alt=""><figcaption></figcaption></figure></div>

Асистент на базі ШІ працює як додатковий шар у межах ваших наявних воронок чат-бота.

**Як це працює:**

1. **Основний потік:** Налаштовані блоки конструктора воронок завжди виконуються першими відповідно до своєї логіки та пріоритету.
2. **Роль асистента ШІ:** Асистент активується для обробки випадків **не охоплених** попередньо визначеними умовами воронки. Він відповідає на запитання клієнтів, які виходять за межі основного потоку.

**Ключова перевага:**\
Ця інтеграція забезпечує обробку всіх запитів клієнтів, підвищуючи задоволеність користувачів і сприяючи зростанню лояльності.

## Знання бота

Базова модель ШІ навчена на широкому загальному наборі даних з інтернету. Хоча вона є потужною, їй бракує специфічних знань про **деталі вашого унікального проєкту**, такі як:

* каталог товарів вашого бренду
* ваші конкретні послуги
* ваші внутрішні політики або процедури

**Чому це поле є важливим:**

<div data-with-frame="true"><figure><img src="/files/1987abb43c97ac77fcd77d6cb66466b6d25314ff" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Надавши короткий опис ваших товарів або послуг, ви даєте боту змогу просувати їх у більш захопливий, яскравий та ефективний спосіб.
{% endhint %}

У цьому полі вам потрібно надати основну інформацію про ваш продукт, на яку бот спиратиметься під час відповіді. Ви можете написати це як текст або використати змінну.

<div data-with-frame="true"><figure><img src="/files/cbd8b4debaccab4d1753e2f03191658d5f955ac4" alt="" width="438"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/8a3c6e17d0f446a24035ff61369808e467c6bee9" alt="" width="563"><figcaption></figcaption></figure></div>

Під час використання змінної блок конструктора воронок визначає дані, які бот має знати:

<div data-with-frame="true"><figure><img src="/files/628081f57b2cd3eeac54fcecdd1a1d93bb1975df" alt="" width="498"><figcaption></figcaption></figure></div>

У наведеному вище прикладі показано перелік послуг, налаштованих у відповідному "[Бронювання](/doc/uk/booking/settings.md)".

<figure><img src="/files/0bcf16b50df349bf7d2fdafc80a9e3603d2aed97" alt="" width="375"><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="/files/2a40a80efb7af0eb0f64df286c86fefa0393c8e3" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Ви також можете наповнювати знання бота значеннями, вказаними в Google Sheet — наприклад, для інтернет-магазину.

ШІ чудово розуміє дані з таблиці та використовує їх у своїх відповідях.

Для отримання додаткових відомостей дивіться розділ "[Робота з Google Sheets](/doc/uk/chatbot/ai/google-tablici-dlya-ai-asistenta.md)."
{% endhint %}

## Формат передачі даних

У форматі передачі даних ви вказуєте фактичні дані, які збираються (наприклад, ім’я), потім пишете фразу з "ключем" і призначаєте значення цьому ключу:\
"Ім’я з ключем 'name', прізвище з ключем 'surname':"

<div data-with-frame="true"><figure><img src="/files/14de1ab740262b68be8530d73b5ba2f9cebacd25" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/896632ca41ad993f023e115d4a28983d6b32d5f2" alt=""><figcaption></figcaption></figure></div>

Дані відображаються на картці профілю клієнта так:

<div data-with-frame="true"><figure><img src="/files/945fa7d758d86dc51545a73049899e3665226111" alt=""><figcaption></figcaption></figure></div>

Цей параметр є необов’язковим і використовується, коли потрібно передати інформацію в систему.

{% hint style="danger" %}

## Зверніть увагу

Якщо вам потрібно, щоб дані, введені клієнтом, передавалися боту як змінні, а не як масив або словник, вкажіть відповідні налаштування в prompt асистента ШІ. Наприклад, ви можете налаштувати параметри так, щоб відповіді надсилалися як текст, а не як список чи словник.

Спосіб передавання значень боту та їх фіксації в профілі клієнта (у системі) залежить від формату даних, згенерованого асистентом ШІ.
{% endhint %}

### Як передати дані боту

Щоб надіслати дані боту, вам потрібно ввести одну з наведених нижче команд у <mark style="color:blue;">**налаштуваннях бота**</mark>:&#x20;

1. <mark style="color:$warning;">**Потім виконайте команду "Block call 123123"**</mark> — де "Block call" — це команда налагодження, а число позначає ID блоку.\
   Ця команда корисна для тестування та перевірки того, що дані передаються правильно під час налаштування бота.

Як видно з прикладу вище, команда виводить дані у форматі JSON. Значення зберігаються в межах проєкту, допомагаючи вам відстежувати точність збереженої інформації та вдосконалювати бота під час етапу налагодження.

Команда вказується в налаштуваннях бота так:

<div data-with-frame="true"><figure><img src="/files/97d953022548098dc180241b08403b4dfd9cf202" alt="" width="563"><figcaption></figcaption></figure></div>

2. Команда <mark style="color:purple;">**"Потім виконайте команду "start\_block\_from\_ai 11916"**</mark>також надсилає інформацію боту. Замініть число (виділене зеленим) на ID блоку.

<div data-with-frame="true"><figure><img src="/files/6c0b7db4b5b71067c87cf21b6aacd3eab8461f59" alt="" width="563"><figcaption></figcaption></figure></div>

Команда працює аналогічно до "Block call **44**," але використовується під час реальної взаємодії з клієнтом, оскільки вона «вирізається» з повідомлення бота і приховується від ваших користувачів.

**Приклад команди:**

*Коли ви завершуєте продаж або успішно закінчуєте розмову, ви повинні написати точно, без будь-яких змін: **"start\_block\_from\_ai 10241"***

#### У чому різниця між першою та другою командами для чат-бота на базі ШІ

Як згадувалося раніше, "**Block call N**" потрібна для тестування, щоб ви могли ВІЗУАЛЬНО перевірити, чи працюють налаштування block call правильно чи ні.

{% hint style="warning" %}

## Зверніть увагу

Після налагодження налаштувань чат-бота на базі ШІ замініть команду "Block call **44**" на "**start\_block\_from\_ai 44**". У такий спосіб клієнт НЕ бачитиме команду block call, а діалог у чаті продовжуватиметься без змін, тоді як дані, введені користувачем, усе ще передаватимуться в систему.
{% endhint %}

{% hint style="info" %}
Коли блок активується через асистента, історія чату з асистентом очищується.
{% endhint %}

Приклад використання:

* Якщо хтось просить вас увімкнути світло, <mark style="color:$warning;">**виконайте команду "Block call 123123"**</mark>
* Якщо хтось запитує вас про час посадки руколи, <mark style="color:$warning;">**виконайте команду "Block call 123123"**</mark>

{% hint style="success" %}
Зверніть увагу!

Якщо ваша команда (будь то тригер чи якась інша) не працює, додайте в кінці речення «І ніяк інакше» (див. приклад нижче).
{% endhint %}

## Інші параметри

### Повідомлення для затриманих відповідей

Якщо боту потрібно більше часу для генерації відповіді (наприклад, під час генерації тексту або копірайтингу), ви можете задати повідомлення, яке бот надішле:

<div data-with-frame="true"><figure><img src="/files/3645483db86c98c673854d370da322c44dab387f" alt="" width="563"><figcaption></figcaption></figure></div>

### Час сповіщення про затримку відповіді

<div data-with-frame="true"><figure><img src="/files/6c5b6e362cf3adc345d8ffec4751f34f5139c1ca" alt="" width="563"><figcaption></figcaption></figure></div>

Це поле, яке приймає числове значення, пов’язане з попереднім налаштуванням: воно визначає затримку, після якої надсилається повідомлення про затриману відповідь.

Воно приймає числове значення в секундах у діапазоні від 2 до 25.

### **Креативність моделі**

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

<div data-with-frame="true"><figure><img src="/files/6fc0e39af8c86c78b053f6cfbe2d126d6df76ed7" alt="" width="428"><figcaption></figcaption></figure></div>

Параметр задається значенням від 0.0 до 1 (наприклад, 0.1, 0.2 тощо).

{% hint style="success" %}
Для завдань, що потребують опори на текст і точних відповідей, краще встановлювати значення, близькі до нуля, оскільки це запобігає введенню ваших клієнтів в оману. <br>

Натомість для творчих завдань, де уява не є проблемою, рекомендується значення, близьке до 0.9.
{% endhint %}

{% hint style="success" %}
Якщо ви не впевнені, яке значення встановити для обраної ролі асистента, просто залиште поле порожнім — для кожної ролі вже налаштовано оптимальні значення за замовчуванням.
{% endhint %}

### Максимальна кількість слів

<div data-with-frame="true"><figure><img src="/files/021cec2a68d4b9dbb54debc528c1d3be65ea96e9" alt="" width="378"><figcaption></figcaption></figure></div>

Це поле, яке приймає лише числові значення, встановлює максимальну кількість слів для відповіді чат-бота.

Таке обмеження особливо корисне для месенджерів, де кількість символів у повідомленні суворо обмежена, оскільки воно запобігає тому, щоб ШІ-бот був обрізаний посеред речення, і допомагає надати найточнішу та найлаконічнішу відповідь у межах повідомлення.

{% hint style="warning" %}
Ліміти символів у месенджерах:

* Telegram – **4096** символів
* Instagram – **1000** символів
* WhatsApp – **4096** символів
* Viber – **1000** символів
  {% endhint %}

## Про корисні поради

### Ліміт токенів

Модель приймає до **128,000** токенів як вхідні дані, де один токен приблизно дорівнює двом символам.

### Запобігання дезінформації користувача

Якщо модель вводить клієнтів в оману, згадуючи неіснуючі послуги або товари, ви можете увімкнути опцію "Мінімізувати фантазії" та також спробувати зменшити креативність моделі.

### Як змусити Асистента ШІ мовчати

Введіть наступний текст команди в поле налаштувань бота:

"Якщо хтось запитує вас про \_\_\_\_\_\_\_, ви повинні відповісти, що не знаєте відповіді.\
Якщо хтось запитує вас про події, про які ви не обізнані, ви повинні відповісти, що не знаєте відповіді."

Приклад:

<div data-with-frame="true"><figure><img src="/files/298b26bb3e5b9b30482553f6cb9c1b1bbbcd0f73" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}

## Зверніть увагу

Бот пам’ятає історію чату.

Якщо ви зміните його налаштування, рекомендується видалити поточну розмову та почати нову. Інакше бот і надалі відповідатиме на основі попередніх повідомлень, оскільки історія чату має пріоритет над новими налаштуваннями.
{% endhint %}


---

# Agent Instructions: 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.mavibot.ai/doc/uk/chatbot/ai/assistant.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.