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

# Hermes Agent を Atlas Cloud と統合するにはどうすればよいですか？

> Hermes AgentをAtlas Cloudに接続するには、~/.hermes/.envにAtlas Cloudのキーを保存し、プロバイダーを「custom」に選択し、ベースURLをhttps://api.atlascloud.ai/v1に設定し、/v1/modelsからライブモデルIDを選択します。

Hermes Agentは、OpenAI互換のカスタム推論プロバイダーとして[Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud)を利用できます。統合に必要なものは3つです。Atlas CloudのAPIキー、ベースURL `https://api.atlascloud.ai/v1`、そして[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)です。これらをHermes Agentの現在の`model:`設定に記述すれば、プロバイダー固有のSDKを使わずに、エージェントはAtlas Cloud経由で動作します。

> **重要なポイント**
>
> * 公式インストーラでHermes Agentをインストールし、Atlas Cloudのキーはソース管理ではなく`~/.hermes/.env`に保持します。
> * Hermes Agentを`provider: custom`、`base_url: https://api.atlascloud.ai/v1`で設定します。
> * モデルを選択する前に`/v1/models`に問い合わせます。モデル名は統合コードよりも速く変更されるため、チュートリアルから古いIDをコピーするよりも、ライブレスポンスの方が安全です。
> * 長時間稼働するエージェントを起動する前に`hermes doctor`を実行し、その後`hermes`で最初の会話をテストします。
> * Atlas Cloudの統合APIにより、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
```

公式プロジェクトは、PowerShellインストーラを通じてネイティブWindowsもサポートしています。Unixコマンドを自分でPowerShellに変換するのではなく、現在の[Hermes Agentインストールドキュメント](https://hermes-agent.nousresearch.com/docs/)に従ってください。

## ステップ2: Atlas Cloud APIキーを作成する

Atlas Cloudコンソールにサインインし、このHermes Agentデプロイメント用のAPIキーを作成します。アカウントの制御で許可されている場合は、専用キーを使用してください。エージェントトラフィックを分離することで、後でのローテーションや使用状況の確認が容易になります。

キーをHermes Agentのローカル環境ファイルに保存します:

```bash
printf '\nOPENAI_API_KEY=%s\n' 'replace-with-your-atlas-cloud-key' >> ~/.hermes/.env
```

プレースホルダーをローカルで置き換えてください。`config.yaml`がバックアップ、同期、またはコミットされる場合は、そこに実際のキーを含めないでください。

なぜ`OPENAI_API_KEY`を使用するのか？ Hermes Agentの現在のカスタムプロバイダーパスは、明示的なOpenAI互換のベースURLが設定されている場合、その環境変数を解決します。Atlas Cloudは、その互換インターフェースでベアラートークン認証を使用します。

## ステップ3: ライブのAtlas CloudモデルIDを取得する

モデルIDを推測しないでください。[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='replace-with-your-atlas-cloud-key'

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

Hermesのデプロイメントに必要な動作（特にツール使用、推論、コンテキスト長、想定レイテンシ）をサポートするテキストモデルを選択します。APIから返された正確な`id`をコピーします。

永続的なエージェントの場合は、最も安いトークン価格だけに最適化するのではなく、まず汎用のツール対応モデルから始めてください。統合が機能した後、要約やその他のルーチンタスクには低コストのモデルをテストできます。

## ステップ4: Hermes AgentをAtlas Cloudに向ける

`~/.hermes/config.yaml`を開き、現在のトップレベルの`model:`セクションを設定します:

```yaml
model:
  default: "replace-with-a-live-atlas-cloud-model-id"
  provider: "custom"
  base_url: "https://api.atlascloud.ai/v1"
```

キーは`~/.hermes/.env`に保持します。YAMLファイルにはプロバイダー、エンドポイント、モデルIDのみが必要です。

この詳細は重要です。古いHermes Agentの例では`inference:`ブロックを使用している場合があるためです。現在の公式設定サンプルでは`model:`を使用しています。インストールされたバージョンの動作が異なる場合は、`hermes update`を実行し、そのバージョンに付属の設定ドキュメントを確認してから設定を変更してください。

## ステップ5: 設定を診断する

Hermes Agentの組み込みチェックを実行します:

```bash
hermes doctor
```

次にエージェントを起動します:

```bash
hermes
```

外部ツールを必要としない小さなテストリクエストを送信します。例:

```text
使用しているモデル名を返信し、このHermesセッションで利用可能なツールを要約してください。
```

通常のストリーミングレスポンスが返ってくれば、Hermesが認証、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"
```

