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

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

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

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

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

{% hint style="success" %}
Бот реагирует и формирует ответы только по вашим индивидуальным настройкам - такой мощный инструмент подстроится под ваши запросы и требования.

Объясните боту, как человеку, что нужно сделать, а затем наслаждайтесь его работой.&#x20;
{% endhint %}

{% hint style="info" %}
Внимание!

1 сообщение AI ассистента = 10 обычным сообщениям из конструктора воронок.&#x20;
{% endhint %}

{% hint style="success" %}
Внимание!

AI-ассистент мультиязычен: модель выполняет функции на русском и на английском языках.&#x20;

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

<img src="/files/3edRBFyLtKAaMsC624x8" alt="" data-size="original">

<img src="/files/RF5RYpzOSCohGoEOfQps" alt="" data-size="original">

{% endhint %}

{% hint style="danger" %}
Обращаем внимание!&#x20;

Окно тестирования АИ-ассистента и окно тестирования в конструкторе воронок чат-бота - это единое целое.&#x20;

Если вы тестируете АИ-ассистента, но приходит иное сообщение (например, из конструктора воронок), значит, отработался какой-либо блок из конструктора воронок, так как <mark style="color:red;">**блоки имеют приоритет над АИ-ассистентом.**</mark>&#x20;

Не отделяйте <mark style="color:red;">**АИ-ассистента и конструктор воронок**</mark> - они работают как единое целое, это <mark style="color:red;">**ОДИН ЧАТ-БОТ**</mark>.

Если вы увидели, что АИ-ассистент отправляет иное сообщение, а не по настройкам, установленным Вами, <mark style="color:red;">**проверьте блоки в конструкторе воронок.**</mark> &#x20;
{% endhint %}

{% hint style="warning" %}
Внимание!&#x20;

АИ-ассистент НЕ работает в групповых чатах.&#x20;
{% endhint %}

## Приоритет AI-ассистента

После создания нескольких AI-ассистентов, вы сможете увидеть красную звездочку над названием одного из них:

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

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

{% hint style="danger" %}
Обращаем внимание!&#x20;

AI-ассистент имеет приоритет ниже, чем блоки в конструкторе:

Сначала отоработается блок в конструкторе воронок, а только потом АИ-ассистент!&#x20;

Если даже у блока нет условия, отработается сначала блок в конструкторе!&#x20;
{% endhint %}

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

Если условия для запуска одинаковы для двух AI-ассистентов, то проверка приоритетности бота идет дальше.

Чтобы назначить приоритетным другого AI-ассистента, нужно в настройках ныне приоритетного бота выбрать роль "Выключен":

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

Тогда приоритет перейдет к другому AI-ассистенту:

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

Если у вас три и более ассистента, то приоритет уйдет к тому, у кого расписаны условия в поле "Условия для запуска".

## Роли для бота

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

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

И для вашего удобства командой Salebot уже были настроены несколько ролей для ваших проектов.&#x20;

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

В случае, если вам необходим настроенный на определенную модель поведения чат-бот с ИИ, то воспользуйтесь следующими типовыми ролями:

### **Ответы по тексту**

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

<div><figure><img src="/files/RDr920zv5xU2aQm11lO0" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/P5DibDXeSt59D4gwFpnF" alt="" width="375"><figcaption></figcaption></figure></div>

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

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

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

Видеогид

{% embed url="<https://youtu.be/4cTZc3x-itk>" %}

### **Продажник**

С данной ролью бот предлагает товары клиентам, информирует о доступных продуктах и, если вы пропишите необходимые настройки, рассчитает итоговую стоимость:

<div data-with-frame="true"><figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXdTfMEe66GTpAlf0PAIXyLR9OQ-_LCgiDDPa0_Sb2Jgb-YD7erhP4TZr-DtU44LoizMCjgdd893Rx1NJb5LaiuRi_-nASlLJKvwqR7AASuFeu-_oCdkx8hU2yGFtkKZyIPzsvfSIgjKVO9kxsNnHA7VOtfF?key=g9-j53ENQsA_W1hDFrramA" alt="" width="375"><figcaption></figcaption></figure></div>

В основу настройки данной модели заложена команда "Продать любыми способами". Данный бот отлично будет работать в сочетании с google-таблицами:

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

б) вложите в знания бота с помощью функции, разработанной специально для google-таблиц, значения из таблицы.&#x20;

