AGTCloud API Docs
ガイドAPIリファレンス連携とリソース更新とヘルプ

Hermes Agent

Hermes Agent CLIでAGTCloudを設定して使用します。

Hermes Agent はターミナル内で実行されるエージェントであり、ユーザーの承認後にファイルの読み取りと書き込み、コマンドの実行、ツールの呼び出しを行うことができます。

このチュートリアルでは、追加の設定ツールを使わずに、Hermes Agent に付属する Custom Endpoint から AGTCloud の Chat Completions API に接続し、基本的な対話を検証する方法を紹介します。ファイル操作、Web 検索、MCP、Skills などの拡張機能は、このチュートリアルの検証対象外です。

事前準備

開始前に、次の項目を確認してください。

  • Hermes Agent がサポートするオペレーティング システムと端末環境を準備します。
  • AGTCloudに登録してログインします。
  • API Keys ページに AGTCloud API Keyを作成します。
  • モデルマーケットプレイスから、現在のAPI Keyで利用可能で Chat Completions をサポートするモデルIDをコピーします。
  • 機密コードや運用認証情報が含まれないテストディレクトリを準備します。

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 モデルProviderの設定ウィザードを備えています。すでに開いているHermesセッション内ではなく、通常のターミナルで次のコマンドを実行してください。

hermes model

カスタムエンドポイントの選択

Provider リストで Custom endpoint を選択します。異なるバージョンの完全名は Custom endpoint (self-hosted / VLLM / etc.) として表示される場合があります。

AGTCloud 接続情報を入力します

ウィザードの現在のバージョンに応じて、次の手順を実行します。

Hermes Agent フィールド内容を入力してください
Provider Name(存在する場合)AGTCloud
Base URLhttps://api.agtcloud.cn/v1
API Keyyour-api-key
API / Wire ModeChat Completions または chat_completions
ModelMODEL_ID
Context Length初めての構成では空白のままにして、クライアントが自動的に識別できるようにすることをお勧めします。

your-api-key を AGTCloud API Key に置き換え、MODEL_ID を現在のAPI Keyで利用可能なモデルID に置き換えます。

設定の保存

ウィザードの概要を確認して保存します。通常の設定は ~/.hermes/config.yaml に書き込まれ、API Key などの機密値は 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 Keyを共有設定例に書き込んだりする必要はありません。

設定を確認する

ウィザードが完了したら、次のコマンドを使用して現在の設定を確認できます。

hermes config
hermes config get model
hermes config check
  • hermes config 現在の設定項目を開くか表示します。
  • hermes config get model 現在のモデル設定を確認します。
  • hermes config check 設定形式と必須フィールドを確認してください。

出力をチェックするときに、完全なAPI Keyをコピーしたり共有したりしないでください。構成がまだ別の Providerを指している場合は、hermes model を再実行してカスタムエンドポイントのセットアップを完了します。

起動して接続を確認する

セキュリティテストディレクトリに入る

cd /path/to/safe/test-project

本番用認証情報、顧客データ、または未公開のソースコードが含まれるディレクトリには初めて接続しないでください。

開始 Hermes Agent

hermes

hermes chat を使用して対話型セッションを開始することもできます。

基本的な会話の検証を完了する

入力ボックスに送信してください:

以下にのみ返信してください。AGTCloud 接続は成功しました。ツールを呼び出さないでください。

応答を正常に受信できれば、Base URL、API Key、モデルを使った基本的な Chat Completions 接続を確認できます。この手順では通常の API 利用量が発生します。

オプションの検証ツール呼び出し

選択したモデルがツール呼び出しをサポートしている場合、これを README.md を含むテストディレクトリに送信できます。

必ずお読みくださいREADME.md，そして、プロジェクトの目的を 3 つのポイントで要約します。ファイルを変更したり、他のコマンドを実行したりしないでください。

デフォルトの手動承認を維持し、まず実行する操作の Hermes Agent を確認してから、それを許可するかどうかを決定します。

初めて使用するときは操作承認をオフにしないでください

--yolo を使用したり、危険な行為の承認をオフに設定したりしないでください。 Hermes Agent コマンドを実行してファイルにアクセスできます。最初の検証では、ケースバイケースでツールのリクエストを確認する必要があります。

モデルを切り替える

