Шаг «Запуск агента»

Шаг «Запуск агента» нужен, когда агент должен подготовить результат для автоматизации: текст, вложения или кнопки. Автоматизация сохранит этот результат в переменные, а вы решите, что делать дальше — например, отправить его лиду шагом «Сообщение».

Этот шаг не назначает агента на диалог и сам ничего не отправляет клиенту. В переписке оператор увидит сворачиваемое техническое событие «Автоматизация передала запрос агенту» с именем выбранного агента. Оно помогает понять, почему агент начал работу, но не является сообщением клиенту. Клиент увидит результат только после того, как его отправит шаг «Сообщение». Для постоянного назначения агента используйте «Добавить в агента».

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

Добавьте шаг и выберите агента

1. Добавьте в схему действие «Запуск агента» и откройте его настройки.
2. В поле «Агент» выберите агента проекта.
3. Решите, нужна ли агенту история текущего диалога.

Настройка «Передавать историю диалога» включена по умолчанию. Оставьте её включённой, если при подготовке ответа нужно учитывать предыдущие сообщения. Если её выключить, для ответа будут использованы только команда, переданная кнопка и вложения. Это сокращает объём контекста, но тогда у запуска должен быть хотя бы один фактический вход: команда, файл, вложение из переменной или уже нажатая кнопка.

Передайте команду и вложения

В поле «Команда агенту» напишите, какой результат нужен. Здесь работают те же шаблоны данных и переменных, что и в тексте шага «Сообщение». Например, можно передать имя лида или результат предыдущего шага.

Через скрепку можно:

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

Загруженные файлы и вложения из переменной объединяются. После объединения их должно быть не больше 10.

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

Поле «Нажатая кнопка из переменной» необязательно. Оно используется в повторном запуске агента после сообщения с динамическими кнопками. При первом запуске такой переменной ещё может не быть — это нормально.

Сохраните ответ в переменные

В блоке «Ответ агента» выберите место хранения для каждого результата. На кнопке выбора показываются область и имя, например «Процесс · agent_response_text»:

• «Процесс» — результат нужен только этому запуску и доступен как {{run.имя}};
• «Лид» — результат сохраняется у текущего лида и остаётся доступным следующим процессам как {{lead.имя}};
• «Диалог» — результат сохраняется для текущей переписки и доступен как {{dialog.имя}};
• «Проект» — результат становится общим значением проекта и доступен как {{project.имя}}.

Затем укажите, что именно нужно сохранить:

• «Текст ответа» — готовый текст;
• «Вложения ответа» — файлы, которые подготовил агент;
• «Блок кнопок ответа» — кнопки для следующего шага «Сообщение»;
• «Полный ответ (JSON)» — текст, вложения, кнопки и служебный идентификатор события в одном объекте.

Список показывает только переменные подходящего типа: строку для текста, массив для вложений и кнопок, объект или JSON для полного ответа. Если подходящей переменной лида, диалога или проекта ещё нет, создайте её из окна выбора; для этого нужны права на создание таких переменных.

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

Соедините выход «Ответ» со следующим шагом. Автоматизация перейдёт по нему после того, как агент закончит работу и выбранные переменные будут заполнены.

Отправьте результат лиду

Чаще всего после «Запуска агента» добавляют шаг «Сообщение»:

1. Вставьте переменную с текстом ответа в текст сообщения, например {{run.agent_response_text}}.
2. При необходимости выберите переменную «Вложения ответа» как источник вложений.
3. Через «Добавить кнопку» создайте «Динамический блок кнопок» и выберите переменную «Блок кнопок ответа».
4. Соедините обычный выход сообщения с дальнейшей веткой схемы.

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

Продолжите диалог после нажатия кнопки

Для кнопок, которые вернул агент, шаг «Сообщение» создаёт общий выход «Кнопка нажата». Кнопки-ссылки открывают адрес и эту ветку не запускают.

Чтобы передать выбор лида агенту:

1. В шаге «Сообщение» выберите область «Процесс» и переменную в поле «Сохранить нажатую кнопку».
2. Соедините выход «Кнопка нажата» с новым шагом «Запуск агента».
3. В новом запуске выберите эту же переменную в поле «Нажатая кнопка из переменной».

В переменной сохраняются идентификатор, текст и значение кнопки. Новый запуск использует их вместе с командой при подготовке следующего ответа. Если кнопки должны срабатывать только один раз, выключите в шаге «Сообщение» повторные нажатия.

Что проверить перед публикацией

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