{% hint style="info" %}
Как [использовать функцию для google-таблиц](#dlya-raboty-s-google-tablicami), рассказали в одноименном разделе.
{% endhint %}

Видеогид

{% embed url="<https://youtu.be/hVjvqkPDD0U>" %}

### **Работа по алгоритму**

Этой модели требуется чёткий пошаговый план действий - аналогом схематичного бота из конструктора воронки.&#x20;

а) настройки бота с алгоритмом:

<figure><img src="/files/4PXFmfp9atTAIfFVkAoB" alt=""><figcaption></figcaption></figure>

б) ответы бота:

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

{% hint style="info" %}
Прописывание алгоритма достаточно трудоемкий процесс и требует обращения внимания на малейшие детали.&#x20;

Если Вам нужен бот, работающий по заготовленной схеме, рекомендуем создавать схему-чат бота в конструкторе, а ИИ использовать как поддержку (страховку) без роли "Работа по алгоритму", например, если чат-бот не знает ответа — это будет быстрее, к тому же вы наглядно сможете видеть логику работы бота с помощью схемы в конструкторе.&#x20;
{% endhint %}

Видеогид

{% embed url="<https://youtu.be/UzgmKgcskl4>" %}

### **Онлайн-запись**

Ассистент с ролью "Онлайн-запись" автоматизирует онлайн-запись клиентов, используя значения, вложенные в него с помощью переменной и функции.&#x20;

Данный бот направлен на работу с CRM-системой и с помощью предварительно настроенного филиала для онлайн-записи консультирует клиента по имеющимся услугам, свободным дням и времени, а также сформирует запись в календаре - разделе SalebotCRM.

<div><figure><img src="/files/MWDL0LDevkPbPLacbgdB" alt=""><figcaption></figcaption></figure> <figure><img src="/files/BAT2RmqXSEBHX90UdQnB" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
[Как настроить чат-бота с ИИ на работу с онлайн-записью](/chatbots/ai_assistant/online_booking.md), рассказали в одноименной статье.&#x20;
{% endhint %}

### **RAG ассистент**

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

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

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

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

Принцип работы:&#x20;

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

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

{% hint style="success" %}
Чанк — это блок / фрагмент документа.
{% endhint %}

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

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

Принцип работы роли RAG: документ делится на кусочки (чанки). По умолчанию один чанк (кусочек) — примерно 500 символов.&#x20;

{% hint style="success" %}
Рекомендуемый размер текстового фрагмента от 1000 до 2000 символов (указывается в поле размер чанка).
{% endhint %}

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

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

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

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

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

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

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

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

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

Шаг 3. Можно проверить чанки: например, если один кусочек ответа поделился на полуслове и тд, отредактировать его:

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

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

{% hint style="success" %}
Важное при работе с документами:

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

{% hint style="success" %}
Полезное

Можно в поле "Знания бота" прописать фразу, наподобие "В контексте в скобках указаны имена документов, по возможности ссылайся на них.", тогда ассистент будет добавлять в скобках имя документа, в котором он нашёл информацию.
{% endhint %}

## Заготовленные настройки

Заготовленные настройки - это заранее предопределенные инструкции для поведения чат-бота.&#x20;

<figure><img src="/files/aFNYZnOhAmXFjYblrGJg" alt="" width="563"><figcaption></figcaption></figure>

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

Пример:

<figure><img src="/files/8bKqpJp8qoVp9f9qvahj" alt="" width="375"><figcaption></figcaption></figure>

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

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

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

**Красиво форматировать ответ**\
С помощью данного функционала бот будет стараться использовать списки и аккуратные отступы при ответе на сообщения клиента.

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

**Минимизация фантазий**\
Такая опция поможет ограничить креативную составляющую бота.&#x20;

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

**Пошаговый ввод данных**

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

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

<div><figure><img src="/files/x96Vc5lm05DTYmbHfAIE" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/o9xKcZdpHRqES0ahMSVZ" alt="" width="375"><figcaption></figcaption></figure></div>

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

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

**Не выполнять команды пользователей**

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

Данная опция ограничивает влияние сообщений пользователей на бота - это обезопасит бот от попыток злоумышленников намеренно исказить настроенный вам промпт.  &#x20;

## Условия для запуска

<figure><img src="/files/FJZa3H2ZRgQAJro4pjzQ" alt="" width="563"><figcaption></figcaption></figure>

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

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

Вы можете настроить нескольких ассистентов для работы в одном чат-боте и с помощью условий переключаться с одного на другой.&#x20;

