Hermes Agent Wiki 非公式・日本語wiki

連携

目次

Hermes Agent は、AI の推論、ツールサーバー、IDE での作業、プログラムからの呼び出しなど、さまざまな外部システムとつながります。これらの連携によって、Hermes にできることと、動かせる場所が広がります。

AI プロバイダーとルーティング

Hermes は複数の AI 推論プロバイダーを最初から扱えます。対話形式で設定するなら hermes model を使い、config.yaml に直接書くこともできます。

  • AI プロバイダー — OpenRouter、Anthropic、OpenAI、Google、そして OpenAI 互換のエンドポイント全般。Hermes は画像認識・ストリーミング・ツール呼び出しといった機能の対応状況を、プロバイダーごとに自動で判別します。
  • プロバイダールーティング — OpenRouter へのリクエストを、実際にどのプロバイダーが処理するかを細かく指定できます。並び替え、許可リスト、拒否リスト、優先順位の明示によって、費用・速度・品質のどれを取るかを調整できます。
  • フォールバックプロバイダー — 主に使っているモデルでエラーが起きたとき、予備の LLM プロバイダーへ自動的に切り替えます。主モデルのフォールバックに加えて、画像認識・圧縮・ウェブ本文抽出といった補助処理に対する独立したフォールバックも備えています。

ツールサーバー(MCP)

  • MCP サーバー — Model Context Protocol を通じて、Hermes を外部のツールサーバーにつなぎます。GitHub、データベース、ファイルシステム、ブラウザ基盤、社内 API などのツールを、Hermes 用のツールを自作せずに使えます。stdio と SSE の両方の通信方式、サーバーごとのツール絞り込み、対応状況に応じたリソースやプロンプトの登録に対応しています。

ウェブ検索のバックエンド

web_search ツールと web_extract ツールは 8 つのバックエンドに対応しており、config.yamlhermes tools で設定します。

バックエンド 環境変数 検索 抽出 クロール
Firecrawl(既定) FIRECRAWL_API_KEY
SearXNG SEARXNG_URL
Brave(無料枠) BRAVE_SEARCH_API_KEY
DuckDuckGo(ddgs) _(なし)_
Tavily TAVILY_API_KEY(省略可)
Exa EXA_API_KEY
Parallel PARALLEL_API_KEY
xAI XAI_API_KEY

設定例です。

web:
  backend: firecrawl    # firecrawl | searxng | brave-free | ddgs | tavily | exa | parallel | xai

web.backend を指定しない場合は、用意されている API キーからバックエンドが自動的に選ばれます。FIRECRAWL_API_URL を使えば、自分で立てた Firecrawl も利用できます。hermes tools で Tavily を選ぶ場合は、キーがなくても動きます。

ブラウザ操作

Hermes には本格的なブラウザ操作機能があり、サイトの閲覧、フォームの入力、情報の取り出しを、いくつかのバックエンドから選んで実行できます。

  • Browser Use Cloud — 検知されにくい設定、住宅用プロキシ、CAPTCHA の突破、使い回せるブラウザプロファイルを備えた、管理型の Chromium
  • Browserbase — もうひとつのクラウドブラウザ提供元。管理型のブラウザ、ボット対策への対応、CAPTCHA の突破、住宅用プロキシを備えています
  • 手元の Chromium 系ブラウザ(CDP 接続) — 起動中の Chrome、Brave、Chromium、Edge に /browser connect でつなぎます
  • 手元の Chromiumagent-browser コマンドで動く、画面を出さないローカルブラウザ

設定と使い方は ブラウザ操作 を参照してください。

音声と TTS のプロバイダー

すべてのメッセージングプラットフォームで、音声合成と音声認識が使えます。

プロバイダー 品質 費用 API キー
Edge TTS(既定) 良好 無料 不要
ElevenLabs 非常に高い 有料 ELEVENLABS_API_KEY
OpenAI TTS 良好 有料 VOICE_TOOLS_OPENAI_KEY
MiniMax 良好 有料 MINIMAX_API_KEY
xAI TTS 良好 有料 XAI_API_KEY
NeuTTS 良好 無料 不要

