Hermes Agent подключают к Telegram через отдельный gateway: сначала проверяют базовый чат агента, затем задают токен бота, список разрешённых числовых ID пользователей и правила работы канала. После настройки оператор сверяет получение тестового сообщения, право отправителя и ответ в закрытом чате. Разрешение на внешние действия проверяет сервер, а спорный ответ агента подтверждает ответственный человек.
Граница канала
Telegram в Hermes Agent работает через gateway, который подключают после успешного базового чата. Минимальный контракт канала включает токен бота, разрешённых отправителей, ограниченные инструменты и журнал проверки ответа.
Базовый Hermes Agent и Telegram решают разные задачи. Сначала агент должен отвечать в локальном диалоге с выбранной моделью; gateway затем переносит запросы в мессенджер. Официальный quickstart предлагает команду hermes gateway setup после рабочего CLI. Это помогает отделить ошибку модели или провайдера от ошибки доставки Telegram. Существующая статья о базовом агенте охватывает его рабочую схему, а здесь рассматривается путь конкретного сообщения: Telegram передаёт его боту, gateway проверяет отправителя, агент готовит ответ, оператор оценивает результат.
Для пилота определите владельца бота, администратора gateway, разрешённых пользователей и ответственного за содержание ответов. Запишите, какие типы запросов допустимы, какие инструменты доступны и какие действия требуют ручного подтверждения. Если задача касается корпоративных документов, сервер источника проверяет полномочия пользователя при каждом обращении. Telegram allowlist открывает канал; право читать документы и менять рабочие записи отдельно проверяет сервер источника.
Инструкции проекта описывают приватные чаты, группы и отдельные правила допуска для них. Начните с закрытого тестового чата, а групповую работу добавляйте только при понятных правилах видимости и обращения к боту. Смежный материал о правах и секретах ИИ-агентов помогает определить границу инструментов; здесь эта граница проверяется на Telegram-входе.
Входы и права
Для подключения нужны рабочий Hermes Agent, отдельный Telegram-бот, его токен и числовые Telegram ID допущенных людей. Документация Hermes Agent о Telegram называет переменные TELEGRAM_BOT_TOKEN и TELEGRAM_ALLOWED_USERS, а интерактивный мастер спрашивает эти значения сам. Токен храните в предусмотренном защищённом месте, доступном только администратору канала. В статью, журнал теста и переписку команды помещайте лишь название параметра и статус проверки, без значения секрета.
| Роль | Доступ к каналу | Действие | Проверка |
|---|---|---|---|
| Администратор gateway | Настройка бота и allowlist | Меняет конфигурацию | Запись изменения и автор |
| Тестовый пользователь | Закрытый чат с ботом | Отправляет разрешённый запрос | Ответ и журнал допуска |
| Владелец процесса | Результаты теста | Подтверждает сценарий | Сверка с критерием |
| Сервер источника | Рабочие данные по роли | Разрешает запрос данных | Проверка полномочий |
Для группы различайте ID отправителя и ID самого чата. Официальная документация описывает отдельные настройки для разрешённых пользователей группы и для разрешённых групп. Разрешение целого чата открывает взаимодействие его участникам по правилам gateway, поэтому его применяют лишь после оценки состава группы. В персональный список вносят числовой Telegram ID пользователя; username служит лишь именем учётной записи. Если нужен доступ только к чтению статуса, отдельно ограничьте команды и инструменты; разрешённому пользователю оставьте только согласованные операции агента.
Допуск канала и права бизнес-систем проверяются на разных уровнях. Gateway отсекает постороннего отправителя, сервер CRM или хранилища сверяет роль при действии, ответственный человек утверждает спорный вывод. Эта схема остаётся актуальной даже при аккуратном промпте: права проверяет сервер, а текст промпта управляет лишь ответом модели. Для проектирования агентных ролей пригодится разбор управления ИИ-агентами в компании.
Настройка gateway
Официальный quickstart рекомендует убедиться, что обычный чат Hermes отвечает, и только после этого переходить к gateway. Далее администратор создаёт бота через Telegram BotFather по правилам платформы и получает секретный токен. Мастер hermes gateway setup предлагает выбрать Telegram и указать токен с разрешёнными ID. В ручном варианте те же значения задают через названные переменные окружения. Конкретный способ хранения зависит от установленного профиля Hermes; перед применением сверьте документацию с версией окружения.
- Проверьте базовый диалог Hermes без Telegram и зафиксируйте результат для диагностики.
- Подготовьте отдельного бота и список числовых ID допущенных тестовых пользователей; секрет передайте администратору по защищённому порядку.
- Настройте Telegram в
hermes gateway setupи проверьте выбранный профиль, границы инструментов и список пользователей. - Запустите gateway в тестовом контуре по регламенту команды и проверьте его состояние через
hermes gateway status. - Уполномоченный тестировщик проверяет вход и ответ в закрытом чате; результат записывает без токена и личного содержимого.
Проверка состояния процесса и проверка ответа — разные шаги. Статус gateway показывает работу компонента, а контрольное сообщение подтверждает маршрут до Telegram и обратно. Если ответа нет, сначала сравните настройки токена и профиль, затем проверьте allowlist отправителя и журнал gateway. Документация Hermes Agent советует читать журнал при отсутствии ответа, а для сообщения об отказе в доступе — сверять числовой ID пользователя. Реальное сообщение отправляет только назначенный тестировщик в собственном закрытом контуре.
Для расширенного сценария с инструментами оцените полномочия каждого действия отдельно. Агент может подготовить черновик ответа, но изменение записи, отправку клиенту или решение по спорному документу допускают лишь после проверки на сервере и подтверждения ответственного сотрудника. Это правило бизнес-процесса действует поверх настройки Telegram.
Чтение и исключения
В группах Telegram действует режим приватности ботов: состав доставляемых сообщений отличается от приватного чата. Документация Hermes Agent объясняет, что при включённом режиме бот видит команды, ответы ему и некоторые служебные события; обычное обсуждение группы может остаться вне gateway. Для контролируемого теста достаточно обращения к боту по явному триггеру. Отключать приватность ради первого теста незачем: это расширяет доступный боту поток сообщений и меняет границы обработки данных.
- Бот молчит в личном чате: администратор сверяет состояние gateway, профиль и токен по защищённому журналу.
- Ответ «unauthorized»: проверяют числовой ID отправителя и действующий список разрешённых пользователей.
- Личный чат работает, группа молчит: проверяют доставку Telegram, допуск группы и правило обращения к боту.
- Ответ есть, но содержание спорно: оператор сохраняет обезличенный признак ошибки и передаёт его владельцу процесса.
В группах отдельно проверяйте, какие сообщения бот способен читать и при каком упоминании отвечает. Разрешение группы и разрешение конкретного человека дают разные охваты. Если группа предназначена для сотрудников, администратор согласует состав участников и доступ к истории; модель получает только разрешённый контекст. При неизвестном отправителе gateway должен отказать в допуске по настроенному списку, а сервер рабочего приложения всё равно проверяет права на свои данные.
Ошибки доставки отделяйте от ошибок ответа. Отсутствие входящего события ищут на стороне Telegram и gateway; отказ авторизации — в настройках допуска; неверный результат агента — в модели, инструментах и источниках. Такая классификация позволяет исправлять нужный слой без расширения прав всем участникам. После изменения allowlist повторите проверку отказа для постороннего ID.
Хотите проверить доступ к вашему агенту в Telegram?
Приёмка канала
Приёмка начинается с тестовой матрицы. Разрешённый пользователь отправляет нейтральный запрос в закрытом чате, посторонний ID получает отказ, а вопрос к рабочим данным проходит отдельную серверную проверку прав. Затем оператор сравнивает ответ с ожидаемым содержанием и первоисточником. Для спорных ответов он фиксирует источник расхождения и подтверждает корректный вывод вручную. Готовность канала подтверждают вместе: контролируемый ответ, проверка прав и решение ответственного.
В журнале теста сохраните версию Hermes Agent, профиль, статус gateway, тип чата, результат допуска и ссылку на защищённую запись проверки. Токен бота, личные данные пользователей и текст корпоративного документа туда переносить нельзя. Если тестируется группа, добавьте проверку доставки сообщения по явному обращению и отказ для участника вне принятой роли. Изменение настроек группы или BotFather повторно проверяют на отдельном сценарии, поскольку маршруты личного и группового чата различаются.
Проверьте базовый чат Hermes, составьте список допущенных тестировщиков и опишите один нейтральный запрос. Затем ответственная команда настраивает gateway и сверяет разрешённый вход, отказ постороннему и качество ответа. Эти три наблюдения дают основу для следующего решения о канале.
План испытаний и отката для агента подробнее раскрыт в материале о тестировании ИИ-агентов. Для рабочего внедрения согласуйте владельца бота, права инструментов, допустимые данные и маршрут ручной эскалации. Состав такого проекта обсуждается на странице внедрения ИИ-агентов; напишите нам, и мы оценим работу под ваш канал и систему доступа.
Частые вопросы
Как подключить Hermes Agent к Telegram?
hermes gateway setup, задаёт токен бота и числовые ID разрешённых пользователей. Контрольный ответ проверяют в закрытом тестовом чате.