[Как создать двух и более ассистентов](#kak-sozdat-dvukh-i-bolee-assistentov-v-odnom-chate) и координировать их работу в одном чате, рассказали далее.
{% endhint %}

{% hint style="success" %}
Если необходимо, чтобы AI-ассистент работал во всех подключенных мессенджерах, то поле можно пропустить.

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

### Конструктор условий

<figure><img src="/files/1vFAlY6DUjXqeivqlBIT" alt="" width="563"><figcaption></figcaption></figure>

Как видно, можно вручную прописать переменные с определенным значением и выбрать оператор сравнения.&#x20;

Операторы сравнения стандарты, как и во всех условиях в Сейлбот: равно, не равно; больше, больше или равно;  меньше, меньше или равно соответственно:

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

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

<figure><img src="/files/khl3RntHWfMBeJ4n3KI4" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/TKqNpMzCvfX7beN9rrR1" alt="" width="563"><figcaption></figcaption></figure>

Чтобы воспользоваться функционалом, выберите вкладку "Тестовое окно" и кликните на "Добавить условие", а затем протестируйте своего бота в правом тестовом окне:

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

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

### Как тестировать бота?

1. В тестовом окне

Если необходимо протестировать бота в режиме тестового окна, но при этом чтобы бот не отрабатывался в реальных подключенных к проекту мессенджерах:

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

В конструкторе условий выберите запуск в тестовой платформе:&#x20;

а) нажмите на кнопку "Конструктор условий";\
б) нажмите на кнопку "Тестовое окно";\
в) нажмите на кнопку "Добавить условие":

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

После чего условие для работы бота только в тестовом окне появится в поле "Условие для запуска":

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

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

{% hint style="warning" %}
После того, как вы протестировали бота, сотрите в поле "Условие запуска" '<mark style="color:$success;">**platform\_id == "test\_client\_online" '**</mark>.&#x20;

Если нужно, чтобы ИИ-бот отрабатывался только в определенном мессенджере, то выберите в конструкторе условий необходимый мессенджер во вкладке "Выбор бота", как описано выше в параграфе "[Конструктор условий](#konstruktor-uslovii)".
{% endhint %}

2. Тестирование в реальном мессенджере

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

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

Далее перейдите во вкладку "Выбор бота" и выберите подключенный мессенджер, в котором хотите протестировать работу ИИ-бота:

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

Затем нажмите "Добавить":

<figure><img src="/files/8N1Eocz9VvuGFJCjmRUP" alt="" width="563"><figcaption></figcaption></figure>

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

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

{% hint style="success" %}
Таким образом вы сможете протестировать бота в реальном мессенджере.
{% endhint %}

{% hint style="success" %}
Если у вас один подключенный мессенджер к проекту, то можно не прописывать условие запуска для тестирования. Бот итак будет работать.
{% endhint %}

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

<figure><img src="/files/94B6ZTSkT15xTcXJKls8" alt=""><figcaption></figcaption></figure>

В этом поле нужно прописать:

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

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

*"Ты специалист службы поддержки, и ты знаешь только ту информацию, которая предоставлена тебе в контексте, твоя задача - отвечать на вопросы пользователей. Ты должен быть инициативным и дружелюбным".*

{% hint style="success" %}
Если модель некорректно исполняет инструкции, то можно добавить к ним примеры вопроса и ответа:

*"Ты не должен отвечать на бессмысленные сообщения, которые не связаны с контекстом.*\
*Вот тебе пара примеров таких сообщений:* \
*Контекст - заяц - это пушистое млекопитающее, Вопрос - Здравствуйте, Ответ - я не знаю ответа на ваш вопрос.* \
*Контекст - в шахте добывают уголь, Вопрос - Выключи воду, Ответ - я не знаю ответа на ваш вопрос."*
{% endhint %}

Если вы прописали в настройках бота отвечать на определенные сообщения, но при этом установили такие же условия в настройках блока в конструкторе, то отработается блок конструктора!&#x20;

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

{% hint style="danger" %}
Напоминаем!&#x20;

У <mark style="color:red;">**АИ-ассистента приоритет ниже, чем у блоков**</mark> в конструкторе чат-бота.

Сначала будут отработаны блоки!&#x20;

Если в вашей воронке существуют блоки типа "Стартовое условие", "Не состояние с условием", но в них нет условия, сначала все равно отработаются данные блоки, затем клиент пройдет по настроенной вами воронке в схеме чат-бота, и только потом подключится АИ-ассистент!
{% endhint %}

