РУКОВОДСТВО ПО NEUROSPACE

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

Начало
→
Действия: как добавлять и настраивать

Действия — это расширенные возможности чат-ботов NeuroSpace. С помощью данного функционала вы можете задавать чат-боту дополнительные действия, которые он будет выполнять при срабатывании определенных условий или триггеров, описанных в промте чат-бота. Например, генерировать текст, запускать или останавливать диалог. На данный момент в системе есть четыре типа действий: «Генератор текста», «Остановка работы чат-бота», «Запуск работы чат-бота» и «Удаление диалога». Список возможных типов действий будет пополняться.

Содержание:

Как добавить действие
Управление действиями
Пример с генерацией стихотворения
Пример с отправкой напоминания о визите в салон
Пример с отправкой промокодов и заявками

Как добавить действие

1

В списке чат-ботов, в строке с нужным чат-ботом, нажмите на многоточие и в меню управления выберите пункт «Действия».

2

Нажмите на кнопку «+ Новое действие».

3

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

Укажите имя действия. Имя должно быть написано на латинице. В качестве пробела используйте нижнее подчеркивание (_). Например: code_ok

В поле «Описание» укажите описание действия. Например: Генерация стихотворения. Описание отображается в общем списке действий и будет видно только вам.

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

«Генератор текста» — после срабатывания определенного условия чат-бот будет генерировать текст в соответствии с промтом к действию и выбранной GPT-моделью. Позволяет дополнительно передавать в диалог контекст по команде, чтобы формировать ответ на основе персонализированного контекста и промта действия.
«Остановка работы чат-бота» — после срабатывания определенного условия чат-бот будет приостановлен навсегда в диалоге с клиентом спустя заданный промежуток времени или сразу. Например, когда нужно, чтобы чат-бот не прощался дважды в одном эпизоде диалога.
«Запуск работы чат-бота» — чат-бот продолжает диалог через определенный таймаут или при срабатывании условия. Например, чтобы напоминать о визите в салон или при получении файла от пользователя. Вы можете выбрать способ генерации ответа: на основе контекста диалога и основного промта, на основе инструкции к данному типу действия, отправка единого статичного сообщения.
«Удаление диалога» — очистка истории диалога или удаление диалога при срабатывании определенных условий спустя заданный промежуток времени или сразу.

Далее заполнение формы зависит от выбранного типа действия.

Если выбран тип «Генератор текста»:

Выберите GPT-модель, которую бот должен использовать для генерации текста. В этом случае при обращении к действию чат-бот будет переключаться на выбранную модель. Поле обязательно для заполнения.
Пропишите промт для генерации текста. Например: Сгенерируй стихотворение на русском языке. Или: Если клиент отправил промокод, скажи, что промокод успешно принят и запроси контактные данные для записи. Поле обязательно для заполнения.

Чтобы действие сработало, обязательно пропишите в основном промте к чат-боту условие, когда бот должен его выполнять. Например: Если клиент просит написать стихотворение, запусти действие write_poem.

— Передача контекста

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

В основном промте чат-бота укажите, какие данные нужно брать в контекст при обращении к данному действию. Например: Если клиент спрашивает, сколько тем или уроков пройдено и осталось, запусти действие check с данными "Прогресс". Это означает, что в контекст будут переданы данные с расчетом текущего прогресса по курсу.

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

Для просмотра переданного контекста нажмите на сообщение чат-бота.

Если выбран тип действия «Остановка работы чат-бота»:

Укажите таймаут — через какой период должен быть приостановлен чат-бот (в минутах). В поле указывайте только значение — без единиц измерения. Например: 10. Это значит, что чат-бот будет остановлен через 10 минут. Если чат-бот должен быть остановлен сразу, проставьте в поле значение «0». Поле обязательно для заполнения.

Пропишите в промте директиву. Например: Если клиент сообщил номер телефона, запусти действие bot_stop.

Если выбран тип действия «Запуск работы чат-бота»:

Контекст диалога — для генерации ответа или выполнения другого сценария чат-бот будет использовать контекст диалога с клиентом. Например, в основном промте чат-бота вы можете указать директиву: «После того как ты создал запись и забронировал клиента, запусти действие remind_24_hours с датой и временем ровно за 24 часа от даты и времени бронирования» и в качестве способа генерации ответа выбрать «Контекст диалога».

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

Статичное сообщение — пропишите единое сообщение, которое должен отправлять клиентам.

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

