Hermes Agent plugins: как разобраться с расширениями

Короткий ответ

Hermes Agent — расширяемый ИИ-агент, в котором plugins упоминаются наряду со skills и MCP-серверами. В предоставленных первичных материалах подтверждено, что плагины можно включать в конфигурационный контур Hermes, а в репозитории есть каталоги plugins и plugin-catalog. Однако точная команда установки плагина, формат его описания, API и список совместимых версий здесь не приведены. Поэтому нельзя безопасно подставлять вымышленную команду вроде hermes plugin install.

Если ваша задача — добавить готовое действие, начните с описанных механизмов: skill устанавливается через Skills Hub, а MCP-сервер подключается через config.yaml. Если нужен именно plugin, сначала потребуется определить его официальный способ поставки и требования для вашей версии Hermes Agent.

Plugin, skill и MCP: не одно и то же

Plugin — общий термин для расширения агента. Документы подтверждают, что Hermes Agent учитывает plugins в настройках, но не раскрывают здесь полный технический контракт.

Skill — инструкция в файле SKILL.md, которая описывает процедуру выполнения конкретной задачи. Quickstart подтверждает команды hermes skills browse, hermes skills search и hermes skills install. После установки skill становится доступен как slash-команда, например /k8s.

MCP-сервер — внешний сервер инструментов. В Quickstart приведён пример подключения сервера GitHub через секцию mcp_servers в ~/.hermes/config.yaml.

Практическое правило: если нужно научить агента последовательности действий — рассмотрите skill; если нужно дать ему внешний инструмент или сервис — рассмотрите MCP; слово plugin используйте только после проверки конкретной реализации.

Установите и проверьте базовый Hermes Agent

Для Linux, macOS или WSL2 документация приводит команду:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

После установки обновите оболочку и запустите Hermes:

source ~/.bashrc   # или source ~/.zshrc
hermes

Затем настройте провайдера командой:

hermes model

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

Подтверждённый путь: установить skill

Если вам нужен готовый сценарий, в Quickstart указана такая последовательность:

hermes skills browse
hermes skills search kubernetes
hermes skills install openai/skills/k8s

Идентификатор установки имеет вид source/path; точный slug нужно брать из результата поиска или каталога. После установки skill вызывается как slash-команда в CLI и подключённых платформах, например:

/k8s deploy the staging manifest

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

Подтверждённый путь: подключить MCP-сервер

Quickstart показывает конфигурацию MCP в ~/.hermes/config.yaml. Пример для сервера GitHub выглядит так:

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Этот пример показывает структуру подключения, но не означает, что любой MCP-сервер безопасен или совместим с вашим окружением. Перед запуском проверьте источник пакета, права токена и перечень операций.

Рекомендуем начать с минимальных прав и read-only-сценария, если это возможно для выбранного сервера. Перед изменениями подготовьте резервную копию и проверьте результат вручную.

Что можно проверить у конкретного plugin

Для конкретного плагина зафиксируйте четыре группы вопросов:

1. Поставка: где находится официальный пакет или исходный код и каким способом он устанавливается.
2. Совместимость: с какой версией Hermes Agent, ОС и способом запуска он работает.
3. Права: к каким файлам, сетевым ресурсам, токенам и командам получает доступ.
4. Результат: какое действие должно произойти, какой ответ считается успешным и что происходит при ошибке.

В доступных документах нет ответов на эти вопросы для конкретного plugin. Поэтому не следует считать каталог plugins в репозитории доказательством, что любой найденный там компонент готов к установке. Если официальное описание не даёт команды, формата конфигурации и требований, остановите подключение до получения этих данных.

Диагностика после настройки

Для общей диагностики Hermes Agent документация указывает команду:

hermes doctor

Для просмотра и изменения инструментов используются:

hermes tools
hermes config get
hermes config check

Если проблема связана с провайдером, повторно откройте:

hermes model

Если расширение работает через skill или MCP, отдельно проверьте, что базовый чат отвечает без него, затем повторите тот же тест с расширением. Фиксируйте входные данные, ожидаемый ответ, фактический ответ и текст ошибки. Это помогает понять, сломалась ли настройка Hermes, доступ к внешнему сервису или логика самого расширения.

Как применить Hermes Agent в рабочем процессе

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

Если требуется разработать собственное расширение, Paramiko может помочь спроектировать процесс, определить границы доступа, связать агента с нужными системами и подготовить ограниченный пилот. Это предложение подхода к работе, а не утверждение о готовой совместимости с конкретным plugin или системе.