Пример:

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

<figure><img src="/files/tatWoMa0a7E4EwtjJIH2" alt=""><figcaption><p>Пример 1</p></figcaption></figure>

Также в настройках ассистента указали данные условия:

<figure><img src="/files/i7pYykfEHiI23V01lWuB" alt=""><figcaption><p>Пример 2</p></figcaption></figure>

Значит будет отработан блок, настроенный в конструкторе воронок.&#x20;

АИ-ассистент может использоваться в уже готовых воронках чат-бота, например, для случаев, которые не были предусмотрены в схеме чат-бота. Тогда на вопросы клиента, которые выходят за рамки установленных в схеме конструктора, будет отвечать АИ-ассистент.&#x20;

Это поможет закрыть все потребности ваших клиентов и увеличить их лояльность.&#x20;

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

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

Примеры:

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

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

<figure><img src="/files/4PXFmfp9atTAIfFVkAoB" alt=""><figcaption></figcaption></figure>

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

Существующая модель обучена на ВСЕ знания и информацию, содержащиеся в интернет-пространстве на момент марта 2024 года.&#x20;

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

В связи с чем существует данное поле для заполнения:&#x20;

<figure><img src="/files/Pe78Q8X9BgWGbiUBTEXs" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
При заполнении пары строчек информации о вашем ассортименте бот сможет интересно и ярко разрекламировать ваш товар или услугу.&#x20;
{% endhint %}

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

<figure><img src="/files/9e6khBEFIIVMzDNX3YJq" alt=""><figcaption><p>Использование текста</p></figcaption></figure>

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

<div><figure><img src="/files/0YyzIAekfhf2nS4eg0tG" alt=""><figcaption></figcaption></figure> <figure><img src="/files/uYsnEtgfj4p4XubVzsUN" alt=""><figcaption></figcaption></figure></div>

Пример выше показывает ассортимент услуг, которые настроены в соответствующем разделе "[Услуги](broken://pages/O7xlRksbq5SUsMYlCxL6)":

<figure><img src="/files/WYsLupogseWghQGrJ0aH" alt="" width="375"><figcaption><p>Пример ответа бота</p></figcaption></figure>

<figure><img src="/files/CpiIaUVf2OCvwpuW61MC" alt=""><figcaption><p>Настроенные услуги в филиале</p></figcaption></figure>

{% hint style="success" %}
Также в знания бота вы сможете передать значения, указанные в google-таблице: например, для интернет-магазина.&#x20;

ИИ отлично понимает значения из таблицы и использует их в своих ответах.&#x20;

Подробнее в разделе "[Для работы с google-таблицами](#dlya-raboty-s-google-tablicami)"
{% endhint %}

### Видеогид

{% embed url="<https://youtu.be/0h_DqPkouP8>" %}

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

В формате передаваемых данных вы прописываете собственно сами собираемые данные (например, имя), далее прописывается фразу с "ключом" и присваиваете значение ключу:

"Имя с ключом name, фамилия с ключом surname":

<figure><img src="/files/Ok49UU5EgxnIgNJjbszF" alt="" width="563"><figcaption><p>Пример передаваемых данных</p></figcaption></figure>

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

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXewV1Zutxrsp1xJBEoS5y_qHPT4847XFQcs5beaGmUMSwVHBq1rKxXt9TOL3Ajar3Qg9QaZids3jBPfEXHRj6ouACnozkv55H-vDNE4QCpn3M2aA4CdHcRTpV68CsErtoaysfq9luDyAA1niecLZm5hYLE?key=g9-j53ENQsA_W1hDFrramA" alt="" width="375"><figcaption></figcaption></figure>

Данный параметр является необязательным, и используется в том случае, если вам необходимо передавать информацию в систему.&#x20;

{% hint style="danger" %}
Обращаем внимание!

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

Передаваемые значения в бот и запись их в карточке клиента (в системе) зависит от формата данных, которые формирует АИ-ассистент.
{% endhint %}

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

