Настройки агента

Дата и время

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

Случайное число

Агенту доступно случайное число. На каждое диалоговое сообщение создается новое случайное число от 1 до 1000.

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

Используй случайное число % 5, чтобы выбрать ответ клиенту в качестве благодарности:
1. Спасибо за ваш отзыв!
2. Спасибо, что вы с нами!
...

Уточняющие вопросы

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

Сообщение при переводе

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

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

Собрав контактные данные клиента, переведи на оператора и ответь
"Спасибо за ваш заказ, сообщим о готовности."

Раздельные документы

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

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

Работа с изображениями

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

• Прикреплены как вложения в вашем хелпдеске.
• Указаны в тексте сообщения пользователя в виде ссылки.

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

Поддерживаемые форматы изображений: jpeg, png, gif, webp.

Анализировать аудио

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

• Прикреплены как вложения в вашем хелпдеске.
• Указаны в тексте сообщения пользователя в виде ссылки.
• Максимальная длительность аудио — 2 минуты, размер — до 35 МБ.

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

Результат транскрибации аудио можно посмотреть в Журнале в Анализе сообщения.

За успешную транскрибацию взымается плата — 1 кредит.

Без оператора

Агент всегда продолжает общение и не передаёт диалог оператору.

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

Ссылки на статьи

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

Пример инструкции:

Добавь в конце своего ответа ссылку на инструкцию, по которой был сделан ответ.
Не используй форматирование markdown для ссылки.

Это позволит боту подкрепить свой ответ релевантной инструкцией.

Отключение базы знаний

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

Фильтровать по тегам БЗ

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

Что такое теги

Каждый документ в базе знаний (страница сайта, PDF, DOCX и т.д.) может быть помечен тегом — произвольной строкой. Теги задаются вручную в базе знаний: для отдельных страниц или сразу для всего источника данных.

Теги также поддерживаются для записей первой линии — каждая запись может иметь один тег.

Настройка

1. Проставьте теги на документы в базе знаний: перейдите в раздел База знаний → выберите источник данных → для каждой страницы или всего источника установите тег через меню «Установить тег».
2. В настройках агента включите «Фильтровать по тегам БЗ».
3. Добавьте в инструкцию агента описание того, когда и какие теги использовать при поиске.

Пример

Бот обслуживает несколько регионов (Москва, Санкт-Петербург), документы в базе знаний помечены тегами moscow и spb. Нужно, чтобы агент отвечал только по документам нужного региона.

Фрагмент инструкции агента:

Шаг 1. Уточни регион пользователя.

Шаг 2. Ищи информацию в базе знаний и используй соответствующий тег:
- Москва → tags: ["moscow"]
- Санкт-Петербург → tags: ["spb"]

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

Совместные данные

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

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

Пример инструкции:

При получении номера заказа сохрани его по ключу 'заказ' в совместные данные и
перейди к сценарному агенту 'order_info'

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