# AI чат-бот

AI-ассистент — это настоящий прорыв: теперь вы можете настраивать чат-ботов на базе ИИ для взаимодействия с вашими клиентами, используя готовые роли и преднастроенные функции.

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

Настроив чат-бота на базе ИИ, вы сможете:

1. Создать консультанта по всем услугам, доступным в вашем филиале.
2. Генерировать тексты для рассылок и презентаций: просто задайте чат-боту задачу и ключевое сообщение, а затем наслаждайтесь результатом.
3. Создать интернет-магазин с помощью Google Sheets.
4. Записывать клиентов онлайн напрямую в вашу CRM-систему.
5. Комбинировать разных AI-ассистентов с различными настройками.

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

Просто объясните боту свою задачу (как будто это человек), расслабьтесь и наслаждайтесь его работой!
{% endhint %}

{% hint style="warning" %}

## Важно

Одно сообщение от AI-ассистента эквивалентно **10 обычным сообщениям** в использовании конструктора воронок.
{% endhint %}

{% hint style="success" %}

## Обратите внимание

AI-ассистент многоязычен и может общаться с клиентами на разных языках. Имейте в виду, что для языков, не входящих в его основной обучающий набор, точность синтаксиса и орфографии может различаться.
{% endhint %}

{% hint style="danger" %}

## Внимание

Система отдает приоритет блокам конструктора воронок над AI-ассистентом. Все блоки в конструкторе воронок выполняются раньше любого ответа AI-ассистента, включая блоки без условной логики.
{% endhint %}

{% hint style="danger" %}

## Внимание&#x20;

Интерфейс тестирования общий для **AI Assistant** и **конструктора чат-ботов**.

**Ключевой принцип работы:**

1. **Единая система:** Текст **AI Assistant** и **Конструктор чат-ботов** не являются отдельными инструментами; они работают вместе как единый, **унифицированный чат-бот**.
2. **Приоритет обработки:** **Блоки конструктора чат-ботов всегда имеют приоритет.** Если во время тестирования вы получаете неожиданное сообщение, скорее всего, это потому, что сначала сработал блок в Funnel Builder.
3. **Шаг для устранения неполадок:** если AI-ассистент ведет себя неожиданно или отправляет сообщения, не соответствующие его настройкам, всегда **сначала проверьте блоки Funnel Builder**, поскольку они переопределяют ответы ассистента.
   {% endhint %}

{% hint style="warning" %}

## Обратите внимание

AI-ассистент не работает в групповых чатах.
{% endhint %}

## Что такое роли чат-бота

Роли определяют конкретные функциональные задачи и поведенческие характеристики, которые AI-ассистент настроен выполнять и демонстрировать во время взаимодействия с пользователем.

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

Для вашего удобства команда MaviBot уже настроила несколько ролей, готовых к использованию в ваших проектах.

Однако, если эти боты не подходят под ваши конкретные задачи и вы умеете работать с ИИ, смело выбирайте **опцию «Без предустановленных настроек»**.

Если вам нужен AI-чат-бот, настроенный под конкретную модель поведения, вы можете выбрать одну из следующих стандартных ролей

### **Ассистент с текстовыми ответами**

Модель строго ограничена знаниями и информацией, содержащимися в ее настройках. Она отвечает только на вопросы, связанные с текстом, встроенным в ее конфигурацию.

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

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

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

Эта модель имеет минимальные ограничения на генерацию текста, что делает ее хорошо подходящей для задач, требующих креативности, например копирайтинга.

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

Видеообзор

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

### **Ассистент по продажам**

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

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

Эта модель построена вокруг команды **«Продавать любыми средствами.»** Она особенно хорошо работает в сочетании с таблицей или настройкой «знания бота», что делает ее идеальной для динамических списков товаров и расчета цен.

а) создайте таблицу и добавьте необходимые сведения о товарах;

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

{% hint style="info" %}
Инструкции по использованию [функции Google Sheets](/doc/ru/chatbot/ai/google-sheets-dlya-ai-assistenta.md) или [функции таблицы MaviBot](/doc/ru/chatbot/ai/tables.md) можно найти в одноименном разделе.&#x20;
{% endhint %}

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

