Hermes Agent

Hermes Agent — терминальный агент, который после разрешения пользователя может читать и записывать файлы, выполнять команды и вызывать инструменты.

В этом руководстве показано, как подключить встроенный Custom Endpoint Hermes Agent к Chat Completions AGTCloud без дополнительных средств настройки и проверить базовый диалог. Операции с файлами, веб-поиск, MCP, Skills и другие расширенные возможности не входят в проверяемый здесь объём.

Подготовка

Перед началом убедитесь, что вы:

Подготовили ОС и терминал, поддерживаемые Hermes Agent;
Зарегистрировались и вошли в AGTCloud;
Создали ключ API AGTCloud на странице API Keys;
Скопировали из каталога моделей ID модели, доступной текущему ключу API и поддерживающей Chat Completions;
Подготовили тестовый каталог без конфиденциального кода и производственных учётных данных.

Установка Hermes Agent

Выберите официальный способ установки для своей среды. Первая версия для macOS поддерживает Apple Silicon; Intel Mac, установка через Homebrew и PyPI не входят в текущий официальный объём поддержки.

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

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

hermes version
hermes doctor

hermes doctor проверяет установку, конфигурацию и типичные проблемы среды. Если команда hermes не найдена, сначала откройте терминал заново, затем убедитесь, что каталог установки добавлен в PATH. Другие ограничения описаны в официальной документации поддержки платформ Hermes Agent.

Настройка AGTCloud

Hermes Agent предоставляет мастер настройки поставщика моделей. Выполните следующую команду в обычном терминале, а не внутри уже открытого диалога Hermes:

hermes model

Выбор Custom Endpoint

В списке Provider выберите Custom endpoint. Полное название в разных версиях может выглядеть как Custom endpoint (self-hosted / VLLM / etc.).

Параметры подключения AGTCloud

Последовательно заполните поля мастера текущей версии:

Поле Hermes Agent	Значение
`Provider Name` (если доступно)	`AGTCloud`
`API Base URL`	`https://api.agtcloud.cn/v1`
`API Key`	`your-api-key`
`API / Wire Mode`	`Chat Completions` или `chat_completions`
`Model`	`MODEL_ID`
`Context Length`	При первой настройке рекомендуется оставить пустым для автоматического определения клиентом

Замените your-api-key ключом API AGTCloud, а MODEL_ID — ID модели, доступной текущему ключу API.

Сохранение конфигурации

Проверьте сводку мастера и сохраните настройки. Обычные параметры записываются в ~/.hermes/config.yaml, а ключ API и другие секреты Hermes Agent сохраняет в ~/.hermes/.env.

Base URL должен содержать /v1

Используйте непосредственно https://api.agtcloud.cn/v1. Не указывайте только API Origin, полный адрес запроса /v1/chat/completions и не добавляйте второй /v1.

Предпочитайте официальный мастер настройки

Поля конфигурации Hermes Agent могут меняться между версиями. Команда hermes model позволяет текущей версии записать правильные Provider и режим передачи самостоятельно. Ручное редактирование YAML не требуется; не записывайте настоящий ключ API в общие примеры конфигурации.

Проверка конфигурации

После завершения мастера проверьте текущие настройки командами:

hermes config
hermes config get model
hermes config check

hermes config открывает или показывает доступ к текущей конфигурации;
hermes config get model проверяет текущие настройки модели;
hermes config check проверяет формат конфигурации и необходимые поля.

Не копируйте и не передавайте полный ключ API из результатов проверки. Если конфигурация по-прежнему указывает на другой Provider, повторно выполните hermes model и настройте Custom Endpoint.

Запуск и проверка подключения

Переход в безопасный тестовый каталог

cd /path/to/safe/test-project

Не выполняйте первую проверку в каталоге с производственными учётными данными, клиентскими данными или неопубликованным исходным кодом.

Запуск Hermes Agent

hermes

Интерактивный сеанс также можно запустить командой hermes chat.

Проверка базового диалога

Введите сообщение:

Ответьте только: подключение к AGTCloud установлено. Не вызывайте никакие инструменты.

Нормальный ответ подтверждает базовое подключение Base URL, ключа API, модели и Chat Completions. Этот шаг создаёт обычный расход API.

Необязательная проверка вызова инструментов

Если выбранная модель поддерживает вызов инструментов, отправьте в тестовом каталоге с README.md:

Прочитайте только README.md и в трёх пунктах опишите назначение проекта. Не изменяйте файлы и не выполняйте другие команды.

Оставьте ручное подтверждение по умолчанию; изучите предлагаемое действие Hermes Agent, прежде чем решать, разрешать ли его.

Не отключайте подтверждение действий при первом использовании

Не используйте --yolo и не отключайте подтверждение опасных операций. Hermes Agent может выполнять команды и обращаться к файлам; при первой проверке подтверждайте запросы инструментов по отдельности.

Смена модели

Чтобы добавить модель, изменить Endpoint или ключ API, завершите текущий сеанс и выполните:

hermes model

В открытом сеансе /model переключает между уже настроенными Provider и моделями. Команда /model не создаёт новый Custom Endpoint; если целевая модель ещё не настроена, сначала выполните hermes model в терминале.

MODEL_ID — только заполнитель. Всегда используйте полный ID модели, доступной текущему ключу API в каталоге моделей, а не фиксированную рекомендацию, которая может меняться между версиями.

Частые вопросы

Симптом	Что проверить сначала	Решение
Команда `hermes` не найдена	Установку и `PATH`	Откройте терминал заново и выполните `hermes version`; если результата нет, повторите официальный способ установки для своей ОС
`hermes doctor` сообщает о проблеме	Python, системные инструменты и каталог установки	Исправьте среду по результатам диагностики; не смешивайте несколько источников установки Hermes Agent
Ответ `401`	Содержимое ключа API и состояние токена	Скопируйте действующий ключ API заново и удалите лишние пробелы
Ответ `403`	Права токена, доступ к модели и состояние аккаунта	Проверьте ключ API и доступные аккаунту модели в консоли
Ответ `404`	Base URL, повторный `/v1` и ID модели	Используйте `https://api.agtcloud.cn/v1` без полного Endpoint и скопируйте полный ID модели заново
Модель недоступна	Видимые текущему ключу модели и протокол	Выберите модель, доступную текущему ключу API и поддерживающую Chat Completions
По-прежнему используется другой Provider	Текущий выбор и сохранение в `hermes model`	Повторите мастер, выберите Custom Endpoint и проверьте конфигурацию через `hermes config check`
Диалог работает, но инструменты не работают	Поддержку вызова инструментов и формат ответа	Используйте модель с вызовом инструментов; отключите сложные инструменты и проверьте одну операцию только для чтения
Не определяется длина контекста	Метаданные модели и ручное значение	Повторите `hermes model`; задавайте длину контекста вручную только при знании реальных ограничений
Расширенному инструменту не хватает учётных данных	Независимые сервисные настройки вспомогательного инструмента	Такие возможности могут требовать дополнительных сервисов и учётных данных и не входят в настройку ключа основной модели диалога AGTCloud

Если причину найти не удаётся, выполните hermes doctor и hermes config check, запишите время запроса, API Base URL, ID модели, HTTP-статус и обезличенную ошибку, затем обратитесь к разделу ошибок и диагностики. Не отправляйте полный ключ API.