<!-- Canonical URL: https://ask.atlascloud.ai/ru/integrate-hermes-agent-atlascloud -->

# Как интегрировать Hermes Agent с Atlas Cloud?

> Подключите Hermes Agent к Atlas Cloud, сохранив ключ Atlas Cloud в ~/.hermes/.env, выбрав провайдер: custom, установив базовый URL на https://api.atlascloud.ai/v1 и выбрав идентификатор активной модели из /v1/models.

Hermes Agent может использовать [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) в качестве кастомного провайдера, совместимого с OpenAI. Для интеграции потребуется три компонента: API-ключ Atlas Cloud, базовый URL `https://api.atlascloud.ai/v1` и [идентификатор модели из списка моделей Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). После того как эти параметры указаны в текущей конфигурации `model:` Hermes Agent, агент сможет работать через Atlas Cloud без использования SDK, специфичного для провайдера.

> **Ключевые моменты**
>
> * Установите Hermes Agent с помощью официального установщика, затем храните ключ Atlas Cloud в `~/.hermes/.env`, а не в системе контроля версий.
> * Настройте Hermes Agent с параметрами `provider: custom` и `base_url: https://api.atlascloud.ai/v1`.
> * Перед выбором модели выполните запрос к `/v1/models`. Названия моделей меняются быстрее, чем код интеграции, поэтому живой ответ API безопаснее, чем копирование старого ID из руководства.
> * Запустите `hermes doctor` перед запуском долгоживущего агента, затем используйте `hermes` для тестирования первого диалога.
> * Единый API Atlas Cloud позволяет впоследствии сменить языковую модель без перестройки интеграции с Hermes.

## Что такое Hermes Agent и Atlas Cloud?

