Atlas CloudからDeepSeek APIでHermes Agentを実行する方法

Nous Researchのオープンソース自律エージェントであるHermes Agentをインストールしたものの、一日中稼働させても十分安価で、実際のツール呼び出しを処理できるほど強力なモデルが必要だと感じているかもしれません。DeepSeek V4はコスト面で明白な選択肢であり、Atlas CloudはDeepSeekファミリーを300以上の他のモデルとともに単一のOpenAI互換エンドポイントで提供しています。このガイドでは、Hermes AgentをAtlas Cloud上のDeepSeekに接続する方法を、ベースURLとモデルIDから動作するconfig.yamlまで、エージェントがセカンドSDKなしで本番グレードのインフラストラクチャで実行されるように説明します。

接続するもの

Hermes Agentは、独自のサーバーで実行される永続的で自己改善型のエージェントです。モデルとプロバイダーに依存しないように設計されているため、エンドポイントがOpenAI APIの形式を話す限り、DeepSeekトークンがDeepSeekから直接来るか、ゲートウェイを介して来るかは関係ありません。

Atlas Cloudは、テキスト、画像、ビデオモデルを1つのOpenAI互換APIキーと1つの請求アカウントで公開するフルモーダルAI推論プラットフォームです。インターフェースがOpenAI互換であるため、Hermesの接続はベースURLとキーの変更であり、書き換えではありません。

この組み合わせは、永続的なエージェントにとって重要です。Hermesは何週間も稼働し、メモリと再利用可能なスキルを蓄積するように構築されているため、その背後にあるモデルは1回限りの呼び出しではなく、継続的なコストとなります。DeepSeek V4は、ツール呼び出しの品質を犠牲にすることなく、その継続的なコストを低く抑えます。また、Atlas Cloudを介してルーティングすることで、チャットの応答に使用するのと同じキーで、スキルが必要なときに画像を生成したり、ビデオクリップを生成したりできます。単に安価なモデルを選択するだけでなく、エージェントが成長しても対応できるエンドポイントを選択しているのです。

設定全体を決定する2つの事実があり、設定ファイルを触る前にこれらを正確に理解しておく価値があります。

• Atlas CloudのベースURLはhttps://api.atlascloud.ai/v1です。
• Atlas Cloud上のDeepSeekモデルIDにはdeepseek-ai/プレフィックスが付いています。例えば、deepseek-ai/deepseek-v4-proです。これは、Hermesが組み込みのDeepSeekプロバイダーで使用する、DeepSeek独自のエンドポイントを指す裸のdeepseek-v4-proとは異なります。Atlas Cloudを介してルーティングする場合、組み込みのプロバイダーではなく、完全なプレフィックス付きIDとカスタムのOpenAI互換プロバイダーを使用します。

ステップ1：Atlas Cloud APIキーを取得する

console.atlascloud.aiにサインインし、APIキーを開き、「APIキーを作成」をクリックして、安全な場所にコピーします。アクセスは従量課金制なので、デポジットや最低利用額はありません。サインアップしてキーを取得し、リクエストごとに支払います。

キーはバージョン管理から除外してください。Hermesは意図的にシークレットと設定を分離しています。config.yamlは機密性のない構造を保持し、コミットまたは共有しても安全ですが、~/.hermes/.envはキーを保持し、デフォルトでgit-ignoredされます。Atlas Cloudキーを.envに配置し、設定から名前で参照することで、資格情報を漏らすことなくエージェントの設定をバージョン管理できます。

textCopy
1echo "ATLASCLOUD_API_KEY=your-atlas-cloud-key" >> ~/.hermes/.env

ステップ2：呼び出し可能なDeepSeekモデルIDを確認する

Atlas Cloudは、ライブモデルリストを公開エンドポイントで公開しているため、IDを推測する必要はありません。簡単な呼び出しで、APIが受け入れる正確な文字列が返されます。

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

最初にリストを照会することは、無駄な作業ではありません。新しいバージョンが出荷されるとモデルIDは変化し、ブログ記事や古いスクリプトからの古いIDが、最初の呼び出しが失敗する最も一般的な理由です。/v1/modelsエンドポイントは、APIが今日受け入れるものの真実の源であるため、設定を編集する前に確認することで、不明なモデルエラーのラウンドを節約できます。最も頻繁に使用するDeepSeekエントリは次のとおりです。

DeepSeek V4 Proは、Atlas Cloudで入力トークン100万あたり1.68ドル、出力トークン100万あたり3.38ドルでリストされており、V4 Flashは入力0.14ドル、出力0.28ドルでリストされています。この差が、以下の設定が行うように、メインと補助の作業を2つに分割する主な理由です。

ステップ3：HermesをAtlas Cloudに接続する