組み込みのプロバイダーを選択すると、リクエストがAtlas Cloudではなく、そのプロバイダー自身のエンドポイントにルーティングされる可能性があります。

### 古いチュートリアルに一致する設定だが失敗する

Hermes Agentは急速に進化しています。ファイルを現在の[公式設定リファレンス](https://hermes-agent.nousresearch.com/docs/user-guide/configuration)と比較し、`hermes config get`を使用してアクティブなプロファイルを検査してください。特に、バージョンが現在の`model:`構造を期待しているかどうかを確認してください。

## 統合を再構築せずにモデルを変更する方法

Atlas Cloudがカスタムプロバイダーとして設定されると、モデルの切り替えは[ライブモデルカタログ](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new)から新しいIDを取得するだけで済みます:

1. `/v1/models`に問い合わせます。
2. `~/.hermes/config.yaml`の`model.default`を更新します。
3. `hermes doctor`を実行します。
4. 新しいテスト会話を開始します。

エンドポイントと認証処理は同じままです。これがエージェントにとって統合APIの実用的な価値です。モデル評価が新しいSDK統合ではなく、設定変更になります。

## この設定が適している場合

Atlas Cloud統合は、次のような場合に適しています:

* 1つのアカウントでHermes Agentに複数のモデルファミリーへアクセスさせたい場合。
* 時間の経過とともにメインモデルをベンチマークまたは交換する予定がある場合。
* プロバイダー固有のクライアントコードではなく、OpenAI互換のエンドポイントを希望する場合。
* 将来のHermesスキルで、同じプラットフォームからの画像や動画モデルへのアクセスが必要になる可能性がある場合。

エージェントが恒久的に1つのプロバイダーを使用し、Atlas Cloudのより広範なモデルカタログが必要ない場合は、直接のモデルプロバイダー統合の方がシンプルかもしれません。柔軟性と一元化されたアクセスが、最短の単一プロバイダー設定よりも重要かどうかによって、適切な選択は異なります。

## 最終チェックリスト

Hermes Agentを無人で稼働させる前に、5つの項目すべてを確認してください:

- Atlas Cloudのキーがバージョン管理の外部に保存されている。
- `provider`が`custom`に設定されている。
- `base_url`が正確に`https://api.atlascloud.ai/v1`である。
- `model.default`がライブモデルエンドポイントからのIDと一致している。
- `hermes doctor`と簡単な会話の両方が成功する。

これらのチェックが完了すれば、Hermes AgentはAtlas Cloudと統合されています。これで、ツール、メモリ、スキル、ユーザーインターフェースを変更することなく、同じエージェントの背後でさまざまな言語モデルを評価できます。

## FAQ

### Hermes Agentには、組み込みのAtlas Cloudプロバイダーがありますか？

専用のAtlas Cloudプロバイダは必要ありません。Hermes Agentは、Atlas CloudのベースURLとAPIキーを使用して、カスタムのOpenAI互換プロバイダ経由で接続できます。

### Atlas CloudのHermes Agent向けベースURLは何ですか？

https://api.atlascloud.ai/v1 を OpenAI 互換のベース URL として使用してください。

### Atlas Cloud APIキーはどこに保存すべきですか？

それを ~/.hermes/.env に OPENAI_API_KEY として保存し、実際のキーは設定ファイル、スクリーンショット、バージョン管理の対象外にしてください。

### Hermes AgentはどのAtlas Cloudモデルを使用すべきですか？

https://api.atlascloud.ai/v1/models にクエリを実行し、ツール使用、推論、コンテキスト、レイテンシ、コストの要件を満たす現在のテキストモデルを選択してください。

### 統合を確認するにはどうすればよいですか？

hermes doctorを実行し、hermesコマンドでHermesを起動し、小さなテストプロンプトを送信してください。認証エラーや不明なモデルエラーは、通常、APIキー、ベースURL、またはモデルIDが原因です。