# Как запустить Hermes Agent с DeepSeek API из Atlas Cloud > Пошаговое руководство по запуску открытого Hermes Agent на моделях DeepSeek V4 через OpenAI-совместимый API Atlas Cloud, с примерами конфигурации и ценами. Вы установили Hermes Agent, автономный агент с открытым исходным кодом от Nous Research, и теперь вам нужна модель, которая будет достаточно дешевой, чтобы работать весь день, и достаточно мощной, чтобы обрабатывать реальные вызовы инструментов. [DeepSeek](https://www.atlascloud.ai/models/list/llm?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=run-hermes-agent-deepseek-api-atlascloud) V4 — очевидный выбор по стоимости, и Atlas Cloud предоставляет семейство DeepSeek через единую OpenAI-совместимую конечную точку наряду с более чем 300 другими моделями. Это руководство описывает подключение Hermes Agent к DeepSeek на Atlas Cloud, от базового URL и идентификаторов моделей до рабочего `config.yaml`, чтобы агент работал на производственной инфраструктуре без второго SDK. ## Что вы подключаете Hermes Agent — это постоянный, самосовершенствующийся агент, который работает на вашем собственном сервере. Он разработан как независимый от модели и провайдера, поэтому ему все равно, поступают ли токены DeepSeek напрямую от DeepSeek или через шлюз, если конечная точка соответствует форме OpenAI API. Atlas Cloud — это полнофункциональная платформа для вывода ИИ, которая предоставляет текстовые, графические и видеомодели через один OpenAI-совместимый ключ API и один платежный аккаунт. Поскольку интерфейс совместим с OpenAI, подключение Hermes — это изменение базового URL и ключа, а не переписывание. Это сочетание важно для постоянного агента. Hermes создан для работы в течение нескольких недель, накапливая память и многократно используемые навыки, поэтому модель, стоящая за ним, является повторяющейся стоимостью, а не разовым вызовом. DeepSeek V4 поддерживает низкую повторяющуюся стоимость без ущерба для качества вызовов инструментов, а маршрутизация через Atlas Cloud означает, что тот же ключ, который отвечает на чат, может позже генерировать изображение или видеоклип, когда это потребуется навыку. Вы не просто выбираете дешевую модель, вы выбираете конечную точку, которую агент не перерастет. Два факта определяют всю настройку, и оба стоит точно понять, прежде чем вы коснетесь файла конфигурации: * Базовый URL Atlas Cloud — `https://api.atlascloud.ai/v1`. * Идентификаторы моделей DeepSeek на Atlas Cloud имеют префикс `deepseek-ai/`, например `deepseek-ai/deepseek-v4-pro`. Это отличается от чистого `deepseek-v4-pro`, который Hermes использует со своим встроенным провайдером DeepSeek, который указывает на собственную конечную точку DeepSeek. При маршрутизации через Atlas Cloud вы используете полный идентификатор с префиксом и пользовательский OpenAI-совместимый провайдер, а не встроенный. ## Шаг 1: Получите свой ключ API Atlas Cloud Войдите на console.atlascloud.ai, откройте API Keys, нажмите Create API Key и скопируйте его в безопасное место. Доступ оплачивается по мере использования, поэтому нет депозита и минимальных затрат. Вы регистрируетесь, получаете ключ и платите за каждый запрос. Держите ключ вне системы контроля версий. Hermes намеренно разделяет секреты и настройки: `config.yaml` содержит нечувствительную структуру и безопасен для коммита или совместного использования, в то время как `~/.hermes/.env` содержит ключи и по умолчанию игнорируется git. Размещение ключа Atlas Cloud в `.env` и ссылка на него по имени из конфигурации позволяет вам версионировать настройку агента без утечки учетных данных. ``` echo "ATLASCLOUD_API_KEY=your-atlas-cloud-key" >> ~/.hermes/.env ``` ## Шаг 2: Подтвердите идентификаторы моделей DeepSeek, которые вы можете вызывать Atlas Cloud публикует свой список активных моделей в общедоступной конечной точке, поэтому вам никогда не придется угадывать идентификатор. Быстрый вызов возвращает точные строки, которые принимает API. ``` curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Предварительный запрос списка — это не пустая трата времени. Идентификаторы моделей меняются по мере выпуска новых версий, и устаревший идентификатор из сообщения в блоге или старого скрипта является наиболее частой причиной сбоя первого вызова. Конечная точка `/v1/models` является истиной для того, что API примет сегодня, поэтому проверка ее перед редактированием конфигурации экономит раунд ошибок неизвестной модели. Записи DeepSeek, которые вы будете использовать чаще всего, следующие: | Идентификатор модели | Лучше всего подходит для | Окно контекста | |---|---|---| | `deepseek-ai/deepseek-v4-pro` | Основной цикл агента, кодирование, вызовы инструментов | 1M токенов | | `deepseek-ai/deepseek-v4-flash` | Вспомогательные задачи, высокая пропускная способность | 1M токенов | | `deepseek-ai/deepseek-v3.2` | Общий чат с учетом стоимости | 163K токенов | DeepSeek V4 Pro стоит $1.68 за миллион входных токенов и $3.38 за миллион выходных токенов на Atlas Cloud, в то время как V4 Flash стоит $0.14 за вход и $0.28 за выход. Этот разрыв является основной причиной разделения основной и вспомогательной работы между двумя моделями, что делает конфигурация ниже. ## Шаг 3: Направьте Hermes на Atlas Cloud Поскольку Atlas Cloud является пользовательской OpenAI-совместимой конечной точкой, а не встроенным провайдером DeepSeek в Hermes, вы явно определяете ее в `~/.hermes/config.yaml`. Блок провайдера указывает базовый URL и переменную среды, которая содержит ваш ключ, а блок модели выбирает идентификатор DeepSeek с префиксом. ``` inference: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: default: deepseek-ai/deepseek-v4-pro ``` Сохраните файл, затем запустите агент. ``` hermes ``` Если первое сообщение возвращает обычный ответ, подключение выполнено правильно. Если вы получили ошибку аутентификации, ключ в `.env` неверен или не загружен; если вы получили ошибку неизвестной модели, перепроверьте префикс `deepseek-ai/` по сравнению с выводом `/v1/models` из Шага 2. Самая распространенная ошибка здесь — это использование встроенного провайдера `deepseek` в Hermes, ожидая, что Atlas Cloud ответит. Встроенный провайдер жестко привязан к собственной конечной точке DeepSeek и ее простым именам моделей, поэтому он с радостью выставит счет вашему аккаунту DeepSeek и полностью проигнорирует Atlas Cloud. Маршрутизация через Atlas Cloud — это сознательный выбор пользовательского провайдера: ваш собственный `base_url`, ваш ключ Atlas Cloud и идентификаторы моделей `deepseek-ai/` с префиксом. Держите эти три вместе, и два пути никогда не запутаются. ## Шаг 4: Отправьте дешевую работу в Flash Hermes выполняет множество низкоценных вызовов за кулисами: суммирование веб-страниц, анализ зрения, сжатие контекста, одобрение команд. Платить за них по тарифам V4 Pro — это пустая трата. Направьте вспомогательные слоты на V4 Flash, чтобы основной цикл сохранял более сильную модель, в то время как фоновые задачи выполнялись за долю стоимости. ``` auxiliary: web_extract: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash compression: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash timeout: 120 ``` Каждый вспомогательный слот принимает свой собственный провайдер, модель, базовый URL, ключ и цепочку резервирования, поэтому вы можете настраивать каждую фоновую задачу независимо. ## Шаг 5: Добавьте резервный вариант для отказоустойчивости Долго работающий агент в конечном итоге столкнется с ограничением скорости или истечением времени ожидания соединения. Цепочка резервирования позволяет ему продолжать работать вместо того, чтобы выдавать ошибку. Здесь задача сжатия сначала пытается использовать V4 Flash, затем переключается на вторую модель Atlas Cloud, прежде чем сдаться. ``` auxiliary: compression: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash fallback_chain: - provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v3.2 ``` Hermes пытается выполнить каждую запись по порядку, пока одна не будет успешной, поэтому единичный сбой провайдера не остановит агента. Для агента, который работает без присмотра по расписанию, это разница между заданием cron, которое тихо восстанавливается, и тем, которое умирает в 3 часа ночи и оставляет вам трассировку стека утром. ## Когда эта настройка подходит Запуск Hermes на DeepSeek через Atlas Cloud имеет наибольший смысл, когда вам нужен один ключ и один счет для всего, к чему прикасается агент. Поскольку та же конечная точка также обслуживает модели изображений и видео, агент, который изначально был только текстовым, может позже генерировать изображения или клипы без новой интеграции или второго аккаунта поставщика. Если ваш агент будет вызывать только DeepSeek и ничего больше, встроенный провайдер DeepSeek, указывающий на собственный API DeepSeek, является более простым путем. Маршрут Atlas Cloud занимает свое место, как только вы захотите добавить модели различных модальностей за единым, OpenAI-совместимым интерфейсом. Вы можете самостоятельно проверить каждый идентификатор модели и актуальную цену на atlascloud.ai/models, прежде чем фиксировать что-либо из этого в файле конфигурации, что является привычкой, которую стоит сохранять по мере развития линейки DeepSeek. Дополнительные рекомендации по реализации см. в [переключении OpenAI-совместимого приложения на другие LLM](https://ask.atlascloud.ai/what-api-provider-lets-me-switch-from-openai-to-other-llms) и [оценке AI-инференс API для продакшена](https://ask.atlascloud.ai/what-to-evaluate-before-choosing-ai-inference-api).