Atlas CloudはHermesの組み込みDeepSeekプロバイダーではなく、カスタムのOpenAI互換エンドポイントであるため、~/.hermes/config.yamlで明示的に定義します。プロバイダーブロックはベースURLとキーを保持する環境変数を指定し、モデルブロックはプレフィックス付きのDeepSeek IDを選択します。

textCopy
1inference:
2  provider: atlascloud
3  base_url: https://api.atlascloud.ai/v1
4  api_key_env: ATLASCLOUD_API_KEY
5  model:
6    default: deepseek-ai/deepseek-v4-pro

ファイルを保存し、エージェントを起動します。

textCopy
1hermes

最初のメッセージが通常の応答を返した場合、配線は正しいです。認証エラーが発生した場合は、.envのキーが間違っているか、ロードされていません。不明なモデルエラーが発生した場合は、ステップ2の/v1/models出力に対してdeepseek-ai/プレフィックスを再確認してください。

ここで最も一般的な間違いは、Atlas Cloudが応答することを期待して、Hermesの組み込みdeepseekプロバイダーを使用することです。組み込みプロバイダーはDeepSeek独自のエンドポイントとその裸のモデル名にハードワイヤされているため、DeepSeekアカウントに請求し、Atlas Cloudを完全に無視します。Atlas Cloudを介したルーティングは、意図的なカスタムプロバイダーの選択です。独自のbase_url、Atlas Cloudキー、およびプレフィックス付きのdeepseek-ai/モデルIDです。これら3つを一緒に保つことで、2つのパスが混同されることはありません。

ステップ4：安価な作業をFlashに送る

Hermesは、Web要約、ビジョン分析、コンテキスト圧縮、コマンド承認など、多くの低価値の呼び出しを舞台裏で実行します。これらにV4 Proの料金を支払うのは無駄です。補助スロットをV4 Flashに接続することで、メインループはより強力なモデルを維持し、バックグラウンドの雑用はわずかなコストで実行されます。

textCopy
1auxiliary:
2  web_extract:
3    provider: atlascloud
4    base_url: https://api.atlascloud.ai/v1
5    api_key_env: ATLASCLOUD_API_KEY
6    model: deepseek-ai/deepseek-v4-flash
7  compression:
8    provider: atlascloud
9    base_url: https://api.atlascloud.ai/v1
10    api_key_env: ATLASCLOUD_API_KEY
11    model: deepseek-ai/deepseek-v4-flash
12    timeout: 120

各補助スロットは、独自のプロバイダー、モデル、ベースURL、キー、およびフォールバックチェーンを受け入れるため、すべてのバックグラウンドタスクを個別に調整できます。

ステップ5：回復力のためにフォールバックを追加する

長時間実行されるエージェントは、最終的にレート制限またはタイムアウトした接続に遭遇します。フォールバックチェーンは、エラーを発生させる代わりに動作を継続させます。ここでは、圧縮タスクは最初にV4 Flashを試行し、次に諦める前に2番目のAtlas Cloudモデルにフォールバックします。

textCopy
1auxiliary:
2  compression:
3    provider: atlascloud
4    base_url: https://api.atlascloud.ai/v1
5    api_key_env: ATLASCLOUD_API_KEY
6    model: deepseek-ai/deepseek-v4-flash
7    fallback_chain:
8      - provider: atlascloud
9        base_url: https://api.atlascloud.ai/v1
10        api_key_env: ATLASCLOUD_API_KEY
11        model: deepseek-ai/deepseek-v3.2

Hermesは、いずれかが成功するまで各エントリを順番に試行するため、単一のプロバイダーの不具合がエージェントを停止させることはありません。スケジュールに従って無人で実行されるエージェントの場合、これは静かに回復するcronジョブと、午前3時に停止して朝にスタックトレースを残すcronジョブの違いです。

この設定が適切な場合

HermesをDeepSeek上でAtlas Cloudを介して実行することは、エージェントが触れるすべてのものに対して1つのキーと1つの請求書が必要な場合に最も理にかなっています。同じエンドポイントが画像モデルとビデオモデルも提供するため、テキストのみで開始したエージェントは、新しい統合や2番目のベンダーアカウントなしで画像を生成したり、クリップを生成したりできます。エージェントがDeepSeekのみを呼び出し、他には何も呼び出さない場合、DeepSeek独自のAPIを指す組み込みのDeepSeekプロバイダーがより簡単なパスです。Atlas Cloudルートは、単一のOpenAI互換インターフェースの背後で、モダリティを超えてモデルを追加する余地が必要になったときにその役割を果たします。

DeepSeekのラインナップが進化するにつれて維持すべき習慣として、これらのいずれかを設定ファイルにコミットする前に、すべてのモデルIDとライブ価格をatlascloud.ai/modelsで自分で確認できます。