Чтобы передавать данные в бот необходимо в [**настройках бота**](#nastroiki-bota) прописать одну из следующих команд:

1. "Скажи без изменений "Вызываю блок <mark style="color:green;">**44**</mark>"" - где "вызываю блок" отладочная команда, а вместо цифр указывается ID блока.

Данная команда понадобится для тестирования и понимания правильности передаваемых данных при настройке бота:

<div><figure><img src="/files/BqUBLeucCAXcvS60bU0N" alt=""><figcaption><p>Переменные сделки в карточке клиента</p></figcaption></figure> <figure><img src="/files/RqW1HupVGSAL3diAKtbR" alt=""><figcaption><p>Данные и значения</p></figcaption></figure></div>

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

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

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

2. "Напиши без каких-либо изменений "start\_block\_from\_ai <mark style="color:green;">**44**</mark>"" - команда также передает информацию в бот. Вместо цифр, помеченных зеленых цветом, прописывается ID блока.

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

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

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

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

#### В чем отличие команд для вызова блока

Как было указано ранее, "Вызываю блок N" понадобится для тестирования, чтобы вы НАГЛЯДНО просмотрели, верно или неверно отрабатываются настройки вызова блока и какие параметры передаются.

<figure><img src="/files/3YwWUITx55D9bBvZkjDR" alt="" width="375"><figcaption></figcaption></figure>

Если прописать команду "Вызываю блок \*ID блока\*", то в сообщениях бота Вы увидите переменные и значения, которые записывает ассистент в систему.

Если прописать команду "start\_block\_from\_ai \*ID блока\*", то переменных в сообщении бота уже видно не будет:

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

{% hint style="warning" %}
Обращаем внимание!&#x20;

После отладки настроек чат-бота с ИИ, замените команду "Вызываю блок 44" на "start\_block\_from\_ai 44". Тогда клиент НЕ увидит переменные, передаваемые ботом в систему.
{% endhint %}

### Видеогид

{% embed url="<https://youtu.be/qF_u4h5nAJY>" %}

{% embed url="<https://www.youtube.com/watch?v=9DEZ7dMH3nU&feature=youtu.be>" %}

## Остальные параметры

### **Сообщение, если ответ занимает много времени**

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

<figure><img src="/files/poOajWXBTT57BgxxyAvI" alt="" width="563"><figcaption></figcaption></figure>

### **Время перед отправкой сообщения о задержке текста**

<figure><img src="/files/v1a89qmDHZU2hAnHS5jT" alt="" width="563"><figcaption></figcaption></figure>

Данное поле, принимающее числовое значение, относится к предыдущему параметру настройки: здесь настраивается **время** ожидания, после которого направляется сообщение о задержке формирования запроса.&#x20;

Принимает числовое значение в секундах: от 2 до 25.&#x20;

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

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

<figure><img src="/files/t0kTUuwSq3glcRffsW2T" alt="" width="426"><figcaption></figcaption></figure>

Параметр вводится в значении от 0,0 до 1 (0,1, 0,2 и пр.)

{% hint style="success" %}
Для задач, где нужна опора на текст и точные ответы, приоритетнее ставить значения близкие к нулю, поскольку в таком случае модель не сможет вводить в заблуждение ваших клиентов.&#x20;

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

{% hint style="success" %}
Если не уверены, какое значение нужно указать для выбранной вами роли ассистента, оставьте поле пустым – для каждой уже установлены оптимальные значения по умолчанию.
{% endhint %}

### Максимальное количество слов

<figure><img src="/files/s4yQq6FnCUmGpOm7LFi7" alt="" width="492"><figcaption></figcaption></figure>

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

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

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

Телеграм - 4096 символов

Вконтакте - 4096 символов

Инстаграм<mark style="color:red;">**\***</mark> - 1000 символов

Whatsapp - 4096 символов

Viber - 1000 символов\
\ <mark style="color:red;">**\***</mark>принадлежит компании Meta, деятельность которой признана экстремистской и запрещена на территории России.&#x20;
{% endhint %}

## Полезные советы

### Ограничение на токены

Модель принимает на вход 128 тысяч токенов, где один токен равен примерно двум символам латиницы и четырем символам кириллицы..

### Введение в заблуждение пользователя

Если модель вводит в заблуждение клиентов и говорит о несуществующих услугах и товарах, то можно поставить галочку “Минимизацией фантазий" в списке "[Заготовленные настройки](#zagotovlennye-nastroiki)", а также попробовать уменьшить креативность модели.&#x20;

{% hint style="warning" %}
Обращаем внимание! \
Бот запоминает историю переписки.&#x20;

Если вы изменили его настройки, рекомендуется удалить текущий диалог и начать новый. В противном случае, бот будет продолжать общение на основе предыдущих сообщений, так как для него история переписки важнее новых настроек.
{% 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.salebot.pro/chatbots/ai_assistant/settings.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.