Как использовать чат-ботов Труконф с ИИ агентом Hermes
Что такое ИИ агент и его польза
ИИ-агент — программа, которая либо работает сама по себе, либо помогает по первому слову. Главное преимущество в том, что общаться с ней можно как с человеком: нет необходимости в командах с кучей параметров. Она понимает обычную речь, отправляет вопрос ИИ модели, затем передает её ответ.
Hermes — это один из популярных бесплатных ИИ-агентов. Благодаря поддержке множества скиллов и запуску субагентов он объединяет мощь языковых моделей с реальными действиями на устройстве, где установлен: может работать с файлами, открывать программы или даже писать код. Больше можно узнать на официальном сайте агента.
Важно помнить, что Труконф не призывает к использованию Hermes, не рекомендует его внедрение в корпоративной инфраструктуре и не несёт ответственности за работу Hermes, связанных ИИ-агентов, внешних сервисов или сторонних компонентов.
Использование плагина и подключение к Hermes выполняются пользователем или администратором системы самостоятельно и с учётом возможных рисков. Перед развёртыванием в корпоративной сети необходимо ознакомиться с рисками информационной безопасности, включая утечку данных, несанкционированный доступ, prompt injection, выполнение нежелательных команд, компрометацию API-ключей и непредвиденное поведение ИИ-агентов:
Рекомендуется использовать данный плагин только после оценки рисков, тестирования в изолированной среде, ограничения прав доступа, настройки мониторинга и принятия мер для защиты корпоративной инфраструктуры.
Для обеспечения круглосуточной доступности агента рекомендуется развернуть его на отдельном выделенном сервере или виртуальной машине. Главное условие — наличие сетевого доступа к этому серверу из вашей локальной сети. В качестве практического примера Hermes будет установлен на выделенную ВМ, взаимодействие с агентом будет организовано через чат клиентского приложения Труконф.
Подготовка
Работу со связкой Hermes + TrueConf рассмотрим на примере Debian 13. Перед началом установки рекомендуется обновить пакетную базу ОС, выполнив команду:
|
1 |
sudo apt update && sudo apt upgrade -y |
Установите утилиту curl если у вас её нет:
|
1 |
sudo apt install curl -y |
Установка Hermes
Выбор ИИ модели
Перед установкой вам нужно определиться с используемой ИИ моделью и подготовить API-ключ. Чтобы получить API-ключ, выберите провайдера. Мы покажем настройки на примере бесплатных моделей от OpenCode. На главной странице выберите Zen → Начать работу с Zen, войдите в личный кабинет. После этого вы увидите API-ключ, а ниже огромное количество доступных моделей для использования (для бесплатной работы оставьте отмеченными только те, что с пометкой Free):
Установка ИИ-агента Hermes
Для установки Hermes достаточно выполнить одну команду:
|
1 |
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash |
Затем откроется мастер настройки, ниже разберём подробнее все шаги.
Мастер установки проверит ОС на соответствие требованиям, и установит недостающие компоненты. Выберите полную настройку вручную в пункте How would you like to set up Hermes? нажав Full setup:
Здесь начинаются основные этапы. Сначала выберите провайдера ИИ модели, в нашем случае это OpenCode → OpenCode Zen:
Затем вставьте API ключ для доступа к модели, URL оставьте по умолчанию. Как узнать API ключ мы показали выше:
Для примера была выбрана модель mimo-v2.5-free:
В пункте Select terminal backend выберите Local:
В пункте Select platforms to configure нажмите Esc, поскольку далее в качестве канала будет настроен наш плагин TrueConf:
Также в пункте Tools for CLI нажмите Esc:
В следующем пункте выберите рекомендованный вариант Local Browser:
В пункте настройки генерации изображений выберите Skip:
Также выберите Skip в пункте настройки TTS:
Чтобы ИИ агент мог выполнять поиск в интернете, выберите поискового провайдера, например DuckDuckGo:
После настройки выполните команду:
|
1 |
source ~/.bashrc |
Установка плагина TrueConf для Hermes
Адаптер для мессенджера Труконф ставится прямо из корпоративного GitHub: проект плагина. Для установки плагина выполните команду:
|
1 |
curl -fsSL https://raw.githubusercontent.com/TrueConf/hermes-trueconf-adapter/main/install.sh -o /tmp/install.sh && bash /tmp/install.sh |
Разберём подробнее все этапы настройки:
- введите адрес сервера;
- укажите логин учётной записи, из-под которой будет работать агент;
- введите пароль к учетной записи агента;
- выберите хотите ли вы использовать SSL/HTTPS;
- если вы используете самоподписанный SSL сертификат, отключите проверку SSL сертификата (также это может быть полезно на этапе тестирования);
- разрешите пользователям писать вашему боту:
- настройте возможность писать сообщения агенту, для этого:
- перезагрузите шлюз с помощью команды:
- отправьте сообщение боту из клиентского приложения Труконф, он пришлет вам код сопряжения;
- введите код сопряжения, выполнив команду:
|
1 |
hermes gateway restart |
|
1 |
hermes pairing approve trueconf PAIR_CODE |
где вместо PAIR_CODE вставите код сопряжения, которым вам прислал бот:
После этого пользователь, под которым подключился к TrueConf Server агент, будет иметь статус В сети и вы можете взаимодействовать с ним через корпоративный чат в клиентском приложении Труконф.
При необходимости (например, для смены учётной записи ИИ агента на сервере) вы можете изменить настройки адаптера Труконф. Для этого выполните команду:
|
1 |
hermes setup |
Пропустите первые шаги дойдя до пункта Select platforms to configure, в списке отобразится адаптер Труконф, подписан как TrueConf (configured):
Выберите адаптер Труконф, измените необходимые параметры следуя инструкциям мастера настройки адаптера.
Теперь вы можете начать работу с ИИ агентом:
Алексей Аркатов
Дата публикации: 30.06.2026
