Перейти к содержимому

Как использовать чат-ботов Труконф с ИИ агентом Hermes

Автор30.06.2026Дата написанияОколо 6 минВремя чтенияAPI / SDKКатегорияAPI / SDKТеги

Что такое ИИ агент и его польза

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

Hermes — это один из популярных бесплатных ИИ-агентов. Благодаря поддержке множества скиллов и запуску субагентов он объединяет мощь языковых моделей с реальными действиями на устройстве, где установлен: может работать с файлами, открывать программы или даже писать код. Больше можно узнать на официальном сайте агента.

Важно помнить, что Труконф не призывает к использованию Hermes, не рекомендует его внедрение в корпоративной инфраструктуре и не несёт ответственности за работу Hermes, связанных ИИ-агентов, внешних сервисов или сторонних компонентов.

Использование плагина и подключение к Hermes выполняются пользователем или администратором системы самостоятельно и с учётом возможных рисков. Перед развёртыванием в корпоративной сети необходимо ознакомиться с рисками информационной безопасности, включая утечку данных, несанкционированный доступ, prompt injection, выполнение нежелательных команд, компрометацию API-ключей и непредвиденное поведение ИИ-агентов:

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

Для обеспечения круглосуточной доступности агента рекомендуется развернуть его на отдельном выделенном сервере или виртуальной машине. Главное условие — наличие сетевого доступа к этому серверу из вашей локальной сети. В качестве практического примера Hermes будет установлен на выделенную ВМ, взаимодействие с агентом будет организовано через чат клиентского приложения Труконф.

Подготовка

Работу со связкой Hermes + TrueConf рассмотрим на примере Debian 13. Перед началом установки рекомендуется обновить пакетную базу ОС, выполнив команду:

sudo apt update && sudo apt upgrade -y

Установите утилиту curl если у вас её нет:

sudo apt install curl -y

Установка Hermes

Выбор ИИ модели

Перед установкой вам нужно определиться с используемой ИИ моделью и подготовить API-ключ. Чтобы получить API-ключ, выберите провайдера. Мы покажем настройки на примере бесплатных моделей от OpenCode. На главной странице выберите Zen → Начать работу с Zen, войдите в личный кабинет. После этого вы увидите API-ключ, а ниже огромное количество доступных моделей для использования (для бесплатной работы оставьте отмеченными только те, что с пометкой Free):

Установка ИИ-агента Hermes

Для установки Hermes достаточно выполнить одну команду:

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:

После настройки выполните команду:

source ~/.bashrc

Установка плагина TrueConf для Hermes

Адаптер для мессенджера Труконф ставится прямо из корпоративного GitHub: проект плагина. Для установки плагина выполните команду:

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 сертификата (также это может быть полезно на этапе тестирования);

  • разрешите пользователям писать вашему боту:

  • настройте возможность писать сообщения агенту, для этого:

  • перезагрузите шлюз с помощью команды:

hermes gateway restart

  • отправьте сообщение боту из клиентского приложения Труконф, он пришлет вам код сопряжения;

  • введите код сопряжения, выполнив команду:

hermes pairing approve trueconf PAIR_CODE

где вместо PAIR_CODE вставите код сопряжения, которым вам прислал бот:

После этого пользователь, под которым подключился к TrueConf Server агент, будет иметь статус В сети и вы можете взаимодействовать с ним через корпоративный чат в клиентском приложении Труконф.

При необходимости (например, для смены учётной записи ИИ агента на сервере) вы можете изменить настройки адаптера Труконф. Для этого выполните команду:

hermes setup

Пропустите первые шаги дойдя до пункта Select platforms to configure, в списке отобразится адаптер Труконф, подписан как TrueConf (configured):

Выберите адаптер Труконф, измените необходимые параметры следуя инструкциям мастера настройки адаптера.

Теперь вы можете начать работу с ИИ агентом: