Блок «Агент»

С помощью блока «Агент» вы можете добавить в процесс AI-агента — умного помощника на основе LLM, который сам принимает решения для достижения цели. Он способен гибко отвечать на вопросы, уточнять информацию и вызывать нужные инструменты, как это сделал бы живой оператор.

Например, если пользователь хочет оформить банковскую карту, агент может уточнить его данные, самостоятельно создать заявку на выпуск карты и сообщить номер заявки пользователю:

Как добавить агента на холст

1. Перейдите в проект и на левой панели нажмите , чтобы открыть конструктор процессов.
2. В верхнем левом углу холста нажмите  — откроется список блоков.
3. Перетащите блок Агенты → Агент на холст.

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

Чтобы изменить настройки агента:

1. Нажмите на блок Агент на холсте.
2. В открывшемся окне укажите настройки.
3. Нажмите Сохранить.

Основные настройки

В поле Настройки → Основные → LLM выберите существующую интеграцию с LLM или добавьте новую. Если вы создадите новую интеграцию, она станет доступна в разделе Интеграции.

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

предупреждение

Для работы агента выбранная модель LLM должна поддерживать function calling. Вы можете найти информацию о поддержке function calling в официальной документации самой модели — например, на сайте OpenAI, Google Gemini и т. д.

Промты

В разделе Настройки → Промты заполните следующие поля:

Поле	Описание	Пример
Роль	Роль или персона агента в диалоге. Влияет на тон общения и на то, как агент отвечает на вопросы о себе.	Сотрудник банка
Цель	В диалоге агент будет пытаться выполнить указанную цель.	Создай заявку на выдачу банковской карты
Инструкции	Представьте, что вы даете задание новому сотруднику. Здесь укажите, как именно он должен выполнить свою работу: с чего начать, какие шаги предпринять и какие инструменты использовать.	Сначала уточни номер телефона. После этого создай заявку c помощью функции Application.create. Отвечай коротко и всегда на русском языке
Запрос для агента	Текст, который будет обрабатывать агент. По умолчанию агент берет текст из последнего сообщения пользователя. Заполните это поле вручную: Если запускаете агента без сообщения — по триггерам Планировщик, Вебхук, IMAP Email. Смотрите пример в статье Работа агента в процессе. Если хотите изменить или дополнить запрос пользователя перед отправкой в агента. Настройка игнорируется, если у агента включен Режим диалога.	Условия новой акции: {{ Context.getLastFunctionResult() }}

подсказка

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

Генерация и поведение

В разделе Настройки → Генерация и поведение вы можете управлять параметрами генерации ответов и действиями агента после генерации.

Поле	Описание
Температура	Регулирует креативность ответов. При высоких значениях результаты будут более творческими и менее предсказуемыми. Не рекомендуем менять параметры Температура и Top P одновременно.
Top P	Регулирует разнообразность ответов. При низких значениях нейросеть выбирает из меньшего количества вероятных слов, а при высоких — ответ может получиться разнообразнее. Не рекомендуем менять параметры Температура и Top P одновременно.
Presence penalty	Снижает вероятность повторного использования слов в тексте. Помогает сделать ответ разнообразнее по лексике.
Frequency penalty	Снижает вероятность слишком частого повторения одних и тех же слов. Уменьшает риск того, что агент будет зацикливаться на одинаковых фразах.
Максимальный размер ответа, в токенах	Максимальное количество токенов, которое модель может сгенерировать за одну итерацию.
Отправлять ответ пользователю	По умолчанию агент сразу отвечает пользователю в чат. Вы можете отключить эту опцию, чтобы использовать агента как функцию. Подробнее смотрите в статье Работа агента в процессе.
Режим диалога	Включите, чтобы агент мог продолжать диалог с пользователем, не переходя к другим блокам процесса. Подробнее смотрите в статье Работа агента в процессе.

Поведение в процессе

На вкладке Процесс вы можете настроить логику переходов между блоками в процессе.

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

Телефонный агент

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

На вкладке Настройки включите опцию Телефонный агент. После этого появятся настройки поведения в разговоре.

примечание

Эти настройки не влияют на текстовых агентов. Они применяются только при звонках.

Параметры LLM

Лимит ожидания текста от LLM (мс) — максимальное время, которое агент будет ждать ответа от LLM. Если LLM не начала отвечать за это время, дальнейшее поведение зависит от опции Режим диалога:

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

подсказка

Если вы настроили Заполнение пауз, то таймер ожидания ответа запустится только после такой паузы. Например, при включенном заполнении пауз (2000 мс) и лимите (5000 мс):

1. Агент подождет 2 секунды.
2. Начнет воспроизводить фразу-филлер и параллельно будет ждать ответа LLM в течение 5 секунд.

Суммарно бот будет ждать ответа 7 секунд.

Обработка перебиваний

Поле	Описание
Действие агента	Настройте, что должен сделать агент, если клиент его перебивает: Не реагирует — агент полностью озвучит ответ и только после этого будет слушать клиента. Прерывает ответ сразу — агент сразу остановится и начнет слушать клиента.
Что считает перебиванием	Законченную фразу клиента — агент будет говорить одновременно с клиентом и среагирует, только когда клиент полностью закончит свою мысль. Начало речи — перебивание сработает сразу, когда клиент начнет говорить.
Отложить перебивание (мс)	Агент обязательно проговорит этот отрезок времени, даже если клиент начнет его перебивать. Это полезно, чтобы клиент услышал самую важную часть информации. Отсчитывается от начала ответа агента. Если клиент перебьет агента в это время, агент договорит защищенный фрагмент и только потом отреагирует на реплику клиента.

Заполнение пауз

Пока LLM генерирует текст, возникает пауза в речи агента. Вы можете настроить заполнение этих пауз, чтобы разговор с агентом звучал более естественно:

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

   • «Понял, сейчас поищу информацию»
   • «Хорошо, уточняю»
   • «Подождите пару секунд, я проверю»

2. Укажите длину паузы в поле Сказать фразу, если молчание длится (мс). Если в начале ответа возникла пауза такой длины, то агент произнесет одну случайную фразу.

   предупреждение

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

Подключение инструментов к агенту

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

Чтобы подключить инструмент:

1. Перетащите любую функцию на холст.

2. Нажмите на блок функции:

   1. В открывшемся окне включите Режим инструмента и выберите параметры, которые должен заполнить агент при вызове функции.
   2. Нажмите Сохранить.

3. Соедините блок функции с блоком Агент.

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