Вызов действий по триггеру

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

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

Добавить Вызов действий по триггеру можно через вкладку "Условия выполнения" внутри настраиваемого действия.

Отключите флаг Вызывать моделью

И добавьте условие срабатывания

Настройка срабатывания вызова события

Выбираем Обязательное условие

Описание и настройка Обязательного условия

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

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

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

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

Далее в выпадающем меню необходимо выбрать тип Дополнительного условия для этого действия

Описание и настройка Типов Дополнительных условий

• Переменная — условие будет проверяться по наличию в диалоге выбранной переменной.

• Вызван файл — условие будет проверяться по выбранному из Базы Знаний файлу, т.е. был ли уже вызван в диалоге выбранный файл.

• Вызвана функция — условие будет проверяться по наличию в диалоге вызова определённой функции. Например, вызов таблицы или редактирование полей в Битрикс24.

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

• Источник связи — условие будет проверяться по каналу коммуникации, с которого пришло обращение клиента. Например, Авито, Телеграм или Амо.

• Фраза ответа от бота — условие будет проверяться по наличию в ответе Бота ключевой фразы.

• Фраза во входящем сообщении — условие будет проверяться по наличию в сообщении клиента ключевой фразы.

• LLM-инструкция — данная инструкция позволяет прописать проверку выполнения условий для вызова настраиваемого действия. Например: Если в диалоге шло обсуждение стоимости Тогда True Иначе False КонецЕсли

• Содержимое входящего сообщения - условие, которое основано на типе сообщения. Доступен выбор следующих типов: Файл, Аудио, Изображение и Текст.

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

Настройка проверки выбранного типа тоже достаточно гибкая и включает в себя такие проверки, как: равно / не равно / больше / больше или равно / меньше / меньше или равно / содержит / не содержит

Для того, чтобы настроить несколько Дополнительных условий, выберите условие И / ИЛИ и нажмите знак ➕

• Условие И означает, что все условия должны быть выполнены одновременно

• Условие ИЛИ означает, что хотя бы одно из всех условий должно быть выполнено

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

Пример настройки

Рассмотрим пример Вызова файла БЗ через Действие с использованием Условий срабатываний.

1. Выбираем Тип действия, выбираем нужный файл

1. Настроим Условия срабатывания — нашем случае выбираем по триггерному слову "сотрудничество" в сообщении от клиента

Название функции fetch_direct_questions_doc

1. Дополнительно добавим ещё одно отдельное действие — вызов ещё одного файла с оповещением администратора при запросе номера. Триггером будет служить слово "номер" в сообщении бота

Название функции fetch_direct_questions_document

1. В результате получаем следующий диалог

• Отработал триггер на слово "сотрудничество", бот вызвал функцию fetch_direct_questions_doc

• Отработал второй триггер на слово "номер", бот вызвал функцию fetch_direct_questions_document