Эта модель требует четкого пошагового плана действий — аналогично структурированному боту, созданному в конструкторе воронок.&#x20;

**Настройка поведения и ответов на основе алгоритма в настройках бота**

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

{% hint style="info" %}

## **Обратите внимание**

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

Если вам нужна алгоритмическая логика для вашего AI-ассистента, мы настоятельно рекомендуем использовать **готовый шаблон чат-бота** из конструктора воронок. Затем вы можете активировать и настроить его через **интеграцию AI-ассистента** .
{% endhint %}

#### Как работать с квадратными скобками

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

Примеры:

1. **Расскажи мне больше о \[product]**\
   В этом примере модель предоставит больше деталей о товаре, упомянутом в диалоге. Если в контексте или разговоре товар не упоминается, она придумает его.
2. **Помоги мне написать письмо \[другу/коллеге/родственнику]**\
   Здесь слэш используется для того, чтобы модель написала универсальное письмо, которое можно отправить любому из списка.
3. **Ответ не должен превышать \[30-50] слов**\
   Это задает границы для модели, ограничивая длину ее ответа.
4. **Расскажи мне о \[city]**\
   **Модель сгенерирует текст о случайном городе, если ранее не был упомянут какой-либо конкретный город.**
5. **Вы — продавец в магазине. Ваша задача — продать клиенту \[product/service]**\
   Бот будет действовать как менеджер по продажам и поможет продать товар.

Квадратные скобки можно также использовать при написании алгоритма для бота

### **Ассистент онлайн-записи**

Ассистент с ролью «Онлайн-запись» автоматизирует запись клиентов, используя значения, подставляемые через переменные и функции.

Этот бот предназначен для работы с системой онлайн-записи и использует преднастроенную ветку бронирования, чтобы проводить клиентов через доступные услуги, даты и временные слоты — при этом автоматически создавая записи в календарном разделе Services.

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

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

RAG-ассистент нужен для работы с документами, чтобы предоставлять точные ответы на основе вашего контекста.

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

Добавьте файлы: FAQ, инструкции, статьи или внутренние материалы. Ассистент использует их, чтобы находить ответы на вопросы пользователей.

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

Как это работает:

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

### Настройка чанков (для роли RAG)

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

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

RAG разбивает документ на части (чанки), выполняет предварительный поиск среди этих частей, находит часть(и), наиболее похожие на исходный запрос, и добавляет в контекст только несколько чанков вместо всего документа. Велика вероятность, что нужный ответ будет найден среди прикрепленных чанков.

**Как работает роль RAG:** документ делится на части (чанки). По умолчанию один чанк составляет примерно 500 символов.

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

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

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

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

#### **Как это настроить**

**Шаг 1:** Загрузите документ.

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

И, если нужно, укажите размер чанка и перекрытие чанков.

**Шаг 2:** Нажмите «Загрузить документ» (это запустит обработку вашего документа и разбиение его на части (чанки)).

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

**Шаг 3:** Вы можете проверить чанки: например, если часть ответа разделена посередине слова, вы можете ее отредактировать.

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

После этого вы можете протестировать ассистента в окне чата справа.

{% hint style="warning" %}

#### **Важно**

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

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

## Предустановленные настройки

Предустановленные настройки — это заранее заданные инструкции, которые определяют поведение чат-бота.

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

**Кнопки**\
Эта опция необходима для создания кнопок, когда ответ требует выбора из нескольких вариантов. Она отлично подходит для ролей продаж и онлайн-записи.

Пример:

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

Эта опция удобна и для клиента: ему не нужно ничего дополнительно печатать, поскольку для продолжения диалога достаточно выбрать и нажать интересующую его кнопку.

**Избегать обсуждения политики**\
Бот будет молчать или отказываться отвечать на вопросы, связанные с политикой, религией, территориальными претензиями и другими чувствительными темами.

**Украсить ответы**\
Эта функция позволяет боту использовать списки и аккуратное форматирование при ответах на сообщения клиентов.

**Минимизировать креативность**\
Эта опция помогает ограничить творческие ответы бота.