音声認識は 8 つのプロバイダーに対応しています。手元で動く faster-whisper(無料・端末内で処理)、ローカルコマンドのラッパー、Groq、OpenAI Whisper API、Mistral、xAI、ElevenLabs Scribe、DeepInfra です。音声メッセージの文字起こしは、Telegram、Discord、WhatsApp をはじめとする各プラットフォームで動きます。詳しくは 音声と TTS音声モード を参照してください。

IDE・エディタとの連携

  • IDE 連携(ACP) — VS Code、Zed、JetBrains など ACP に対応したエディタの中で Hermes Agent を使えます。Hermes は ACP サーバーとして動き、チャットのやり取り、ツールの動作、ファイルの差分、実行したコマンドをエディタ内に表示します。

プログラムからの利用

  • API サーバー — Hermes を OpenAI 互換の HTTP エンドポイントとして公開します。OpenAI 形式に対応したフロントエンド(Open WebUI、LobeChat、LibreChat、NextChat、ChatBox)なら、Hermes をバックエンドとしてつなぎ、そのツール群をまるごと使えます。

記憶とパーソナライズ

  • 組み込みの記憶MEMORY.mdUSER.md のファイルによる、選び抜かれた記憶を持続させる仕組みです。エージェントは個人的なメモと利用者のプロフィールを、量を抑えた形で保ち、セッションをまたいで引き継ぎます。
  • 記憶プロバイダー — 外部の記憶バックエンドをつないで、さらに踏み込んだパーソナライズができます。対応しているのは 8 つで、Honcho(対話的推論)、OpenViking(段階的な検索)、Mem0(クラウドでの抽出)、Hindsight(知識グラフ)、Holographic(手元の SQLite)、RetainDB(ハイブリッド検索)、ByteRover(CLI 方式)、Supermemory です。

メッセージングプラットフォーム

Hermes は 27 以上のメッセージングプラットフォームでゲートウェイのボットとして動き、どれも同じ gateway の仕組みで設定します。

プラットフォームの比較表と設定手順は、メッセージングゲートウェイの概要 を参照してください。

主要なプラットフォームには「ボットやアプリを作る」ための決まった URL があり、なかにはパラメータを付けると目的のフォームが開いた状態で始まるものもあります。管理画面を探し回らずに、ここから直接どうぞ。

プラットフォーム 直行リンク 開くもの
Telegram t.me/BotFather BotFather とのチャット。/newbot を送るとボットのトークンが発行されます
Discord discord.com/developers/applications?new_application=true 開発者ポータル。New Application のダイアログが開いた状態になります
Slack api.slack.com/apps?new_app=1 Create New App のダイアログ。*From an app manifest* を選び、hermes slack manifest --agent-view が出力するマニフェストを貼り付けます
LINE developers.line.biz/console LINE Developers Console。Messaging API のチャネルを作れます
Feishu/Lark open.feishu.cn/app Feishu のオープンプラットフォーム管理画面。独自アプリを作れます

たどり着いたあとに何をするかは、各プラットフォームの設定ページで説明しています。

共同作業の場

  • Buzz — Block による、Nostr を基盤とした人とエージェントの作業空間です。つなぎ方は 3 通りあり、Buzz Desktop が Hermes を管理下の ACP ランタイムとして起動する方法、buzz-acp の中継ブリッジがサーバー側で Hermes の識別情報を持つ方法、ネイティブのゲートウェイプラットフォームが Hermes の記憶・スキル・承認・定期実行をそのまま携えて Buzz のチャンネルに参加する方法です。3 つの比較は概要ページにあります。

ホームオートメーション

  • Home Assistant — 4 つの専用ツール(ha_list_entitiesha_get_stateha_list_servicesha_call_service)で家じゅうのスマート機器を操作します。HASS_TOKEN を設定すると、Home Assistant のツール群が自動的に有効になります。

プラグイン

  • プラグインの仕組み — 本体のコードに手を入れずに、独自のツール、ライフサイクルフック、CLI コマンドを足せます。プラグインは ~/.hermes/plugins/、プロジェクト内の .hermes/plugins/、そして pip でインストールしたエントリーポイントから見つけ出されます。
  • プラグインを作る — ツール・フック・CLI コマンドを備えた Hermes のプラグインを作るための手順書です。

学習と評価

  • バッチ処理 — 何百ものプロンプトに対してエージェントを並列で走らせ、ShareGPT 形式の構造化された行動データを生成します。学習データの作成や性能の評価に使えます。