Botpress: ИИ-агент для диалогов и заявок

Botpress — облачная платформа ИИ-агентов с открытым API: диалоги, сообщения, пользователи, участники и боты. Карточка для клиентского сервиса, который держит несколько ботов и хочет видеть их диалоги и заявки в одном месте.

Агент — это программа, которая делает дело целиком, а не отвечает на вопрос. Вы формулируете задачу, он сам выбирает, откуда взять данные и куда положить результат. Три признака: работает в ваших сервисах, доводит до результата, работает без вас. Чат-бот вернёт текст в окно диалога, агент вернётся, когда заявка заведена и сводка собрана.

Коннектор — описание подключения Agenova к Botpress: где взять токен, как проверить связь и какие данные доступны. Здесь доступ выдаётся персональным токеном в разделе аутентификации Botpress Cloud, и агент передаёт его в заголовке запроса. Это не плагин и не доработка бота. Пароль не хранится: агент работает только с выданным токеном.

В документации три части API: Chat API с диалогами, сообщениями, участниками и событиями, Admin API с ботами, рабочими пространствами, интеграциями, журналом аудита, логами и аналитикой бота, и Files API. Собирают ботов в Studio или в ADK — библиотеке на TypeScript, каналы подключаются через интеграции и webchat.

### Входящая корреспонденция: регистрация и резолюция

Агент читает список диалогов и сообщений через Chat API, находит те, где посетитель оставил контакт или просьбу, и заводит обращение: тема, канал, участник, время. Резолюцию он готовит по вашим правилам — кому и что делать.

### Заявки из почты, форм и мессенджеров

Агент сводит заявки из каналов Botpress и из внешних форм в один список: приводит поля к общему виду, отсекает дубли по идентификатору пользователя и тексту, при необходимости создаёт событие через Chat API. Так заявка из webchat и письмо из формы попадают в одну очередь, а не в две разные.

### Сводки по обращениям: день и месяц

Агент собирает сводку по диалогам и заявкам за день или месяц: сколько начато, сколько доведено до контакта, где бот не справился и передал человеку. Через Admin API он добавляет состояние ботов и ошибки из логов, чтобы сводка объясняла причину, а не только показывала число.

Сценарий, роли участников и передача диалога живому оператору — за человеком. Агент показывает, где бот не справился, но правила эскалации задаёт сотрудник.

Токен создаётся в аккаунте Botpress Cloud в разделе аутентификации; в документации описаны персональные токены и ограничение частоты запросов. Нужны облачный аккаунт и хотя бы один бот с каналом. Хватит одного рабочего пространства, чтобы начать с чтения диалогов.

Не пишет сценарии вместо вас и не включает бота на новом канале без согласования. Не хранит переписку дольше, чем нужно делу. Не обходит лимит запросов: при упоре в ограничение он подождёт и скажет об этом.

Что такое агент, если коротко? Программа, которая выполняет дело, а не обсуждает его: берёт данные в Botpress, проверяет их по вашим правилам и отдаёт готовый результат — заявку, сводку, список. Бот отвечает текстом, агент приносит сделанную работу.

Что такое коннектор? Способ подключить Agenova к Botpress: где взять токен, как проверить связь, что агенту можно читать и создавать. Это не плагин в браузере и не правка кода бота; доступ отзывается одним действием.

Нужен ли отдельный бот для агента? Нет, агент читает существующие диалоги и заявки. Отдельный бот нужен, только если вы хотите отделить служебный поток от клиентского — тогда это второе рабочее пространство и свой токен.