Подключение Hermes

Hermes может реагировать на события проекта: разбирать новые обращения, готовить ответы или выполнять заданные действия. Он сам подключается к Senler, поэтому вашему компьютеру не нужны публичный IP и открытые входящие порты. Компьютер или сервер с Hermes должен оставаться включённым и подключённым к интернету.

Подготовьте Hermes

Установите плагин Senler в Hermes:

hermes plugins install SenlerBot/senler-io-user-hermes-plugin --no-enable
hermes plugins enable senler-io-user

Откройте новый чат Hermes и напишите: «Подключи Senler.io и покажи доступные мне проекты. Пока ничего не изменяй». Плагин подготовит подключение и предложит авторизацию через интерфейс Hermes. Завершите вход в Senler и подтвердите запрошенные права. Передавать токены в чат не нужно.

Если предпочитаете терминал, используйте hermes senler connect, затем hermes senler check для проверки. Плагин использует Senler.io User MCP: действия выполняются с правами авторизованного пользователя. Установка сама по себе не включает обработку событий и не отправляет сообщения клиентам.

Плагин подходит и для разовых задач без подписки на события. Например: «Что можно улучшить в инструкции агента?» или «Почему автоматизация завершилась ошибкой?». Подписка ниже нужна для автоматической реакции на новые события, а не для каждого запроса к Senler.

Подключите события проекта

1. В вебхуках проекта нажмите «Добавить».
2. Выберите тип подключения «Hermes».
3. Укажите название и выберите нужные события, затем нажмите «Добавить». URL получателя, заголовки и формат HTTP-подписи здесь не нужны.

4. В созданной подписке откройте вкладку «Подключение Hermes». На странице подключения скопируйте адрес из блока «Подключение Hermes».
5. Передайте адрес Hermes и опишите правила обработки. Например: «Подключись к этой подписке. Классифицируй входящие вопросы и готовь черновики. Сообщения клиентам пока не отправляй».

Адрес указывает на подписку, но сам по себе не предоставляет доступ: подключение требует авторизации. После проверки приёма подписка включается автоматически. Статус «Hermes подключён» и время проверки видны в кабинете. Приостановленную вручную подписку нужно возобновить отдельно.

Можно начать с просьбы в чате Hermes, например: «Подключи обработку новых сообщений проекта Учебный». Плагин поможет создать подписку и проверить подключение; отдельно вручную создавать вторую такую же подписку не нужно.

Проверьте обработку

«Отправить тест» проверяет подключённый Hermes для выбранных типов событий, без запуска ИИ и сообщений клиентам. Реальная обработка зависит от правил, которые вы задали Hermes.

Откройте вкладку «Запросы» и смотрите состояние каждого события:

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

Senler хранит ожидающие события до результата или не более 24 часов, максимум 1000 на подписку. История доступна 7 дней. Если показан счётчик пропущенных попыток доставки, проверьте очередь и подключение: нельзя считать, что все события обработаны.

Черновик, подготовленный Hermes, доступен в его сессии обработки и в результате события. Он не появляется автоматически в исходном чате Hermes и не становится черновиком сообщения в Senler. Чтобы найти черновик, напишите Hermes: «Покажи результаты обработки проекта Учебный».

Остановите или смените подключение

Для остановки напишите Hermes: «Приостанови обработку этой подписки». Он остановит локальный обработчик и отключит подписку в Senler. Уже отправленное внешнее действие может завершиться. Отключение самой подписки в кабинете прекращает новые события, но не отменяет уже начатое действие Hermes.

Чтобы подключить другой компьютер, откройте вкладку «Подключение Hermes» и на странице подключения нажмите «Сбросить подключение». Ключ прежней установки будет отозван. Подключите новую установку и дождитесь проверки. Ранее включённая подписка возобновится после проверки, а ручная пауза сохранится.

Агент и плагин должны работать в одном экземпляре Hermes. Пересылка задач другому экземпляру через gateway.proxy_url или GATEWAY_PROXY_URL для входящих событий не поддерживается; это не запрещает использовать облачную модель в самом Hermes.