Искусственный интеллект

Раздел «ИИ» позволяет создавать сценарии на основе искусственного интеллекта и привязывать их к командам чат‑бота. Сценарий управляет тем, как бот ведёт диалог с пользователем: задаёт вопросы, собирает данные, подтверждает ответы и в финале отправляет структурированную команду обратно в CRM для выполнения действия (например, создания сделки).

Где найти и как создать сценарий

Перейдите в рабочую область «Система» (левый верхний угол).
В боковом меню откройте раздел «ИИ».
Нажмите «Добавить сценарий».

Заполните форму:

Наименование — понятное название сценария (например, «Подбор недвижимости»).
Промпт — текстовая инструкция для ИИ, определяющая логику диалога.

После сохранения сценарий появится в списке. Чтобы активировать его, привяжите к нужной команде бота: в разделе «Чат‑бот» откройте форму команды и выберите сценарий в поле «Команда AI».

Как устроен промпт

Промпт — это набор правил, по которым ИИ ведёт диалог с пользователем. Чем точнее правила, тем предсказуемее поведение бота. Рассмотрим на примере рабочего промпта для подбора недвижимости.

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

0 ПЕРВЫЙ ПРИОРИТЕТ: Если "История переписки" пустая (нет предыдущих сообщений):

Начинай ТОЛЬКО с: "Здравствуйте! Помогу подобрать подходящий вариант. Уточните: покупка или аренда?" Игнорируй ВСЕ данные из текущего сообщения пользователя.

1 Всегда начинай с приветствия: "Здравствуйте! Помогу подобрать подходящий вариант."

2 Собирай информацию строго по порядку, если она еще не указана в истории переписки:

   - Покупка или аренда?

   - Сколько комнат нужно?

   - Район или метро?

   - Бюджет в месяц?

3 На каждый шаг задавай ровно один вопрос из списка выше, если предыдущие уже собраны.

4 Если информация уже есть в истории переписки — подтверди её и переходи к следующему шагу.

5 Отвечай кратко, дружелюбно и по-деловому. Не добавляй лишнего текста.

6 После сбора ВСЕХ 4 параметров** пиши ТОЛЬКО:

'Ваша заявка принята {"action":"request", "data":{"type":"[реальный_type]","rooms":"[реальное_число]","district":"[реальный_район]","budget":"[реальная_сумма]"}}' 

(заменяй [скобки] на данные из диалога, сохраняя ВСЕ кавычки и запятые)

Примерный сценарий:

Пользователь: "Ищу квартиру"

Ты: "Здравствуйте! Помогу подобрать подходящий вариант. Уточните: покупка или аренда?"

Пользователь: "Аренда"

Ты: "Отлично! Сколько комнат нужно?"

И так далее...

История переписки:

Пользователь: "Добрый день!"

{{story}}

Отвечай только на основе этих правил и истории.

Структура промпта

Блок	Назначение
Роль	Задаёт характер ассистента: «дружелюбный ассистент по поиску недвижимости».
Правила диалога	Пошаговая инструкция: что спрашивать, в каком порядке, как отвечать.
Сценарий	Пример обмена репликами, чтобы ИИ понимал формат.
История переписки	Переменная `{{story}}` — в неё CRM подставляет предыдущие сообщения, чтобы ИИ знал контекст.
Команда агенту	Структурированная JSON‑строка, которую ИИ выводит в финале для передачи данных в CRM.

Ключевые механики промпта

1. Приоритет первого сообщения.

Если история переписки пуста (диалог только начался), ИИ игнорирует содержимое первого сообщения пользователя и выдаёт строго заданную фразу: «Здравствуйте! Помогу подобрать подходящий вариант. Уточните: покупка или аренда?» Это гарантирует единообразное начало диалога.

2. Сбор данных по порядку.

ИИ последовательно собирает четыре параметра:

Тип сделки (покупка или аренда).
Количество комнат.
Район или станция метро.
Бюджет.

На каждом шаге задаётся ровно один вопрос. Если параметр уже есть в истории переписки — ИИ подтверждает его и переходит к следующему.

3. Переменная истории {{story}}.

В промпт встроена переменная {{story}}, в которую CRM подставляет предыдущие сообщения диалога. Благодаря этому ИИ «помнит» контекст и не повторяет уже заданные вопросы.

4. Финальная команда.

Когда все четыре параметра собраны, ИИ выводит не свободный текст, а структурированную строку в формате JSON. Эта строка передаётся в CRM, где система распознаёт команду и выполняет соответствующее действие.

Команды агенту

Когда ИИ завершает сбор данных, он выводит строку вида:

Ваша заявка принята {"action":"request", "data":{"type":"аренда","rooms":"2","district":"Бутово","budget":"50000"}}
CRM распознаёт JSON‑объект внутри строки и выполняет действие, указанное в поле action.

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

Команда (action)	Описание	Действие CRM	Параметры (data)
`request`	Заявка на подбор недвижимости	Создаётся новая сделка	`type` — тип сделки (покупка/аренда), `rooms` — количество комнат, `district` — район или метро, `budget` — бюджет

Поля данных команды request

Поле	Описание	Пример значения
`type`	Тип сделки	`"аренда"` или `"покупка"`
`rooms`	Количество комнат	`"2"`
`district`	Район или станция метро	`"Бутово"`
`budget`	Бюджет (в месяц для аренды, всего для покупки)	`"50000"`

Практический пример диалога

Шаг	Пользователь	Ответ ИИ
1	«Ищу квартиру»	«Здравствуйте! Помогу подобрать подходящий вариант. Уточните: покупка или аренда?»
2	«Аренда»	«Отлично! Сколько комнат нужно?»
3	«Двушку»	«Хорошо. Какой район или метро?»
4	«Рядом с Бутово»	«Понял. Какой бюджет в месяц?»
5	«50 тысяч»	`Ваша заявка принята {"action":"request", "data":{"type":"аренда","rooms":"2","district":"Бутово","budget":"50000"}}`

После последнего сообщения CRM автоматически создаёт новую сделку с заполненными полями.

Важные нюансы

Промпт должен содержать чёткие правила формата финальной строки — если ИИ «разгуляется» и добавит лишний текст, CRM не распознает команду.
Переменная {{story}} обязательна: без неё ИИ не будет помнить предыдущие ответы и начнёт задавать вопросы по кругу.
Формат финальной строки чувствителен к кавычкам и запятым — в промпте указано «сохранять ВСЕ кавычки и запятые», и это важно для корректного парсинга JSON.
Один сценарий ИИ можно привязать к разным командам бота (например, /start и /search), чтобы пользователь мог начать подбор с любой из них.