[Hermes Agent](https://github.com/NousResearch/hermes-agent) — это открытый самообучающийся агент, созданный Nous Research. Он включает терминальный интерфейс, постоянную память, навыки, запланированные автоматизации, шлюзы обмена сообщениями и поддержку нескольких провайдеров вывода. В текущей документации Hermes Agent подчёркивается, что модели можно менять без переписывания самого агента.

[Основная платформа Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) предоставляет сотни моделей для языка, изображений, видео и аудио через единый API. Для Hermes Agent важна его OpenAI-совместимая поверхность вывода: Hermes может рассматривать Atlas Cloud как кастомного провайдера и отправлять ему обычные запросы на завершение чата.

Такое сочетание полезно, когда вы хотите, чтобы Hermes Agent оставался независимым от одного поставщика моделей. Конфигурация агента остаётся стабильной, а выбранная модель Atlas Cloud может меняться по мере изменения требований, цен или доступности.

## Перед началом работы

Вам потребуется:

1. Среда Linux, macOS, WSL2 или поддерживаемая версия Windows.
2. Установленный Hermes Agent.
3. Учётная запись Atlas Cloud и API-ключ.
4. Достаточный баланс Atlas Cloud или доступ к выбранной модели.

Не вставляйте реальный API-ключ в публичный репозиторий, issue, скриншот или общий конфигурационный файл. Hermes Agent поддерживает локальный файл `.env` именно для того, чтобы секреты оставались отдельно от обычной конфигурации.

## Шаг 1: Установка Hermes Agent

В Linux, macOS или WSL2 используйте установщик, опубликованный Nous Research:

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

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

```bash
source ~/.zshrc
```

Если вы используете Bash, перезагрузите `~/.bashrc`. Затем убедитесь, что CLI доступен:

```bash
hermes --help
```

Официальный проект также поддерживает родную Windows через установщик PowerShell. Следуйте текущей [документации по установке Hermes Agent](https://hermes-agent.nousresearch.com/docs/), а не переводите команду Unix в PowerShell самостоятельно.

## Шаг 2: Создание API-ключа Atlas Cloud

Войдите в консоль Atlas Cloud и создайте API-ключ для этого развёртывания Hermes Agent. Используйте выделенный ключ, если это позволяют настройки вашей учётной записи; разделение трафика агента упростит последующую ротацию и анализ использования.

Сохраните ключ в локальном файле окружения Hermes Agent:

```bash
printf '\nOPENAI_API_KEY=%s\n' 'замените-на-ваш-ключ-atlas-cloud' >> ~/.hermes/.env
```

Замените плейсхолдер локально. Не включайте реальный ключ в `config.yaml`, если этот файл будет резервироваться, синхронизироваться или попадать в систему контроля версий.

Почему `OPENAI_API_KEY`? Текущий путь кастомного провайдера Hermes Agent использует эту переменную окружения, когда настроен явный базовый URL, совместимый с OpenAI. Atlas Cloud использует аутентификацию по bearer-токену на этом совместимом интерфейсе.

## Шаг 3: Получение актуального идентификатора модели Atlas Cloud

Не угадывайте идентификатор модели. Проверьте [список моделей Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new), затем запросите у API текущий каталог:

```bash
export ATLASCLOUD_API_KEY='замените-на-ваш-ключ-atlas-cloud'

curl https://api.atlascloud.ai/v1/models \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
```

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

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

## Шаг 4: Настройка Hermes Agent на Atlas Cloud

Откройте `~/.hermes/config.yaml` и настройте текущий раздел `model:` верхнего уровня:

```yaml
model:
  default: "замените-на-актуальный-id-модели-atlas-cloud"
  provider: "custom"
  base_url: "https://api.atlascloud.ai/v1"
```

Ключ храните в `~/.hermes/.env`; в YAML-файле нужны только провайдер, endpoint и идентификатор модели.

Это важно, потому что в старых примерах Hermes Agent может использоваться блок `inference:`. В текущем официальном образце конфигурации используется `model:`. Если ваша установленная версия ведёт себя иначе, выполните `hermes update` и проверьте документацию по конфигурации, поставляемую с этой версией, прежде чем изменять другие настройки.

## Шаг 5: Диагностика конфигурации

Запустите встроенные проверки Hermes Agent:

```bash
hermes doctor
```

Затем запустите агента:

```bash
hermes
```

Отправьте небольшой тестовый запрос, не требующий внешних инструментов, например:

```text
Ответь, какую модель ты используешь, затем кратко опиши, какие инструменты доступны в этой сессии Hermes.
```

Нормальный потоковый ответ подтверждает, что Hermes может аутентифицироваться, достичь endpoint Atlas Cloud и вызвать настроенную модель.

## Распространённые проблемы при интеграции

### Ошибки аутентификации

Проверьте, что `OPENAI_API_KEY` существует в `~/.hermes/.env`, содержит ключ Atlas Cloud без лишних кавычек или пробелов и загружается той же установкой Hermes, которую вы запускаете. Поверните ключ, если он был скомпрометирован.

### Ошибки неизвестной модели

Снова вызовите `https://api.atlascloud.ai/v1/models` и скопируйте точный живой ID. Не удаляйте префикс провайдера и не сокращайте идентификатор, если только сам ответ API не использует более короткую форму.

### Hermes вызывает не того провайдера

Убедитесь, что активная конфигурация содержит оба параметра:

```yaml
provider: "custom"
base_url: "https://api.atlascloud.ai/v1"
```

Выбор встроенного провайдера может направить запрос на его собственный endpoint вместо Atlas Cloud.

### Конфигурация соответствует старому руководству, но не работает

Hermes Agent быстро развивается. Сравните ваш файл с текущим [официальным справочником по конфигурации](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) и используйте `hermes config get` для проверки активного профиля. В частности, убедитесь, что ваша версия ожидает структуру `model:`, как описано выше.

## Как менять модели без перестройки интеграции

После того как Atlas Cloud настроен в качестве кастомного провайдера, смена моделей требует только новый ID из [живого каталога моделей](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new):

1. Выполните запрос к `/v1/models`.
2. Обновите `model.default` в `~/.hermes/config.yaml`.
3. Запустите `hermes doctor`.
4. Начните новый тестовый диалог.

Endpoint и обработка учётных данных остаются прежними. В этом практическая ценность единого API для агента: оценка модели становится изменением конфигурации, а не новой интеграцией SDK.

## Когда такая настройка подходит

Интеграция с Atlas Cloud хорошо подходит, когда:

* Вы хотите, чтобы Hermes Agent имел доступ к нескольким семействам моделей через одну учётную запись.
* Вы планируете тестировать или заменять основную модель со временем.
* Вы предпочитаете OpenAI-совместимый endpoint, а не клиентский код, специфичный для провайдера.
* Вашим будущим навыкам Hermes может потребоваться доступ к моделям изображений или видео с той же платформы.

Прямая интеграция с провайдером моделей может быть проще, если агент будет постоянно использовать одного провайдера и вам не нужен более широкий каталог моделей Atlas Cloud. Правильный выбор зависит от того, что для вас важнее: гибкость и централизованный доступ или максимально короткая одно-провайдерская настройка.

## Финальный контрольный список

Прежде чем оставить Hermes Agent работать без присмотра, проверьте все пять пунктов:

- Ключ Atlas Cloud хранится вне системы контроля версий.
- `provider` установлен в `custom`.
- `base_url` точно равен `https://api.atlascloud.ai/v1`.
- `model.default` соответствует ID из живого endpoint моделей.
- `hermes doctor` и простой диалог выполняются успешно.

После выполнения этих проверок Hermes Agent интегрирован с Atlas Cloud. Теперь вы можете оценивать разные языковые модели за одним и тем же агентом, не меняя его инструменты, память, навыки или пользовательский интерфейс.

## FAQ

### Есть ли у Hermes Agent встроенный провайдер Atlas Cloud?

Выделенный провайдер Atlas Cloud не требуется. Hermes Agent может подключаться через собственного провайдера, совместимого с OpenAI, используя базовый URL и ключ API Atlas Cloud.

### Какой базовый URL Atlas Cloud для Hermes Agent?

Используйте https://api.atlascloud.ai/v1 в качестве базового URL, совместимого с OpenAI.

### Где следует хранить ключ API Atlas Cloud?

Храните его в ~/.hermes/.env как OPENAI_API_KEY и не допускайте попадания настоящего ключа в конфигурационные файлы, скриншоты и системы контроля версий.

### Какую модель Atlas Cloud должен использовать Hermes Agent?

Запросите https://api.atlascloud.ai/v1/models и выберите текущую текстовую модель, которая соответствует вашим требованиям по использованию инструментов, рассуждению, контексту, задержке и стоимости.

### Как я могу проверить интеграцию?

Запустите hermes doctor, запустите Hermes с помощью команды hermes и отправьте небольшой тестовый запрос. Ошибки аутентификации или неизвестной модели обычно указывают на API-ключ, базовый URL или идентификатор модели.