新しいモデルを追加する、エンドポイントを変更する、または API Keyを置き換える必要がある場合は、現在のセッションを終了して次を実行してください。

hermes model

すでに開いているセッションでは、/model を使用して、すでに構成されている Providerとモデルを切り替えることができます。 /model は、新しいカスタムエンドポイントを作成する機能ではありません。対象モデルがまだ設定されていない場合は、最初にターミナル コマンド hermes model を使用してください。

MODEL_ID は単なるプレースホルダーです。 モデルマーケットプレイス で API Key に現在表示されている完全なモデルIDを常に使用し、バージョンごとに異なる可能性がある固定の推奨モデルに依存しないでください。

よくある質問

現象優先して確認する項目対処方法
hermes コマンドが見つかりませんインストール結果と PATHターミナルを再度開き、hermes version を実行します。それでも結果が得られない場合は、該当するシステムの公式インストール コマンドを再実行してください。
hermes doctor 例外を報告するPython、システム ツールとインストール ディレクトリ診断結果に従って現在の環境を修復します。複数の Hermes Agent インストール ソースを混在させないでください。
401 を返すAPI Keyの内容とAPI Keyの状態有効なAPI Keyを再度コピーします。入力された内容に余分なスペースが含まれていないことを確認してください。
403 を返すトークンの権限、モデルの権限、およびアカウントのステータスコンソールで API Key のステータスと現在のアカウントの利用可能なモデル範囲を確認します。
404 を返すBase URL、重複した /v1 とモデルIDhttps://api.agtcloud.cn/v1 を使用し、完全なエンドポイントURLを入力せず、完全なモデルIDを再コピーします。
モデルがありません現在のAPI Keyで利用可能なモデルとプロトコルのサポート現在のAPI Keyで利用可能で、Chat Completions をサポートするモデルを選択してください
まだ他の Providerを使用していますhermes model の現在の選択と保存された結果ウィザードを再実行し、カスタムエンドポイントを選択し、hermes config check 経由で設定を確認します。
会話は機能するがツールが失敗するモデルツールの呼び出し機能と応答形式ツール呼び出しをサポートするモデルに切り替えます。最初に複雑なツールを無効にして、読み取り専用操作のみを確認してください
コンテキスト長の認識に失敗しましたモデルのメタデータと手動で入力された値hermes model を再実行します。モデルの実際の上限がわかっている場合にのみ、コンテキスト長を手動で設定します。
拡張ツールの認証情報が不足しているヘルパー ツールの独立したサービス構成これらの機能には追加のサービスと認証情報が必要になる場合があり、AGTCloud メインの会話モデル キーの設定範囲内にありません。

特定できない問題が発生した場合は、hermes doctor と hermes config check を実行し、リクエスト時間、Base URL、モデルID、HTTP ステータス、および機密情報を除いたエラー情報を記録し、エラーとトラブルシューティング を確認します。完全なAPI Keyを送信しないでください。

セキュリティ上の推奨事項

  • API Keyをプロジェクト ファイル、Git リポジトリ、コマンド レコード、スクリーンショット、ログ、または共有設定に書き込まないでください。
  • 最初の使用はセキュリティ テストディレクトリで実行し、ファイル、コマンド、およびネットワーク アクセス要求を 1 つずつチェックする必要があります。
  • --yolo や設定項目による危険動作の確認をオフにしないでください。
  • 信頼できないコードを扱う場合、Docker などの分離環境を使用してリスクを軽減できますが、それでもマウント ディレクトリと認証情報を確認する必要があります。
  • API Keyの漏えいの疑いがある場合は、コンソールで直ちに無効にするか削除し、新しいキーを作成します。

次のステップ

OpenClaw

OpenClawでAGTCloudを設定して使用します。

SDK 概要

プロトコルに応じてOpenAI、Anthropic、またはGeminiのクライアント SDKを選び、接続前の確認を完了します。

このページの内容

事前準備Hermes AgentをインストールするAGTCloudを設定するカスタムエンドポイントの選択AGTCloud 接続情報を入力します設定の保存設定を確認する起動して接続を確認するセキュリティテストディレクトリに入る開始 Hermes Agent基本的な会話の検証を完了するオプションの検証ツール呼び出しモデルを切り替えるよくある質問セキュリティ上の推奨事項次のステップ