**Пошаговый ввод данных**\
Эта функция собирает данные пользователя шаг за шагом — например, для создания переменных и передачи их в систему (эти переменные позже можно найти в профиле клиента).

Этот подход используется для обработки заказов и заполнения форм, требующих пошагового ввода информации.

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

**Не обучаться на сообщениях**\
Эта опция ограничивает влияние сообщений пользователя на бота, защищая его от попыток злоумышленников намеренно исказить заданный вами промпт.  &#x20;

## Условия срабатывания

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

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

{% hint style="success" %}
Для чего это нужно?

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

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

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

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

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

Текст **Вкладка «Выбор бота»** содержит боты, подключенные к проекту из разных мессенджеров, что позволяет выбрать, какой именно чат-бот будет выполнять настройки ИИ.

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

Важно отметить, что в конструкторе можно настроить триггеры так, чтобы они работали только в окне тестирования, для целей отладки.

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

Чтобы использовать эту функцию, выберите вкладку «Окно тестирования» и нажмите «Добавить триггер», затем протестируйте своего бота в панели тестирования справа.

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

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

## Настройки бота

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

В этом поле необходимо указать:

1. Роль, которую должен принять бот;
2. Как он должен себя вести;
3. Каких действий вы от него ожидаете.

Настройки следует писать в виде обращения к человеку. Например:

*«Вы — специалист поддержки, который знает только информацию, предоставленную вам в контексте. Ваша задача — отвечать на вопросы пользователей. Вы должны быть проактивным и дружелюбным».*

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

Если вы настроили бота отвечать на определенные сообщения, но задали те же условия в блоке конструктора воронок, приоритет будет у блока конструктора воронок!

Это происходит потому, что блоки конструктора воронок имеют более высокий приоритет, чем настройки ассистента.

{% hint style="danger" %}

## Важно

AI-ассистент имеет **более низкий приоритет обработки** чем блоки в Funnel Builder. **Блоки Funnel Builder всегда выполняются первыми.**

**Ключевой принцип:**

* Блоки, такие как **«Trigger», «Start»,** или **«Fallback»** будут выполняться **даже если у них нет условий**, опережая AI-ассистента.
* Только после обработки соответствующих блоков Funnel Builder клиент перейдет по настроенному сценарию чат-бота.
* Текст **AI-ассистент подключается позже**, исходя из итогового состояния диалога.
  {% endhint %}

Пример:

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

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

Вы также задали триггеры в настройках ассистента:

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

AI-ассистент работает как дополнительный слой внутри уже существующих воронок чат-бота.

**Как это работает:**

1. **Основной поток:** Настроенные блоки конструктора воронок всегда выполняются первыми в соответствии со своей логикой и приоритетом.
2. **Роль AI-ассистента:** Ассистент активируется, чтобы обрабатывать случаи **не охваченные** заранее заданными условиями воронки. Он отвечает на вопросы клиентов, которые выходят за рамки основного потока.

**Ключевая польза:**\
Такая интеграция обеспечивает обработку всех запросов клиентов, повышая удовлетворенность пользователей и способствуя росту лояльности.

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

Базовая модель ИИ обучена на широком общем наборе данных из интернета. Несмотря на свою мощность, ей не хватает специальных знаний о **деталях вашего уникального проекта**, таких как:

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

**Почему это поле необходимо:**

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

{% hint style="success" %}
Предоставив краткое описание ваших товаров или услуг, вы даете боту возможность продвигать их более увлекательно, ярко и эффективно.
{% endhint %}

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

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

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

При использовании переменной блок конструктора воронок указывает данные, которые должен знать бот:

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

В приведенном выше примере показан диапазон услуг, настроенный в соответствующем «[Бронирования](/doc/ru/booking/settings.md)".

<figure><img src="/files/37a7c70bd813dad185073f489459436d779aa9b8" alt="" width="375"><figcaption></figcaption></figure>

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

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

ИИ отлично понимает данные из таблицы и использует их в своих ответах.

Подробнее см. в разделе «[Работа с Google Sheets](/doc/ru/chatbot/ai/google-sheets-dlya-ai-assistenta.md)."
{% endhint %}

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

