О функциях

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

Создание функции

1. Создайте функцию на странице «Агенты → Редактирование → Функции», нажав кнопку «Создать».
2. Введите «Название» и «Описание» функции и нажмите кнопку «Создать».

Для настройки деталей функции нажмите на функцию.

Детали функции

В этом блоке задаются основные свойства функции:

• Название функции — техническое имя (латинские буквы, цифры, _ и -).
• Описание функции — самая важная часть: по нему агент понимает, в каких случаях нужно вызвать функцию. Чем понятнее описаны назначение и условия вызова, тем точнее агент будет её применять.
• Статус функции — переключатель «Активна/Неактивна». Неактивная функция агентом не используется.

Параметры функции

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

Для каждого параметра указываются:

• Название — идентификатор параметра (латинские буквы, цифры, _).
• Тип параметра — «Текстовый» или «Числовой».
• Инструкция — описание, что это за параметр и как определить его из диалога.
• Возможные значения — список допустимых вариантов (если нужно ограничить выбор).
• Обязательный параметр — если включено, агент не выполнит функцию, пока не получит это значение.

Чтобы добавить параметр, нажмите «Добавить параметр».

Реакция на выполнение функции

Здесь настраивается, как агент поведёт себя сразу после выполнения функции. Доступные варианты:

• Ничего не делать — агент продолжит диалог без отдельной реакции.
• Вывести сообщение пользователю — агент отправит заданный вами текст (указывается в поле «Инструкция»).
• Задать инструкцию интерпретации — вы описываете, как агенту трактовать результат, и он сформулирует ответ сам (указывается в поле «Инструкция»).
• ИИ-агент сам решит — агент самостоятельно решит, как отреагировать.

Пост-сценарий

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

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

Отправка результатов

В этом разделе настраивается, куда будут передаваться данные из функции.

Доступные платформы для отправки результатов:

• Битрикс — подробнее в разделе Функции → Bitrix.