Взаимодействие с агентом

Как агент получает запрос, собирает контекст, действует и отвечает. Страница для разработчиков, которые строят интеграцию.

Как это работает

Получение события

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

Сбор контекста

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

Выполнение действий

Агент выполняет нужные действия — отправляет сообщения, создаёт задачи, вызывает внешние сервисы. Реакция-индикатор показывает пользователю, что агент работает.

Ответ

Результат агент отправляет обратно в тред или в личные сообщения и снимает реакцию-индикатор.

Полный формат событий и payload — в гайде по исходящим вебхукам.

Практические советы

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

Реакция agent-thinking

Создайте кастомную реакцию с именем agent-thinking и загрузите анимированную иконку. Когда агент ставит эту реакцию на сообщение, интерфейс Пачки автоматически показывает живой таймер вместо счётчика — пользователь видит, сколько секунд агент уже работает. Таймер отображается до 5 минут. При POSTдобавлении реакции передайте параметр name со значением agent-thinking.

Таймер реакции agent-thinking