В формате передачи данных вы указываете реальные собираемые данные (например, имя), затем пишете фразу с «ключом» и присваиваете этому ключу значение:\
«Имя с ключом 'name', фамилия с ключом 'surname':»

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

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

Данные отображаются в карточке профиля клиента следующим образом:

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

Этот параметр необязателен и используется, когда нужно передать информацию в систему.

{% hint style="danger" %}

## Обратите внимание

Если вам нужно, чтобы данные, введенные клиентом, передавались боту как переменные, а не как массив или словарь, укажите соответствующие настройки в промпте AI-ассистента. Например, можно настроить параметры так, чтобы ответы отправлялись как текст, а не как список или словарь.

Способ передачи значений боту и их записи в профиль клиента (в системе) зависит от формата данных, сгенерированного AI-ассистентом.
{% endhint %}

### Как передать данные боту

Чтобы отправить данные боту, нужно ввести одну из следующих команд в <mark style="color:синий;">**настройках бота**</mark>:&#x20;

1. <mark style="color:$warning;">**Затем выполните команду «Block call 123123»**</mark> — где «Block call» — это отладочная команда, а число обозначает ID блока.\
   Эта команда полезна для тестирования и проверки того, что данные корректно передаются во время настройки бота.

Как видно из приведенного выше примера, команда выводит данные в формате JSON. Значения сохраняются внутри проекта, помогая вам отслеживать точность хранимой информации и дорабатывать бота на этапе отладки.

Команда указывается в настройках бота следующим образом:

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

2. Команда <mark style="color:фиолетовый;">**«Then execute the command "start\_block\_from\_ai 11916"**</mark>также отправляет информацию боту. Замените число (выделенное зеленым) на ID блока.

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

Команда работает аналогично «Block call **44**,» но используется во время реального взаимодействия с клиентом, поскольку она «вырезается» из сообщения бота и скрыта от пользователей.

**Пример команды:**

*Когда вы завершаете продажу или успешно завершаете разговор, необходимо написать точно, без каких-либо изменений: **«start\_block\_from\_ai 10241»***

#### В чем разница между первой и второй командами для AI-чат-бота

Как уже говорилось выше, «**Block call N**» нужна для тестирования, чтобы вы могли ВИЗУАЛЬНО проверить, работают ли настройки block call корректно или нет.

{% hint style="warning" %}

## Обратите внимание

После отладки настроек AI-чат-бота замените команду «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/c395c68831ac22c74a5bc9d09ee6c517b0786dba" alt="" width="563"><figcaption></figcaption></figure></div>

### Время уведомления о задержке ответа

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

Это поле, принимающее числовое значение, связано с предыдущей настройкой: оно определяет задержку, после которой отправляется сообщение о задержке ответа.

Оно принимает числовое значение в секундах, от 2 до 25.

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

Это ключевой параметр, который раскрывает творческий потенциал модели и позволяет ей генерировать оригинальные идеи, выходящие за рамки обучения.

<div data-with-frame="true"><figure><img src="/files/e5258ce7e01c9e8908a5b8ba7e40b8517eccadd9" 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/635d8533b62ba4b68601e6a6ef1d85c52e6034ea" alt="" width="378"><figcaption></figcaption></figure></div>

Это поле, принимающее только числовые значения, задает максимальное количество слов в ответе чат-бота.

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

{% hint style="warning" %}
Ограничения по символам в мессенджерах:

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

## О полезных советах

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

Модель принимает до **128,000** токенов на вход, где один токен примерно равен двум символам.

### Предотвращение дезинформации пользователя

Если модель вводит клиентов в заблуждение, упоминая несуществующие услуги или товары, вы можете включить опцию «Минимизировать фантазии» и также попробовать снизить креативность модели.

### Как заставить AI Assistant молчать

Введите следующий текст команды в поле настроек бота:

«Если кто-то спрашивает вас о \_\_\_\_\_\_\_, вы должны ответить, что не знаете ответа.\
Если кто-то спрашивает вас о событиях, о которых вы не осведомлены, вы должны ответить, что не знаете ответа.»

Пример:

<div data-with-frame="true"><figure><img src="/files/e2718746a7fd18397f202e7b7b7593651c09f0b6" 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/ru/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.
