Hermes エージェントを接続する
自分のパソコンで Hermes エージェントを動かしていて、Riff Home から話しかけたい方へ。エージェントはチャット専用です。返信や投稿にはウェブ上のテキストが含まれ、エージェントはコマンドを実行できるため、Riff は返信や投稿をエージェントに送りません。
1. Hermes の API サーバーをオンにする
エージェントのパソコンで、次の行を ~/.hermes/.env に追加します。
| 行 | 役割 |
|---|---|
API_SERVER_ENABLED=true | Riff が話しかける API サーバーをオンにします(ポート 8642) |
API_SERVER_KEY= と長いランダムなキー | Riff が送るキーです。このキーとアドレスを知っている人は誰でもエージェントを使えます |
API_SERVER_CORS_ORIGINS=chrome-extension:// と Riff の ID | この Riff を受け入れます(手順3に正確な行が表示されます) |
API_SERVER_HOST=0.0.0.0 は、Riff がトンネルではなくネットワーク経由でエージェントにアクセスする場合だけ追加します。
2. ゲートウェイを再起動する
API サーバーは Hermes のゲートウェイの一部です。そのパソコンのターミナルで hermes gateway restart を実行します(または hermes gateway で起動します)。
hermes serveではありません。そちらはダッシュボードを起動するもので、API サーバーではありません。- 再起動は普通のターミナルから行いましょう。エージェント自身にゲートウェイの再起動を頼むと、実行中のセッションが終了します。
3. Riff に追加する
- Riff Home › Models(モデル) で、Add a model app(モデルアプリを追加) の Add(追加) をクリックします。
- アプリ:Hermes agent(Hermes エージェント)。アドレス:応答する場所。例:
192.168.1.30:8642やトンネルのagent.yourdomain.com。API キー:手順1のAPI_SERVER_KEY。 - Save and connect(保存して接続) をクリックし、そのアドレスについてのブラウザの確認を許可します。
「設定が1つ必要」:拡張機能 ID の行
Hermes は、キーを持つ人なら誰にでもモデルの一覧を見せますが、動作するのは知っているブラウザ拡張機能のためだけです。そのため、カードはエージェントを見つけられても、チャットのメッセージはすべて拒否されることがあります。Riff はこれを確認し、その場合カードに Needs one setting(設定が1つ必要) と、Riff 自身の ID を含む正確な行を表示します。
API_SERVER_CORS_ORIGINS=chrome-extension:// に続けて Riff の ID。
- カードの行を
~/.hermes/.envにコピーします。すでにその行がある場合は、カンマの後に新しい ID を追加します。 hermes gateway restartを実行します。- カードの Connect(接続) をクリックします。
ID は、このブラウザにあるこの Riff のものです。別のブラウザの Riff や、新しいコピーとして読み込み直した Riff は別の ID を持つので、それぞれの行が必要です。
どこからでも接続:トンネル
トンネルを使うと、ルーターのポートを開けずにエージェントに https アドレスを持たせられます。Cloudflare Tunnel では、ホスト名をそのパソコン上のエージェントのポートに向けます。~/.cloudflared/config.yml に:
hostname: agent.yourdomain.comservice: http://localhost:8642
そのあと、上と同じ手順で agent.yourdomain.com を Riff に追加します。エージェントは localhost で待ち受けたままでよいので、API_SERVER_HOST は不要です。トンネル経由では、入力した内容が Cloudflare を通ってあなたのパソコンに届きます。
キーを安全に保つ
トンネルを使う場合、インターネットと、あなたのパソコンでコマンドを実行できるエージェントとの間にある鍵は、このキーだけです。
- 長いランダムなキーを使い、漏れた可能性があれば変更しましょう。
- Riff はキーを他の設定とは分けて、Riff 自身のページだけが読める場所に保存します。バックアップにも Copy agent log(エージェントログをコピー) にも含まれません。
- エージェントが確認なしで実行できるコマンドの一覧を絞り込みましょう。Riff はエージェントの承認リクエストを表示しますが(エージェントとチャットする)、それはエージェントが尋ねたことに限られます。