Если выбран тип «Удаление диалога»:

Выберите, какое действие должен выполнить чат-бот:

«Очистка диалога» — чат-бот очистит историю диалога с клиентом. Например, при завершении конкретной сделки или запроса, когда вся информация перенесена в CRM-систему.
«Удаление диалога» — чат-бот удалит диалог с клиентом. В этом случае следующее обращение клиента будет расцениваться как новый диалог, а в CRM будет создана новая сделка, если чат-бот интегрирован с CRM. Например, когда клиент пишет «стоп» или «хватит».

«Минуты» — укажите, через сколько минут после срабатывания определенных условий должен быть удален или очищен диалог. В поле указывайте только значение — без единиц измерения. Например: 10. Если чат-бот должен быть остановлен сразу, проставьте в поле значение «0». Поле обязательно для заполнения.

Чтобы действие сработало, обязательно пропишите в основном промте к чат-боту условие, когда бот должен его выполнять. Например: Если клиент написал слово «стоп», запусти действие delete.

4

Опция «Статус» позволяет активировать и деактивировать действие в любой момент.

5

Нажмите на кнопку «Создать».

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

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

Опция «Не передавать результат функции в контекст» в настройках чат-бота не распространяется на функции действий.

Управление действиями

Как изменить или удалить действие

Перейдите в раздел с действиями и в строке с нужным действием нажмите на многоточие. Выберите «Редактировать» или «Удалить».

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

Как включить или выключить действие

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

Примеры с отработкой действий

Приводим примеры настройки действий для генерации текста, приёма промокодов, отправки напоминаний о записи в салон.

Генерация текста на примере стихотворения

Вот пример отработки действия «Генерация текста»:

1

В разделе Действия добавили действие poem и прописали, что требуется от чат-бота. Например: Уточни, в каком стиле нужно написать стихотворение и на какую тему. После ответа напиши стихотворение на русском языке.

2

В основном промте чат-бота (через настройки) мы прописали директиву: Если клиент попросил написать стихотворение, запусти действие poem.

3

Переходим в диалог с чат-ботом и просим его написать стихотворение. Чат-бот в соответствии с директивой запускает действие poem и уточняет стиль и тему. После получения ответа — выполняет нужное действие.

Напоминание о записи в клинику

Следующие пример — отработка действия с типом «Запуск чат-бота» для отправки сообщения клиенту с напоминанием о визите в клинику.

1

В разделе Действия мы добавили действие с типом «Запуск чат-бота» и выбрали тип на основе контекста диалога.

2

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

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

3

Через нашего чат-бота мы записались в стоматологическую клинику на чистку зубов. За час до визита чат-бот отправил нам напоминание.

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

Получение промокода + передача данных в Заявки (онлайн-школа)

Третий пример — отработка комплексного действия. Что мы хотим получить от чат-бота:

Допустим, мы запустили рекламу через блогеров с рекламой мастер-классов в нашей онлайн-школе, которые будут проводиться в определенные даты. Они рекламируют наши мастер-классы и оставляют промокод со ссылкой на чат-бота.
Клиент переходит в чат-бота, пишет ему, что хочет записаться на мастер-класс, и отправляет промокод.
Чат-бот генерирует ответ в соответствии с директивой и указаниями к действию.
Заявка с записью на мастер-класс и контактами клиента попадает в панель диалогов чат-бота.

Как мы это реализовали:

1

В разделе Действия мы добавили действие code_ok_2511 (оно относится к мастер-классу, который пройдет 25 ноября) с типом «Генерация текста» и прописали к нему промт: Поблагодари клиента и сообщи, что промокод успешно применен. Скажи, что для записи на "Мастер класс [название]" тебе нужно, чтобы клиент прислал своё имя и номер телефона.

*Данное действие должно срабатывать только при условии, если клиент отправил корректный промокод.

2

Помимо этого действия мы добавили еще одно с типом «Генерация текста», в соответствии с которым чат-бот должен сообщать, что промокод неверен. Промт: Если клиент прислал сообщение не с промокодом [промокод], сообщи, что промокод недействителен.

3

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

4

Чтобы заявки на мастер-классы попадали в панель диалогов, в разделе Поля заявок мы активировали сбор таких данных, как: ФИО, номер телефона, промокод. Также можно добавить поле «Название мастер-класса», например, или другие ключевые данные.

5

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

6

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