ツールセット一覧
目次
ツールセットは、エージェントに何をさせるかを決めるツールの束に名前を付けたものです。プラットフォームごと、セッションごと、作業ごとに、使えるツールを切り替えるための主な仕組みになります。
ツールセットの仕組み
すべてのツールは、必ずどれか一つのツールセットに属します。ツールセットを有効にすると、その束に入っているツールがまとめてエージェントから使えるようになります。ツールセットには三つの種類があります。
- 中核（Core） — 関係するツールをひとまとまりにしたものです（例えば
fileにはread_file、write_file、patch、search_filesが入っています） - 複合（Composite） — よくある場面に合わせて、複数の中核ツールセットをまとめたものです（例えば
debuggingには file、terminal、web のツールが入ります） - プラットフォーム（Platform） — ある動かし方に合わせて、ツールの構成をひととおり決めたものです（例えば
hermes-cliは、対話的な CLI セッションで最初から使われます）
ツールセットを設定する
セッションごと（CLI）
hermes chat --toolsets web,file,terminal
hermes chat --toolsets debugging # composite — expands to file + terminal + web
hermes chat --toolsets all # everythingプラットフォームごと（config.yaml）
toolsets:
- hermes-cli # default for CLI
# - hermes-telegram # override for Telegram gateway画面から管理する
hermes tools # curses UI to enable/disable per platformセッションの中からなら、次のように書きます。
/tools list
/tools disable browser
/tools enable discord中核ツールセット
| ツールセット | ツール | 用途 |
|---|---|---|
browser |
browser_back, browser_cdp, browser_click, browser_console, browser_dialog, browser_exec, browser_get_images, browser_navigate, browser_press, browser_scroll, browser_snapshot, browser_type, browser_vault, browser_vision |
ブラウザ操作の中核です。browser_cdp と browser_dialog は動かしている最中に判定され、セッションの開始時に CDP の接続先へ届くときだけ登録されます（/browser connect、browser.cdp_url の設定、Browserbase、Camofox のいずれか経由）。browser_dialog は、CDP の監視役がつながっているときに browser_snapshot が足す pending_dialogs と frame_tree の項目と組みで働きます。browser.backend が browser-use のときは、ほかのブラウザ用の道具の代わりに browser_exec が入ります。browser_vault は、認証情報を入れる画面のためにブラウザと一緒に付いてきます。既定では、ツール検索の後ろに回して必要になるまで読み込みません。ちょっと調べたいときは web／search のまとまりの担当で、web_search はここにあえて入れていません。disabled_toolsets: [browser] にしても取り上げられないようにするためです（#64503）。 |
clarify |
clarify |
エージェントがはっきりさせたいことがあるとき、利用者に問いかけます。 |
code_execution |
execute_code |
Hermes のツールをプログラムから呼ぶ Python スクリプトを実行します。 |
connections |
manage_connections |
利用者をアプリにつなぎます。対象は、Nous のゲートウェイを通して管理されるコネクターのアカウントと、カタログにある手元の MCP サーバーです。アプリの 2 つ目の名前付きアカウントを加えたり、アカウントの名前を変えたりもできます。デスクトップでは、どの操作も利用者が決着をつけるまで待つカードとして出ます。デスクトップ以外では、管理されたアカウントの操作がアプリごとの接続用リンクを返します。 |
coding |
composite (file + terminal + search + web + skills + browser + todo + memory + session_search + clarify + code_execution + delegation + vision) |
ソフトウェアの作業向けにコードを中心へ据えた束です。ファイルの編集、端末、検索、web の資料、スキル、ブラウザ、任せる先の切り出し、コードの実行までそろいます。 |
cronjob |
cronjob_manage |
繰り返す作業を予定に入れて管理します。 |
debugging |
composite (file + terminal + web) |
不具合を追うための束です。ファイル、プロセスと端末、web の抜き出しと検索が入ります。 |
delegation |
delegate_task |
別々に動く下請けのエージェントを起こして、並べて作業させます。 |
discord |
discord |
Discord のテキスト・埋め込み・DM といった基本の操作です（gateway でのみ動きます）。hermes-discord のツールセットで有効になります。 |
discord_admin |
discord_admin |
Discord の管理操作（追放、役割の変更、チャンネルの管理）です。hermes-discord のツールセットで有効になり、bot 側に該当する Discord の権限が要ります。 |
feishu_doc |
feishu_doc_read |
Feishu／Lark の文書の中身を読みます。Feishu の文書コメントに自動で返す仕組みが使います。 |
feishu_drive |
feishu_drive_add_comment, feishu_drive_list_comments, feishu_drive_list_comment_replies, feishu_drive_reply_comment |
Feishu／Lark のドライブでコメントを扱う操作です。コメント担当のエージェント専用で、hermes-cli などのメッセージ系ツールセットには出てきません。 |
file |
patch, read_file, search_files, write_file |
ファイルを読む、書く、探す、直す操作です。 |
computer_use |
computer_use |
cua-driver を通して、裏でデスクトップを操作します。カーソルや前面の位置を奪いません。ツールを扱えるモデルならどれでも動きます。macOS、Windows、Linux に対応し、$PATH の通った場所に cua-driver が要ります。 |
context_engine |
(varies) | いま動いている context-engine のプラグインが出すツールです（プラグインが中身を入れるまでは空です）。 |
image_gen |
image_generate |
FAL.ai を使った、文章からの画像づくりです（希望すれば OpenAI や xAI も使えます）。 |
video_gen |
video_generate, xai_video_edit, xai_video_extend |
プラグインが登録した基盤（xAI Grok-Imagine、FAL.ai の Veo 3.1／Pixverse v6／Kling 3.0／Kling O3）を使い、文章や画像から動画を作ります。画像を動かしたいときは image_url を渡し、文章から作るときは省きます。xai_video_edit と xai_video_extend は提供元に固有の編集・延長のツールで、xAI Imagine の資格情報があるときだけ使えます。 |
kanban |
kanban_attach, kanban_attach_url, kanban_attachments, kanban_block, kanban_comment, kanban_complete, kanban_create, kanban_heartbeat, kanban_link, kanban_list, kanban_request_changes, kanban_request_review, kanban_show, kanban_unblock |
複数のエージェントで足並みをそろえるためのツールです。差配役が起こした作業係（HERMES_KANBAN_TASK）と、保存済みの選択に kanban が含まれるプラットフォームに登録されます（hermes tools enable kanban --platform <p>。all／* のまとめ指定では有効になりません）。作業係は仕事を終わりにする、正式な見直しを頼む、止まっていると伝える、生きていると知らせる、コメントする、続きの仕事を作ってつなげる、といったことができます。差配側のプロファイルには、これに加えて一覧や止め解除といった板を回すためのツールが付きます。delegate_task で生まれた子は板の持ち主にはなりません。子の側ではこのツールセットが定義から外されて無効になり、親から HERMES_KANBAN_* の環境変数が渡っていても、板を直に書き換える操作は実行時に弾かれます。 |
memory |
memory |
セッションをまたいで残る記憶の管理です。 |
desktop_ui |
annotate_preview, close_terminal, desktop_preview, drive_preview, focus_pane, gui_tour, react_to_message, read_terminal, read_window_below, set_theme, show_tip |
Hermes のデスクトップアプリそのものに働きかける機能です。組み込みの端末ペインを読む・閉じる、アプリ内のブラウザを開く・読む・閉じる・操作する・書き込みを添える、アプリの背後にある OS の窓を見分ける、ペインを表に出す、メッセージにリアクションを付ける、案内を流す（アプリや下見のペインで画面の要素を光らせながら説明する）、アクセントカラー、ライト / ダークの表示モード、画面の割り付けを設定する（または利用者が選ぶためのカードを出す）、といったことができます。デスクトップアプリから始まったセッションで有効になり、つなぎ先が手元でも SSH でも URL でも Hermes Cloud でも変わりません。CLI、TUI、メッセージ、定時実行のセッションには決して現れません。 |
project |
desktop_project |
デスクトップのプロジェクト（名前を付けた、複数のフォルダーをまとめた作業場）を、create／switch／list の動作を選ぶひとつの道具で作って切り替えます。画面のある、デスクトップのセッション専用です。 |
catalog |
manage_catalog |
プラグインカタログとスキルハブを検索し、承認カードを通して、このチャットのプロファイルに項目をインストールします。デスクトップアプリから始まったセッションで有効になり、つなぎ先が手元でも SSH でも URL でも Hermes Cloud でも変わりません。CLI、TUI、メッセージ、定時実行のセッションには、設定のリストで名前が挙がっていても決して現れません。all には含まれません。既定では tool_search の後ろに控えています。外すには agent.disabled_toolsets: [catalog] を指定します。 |
safe |
image_generate, vision_analyze, web_extract, web_search (via includes) |
読むだけの調べものと、素材づくりです。ファイルへの書き込みも、端末も、コードの実行もありません。 |
search |
web_search |
web の検索だけです（抜き出しは付きません）。 |
session_search |
session_search |
過去のやりとりのセッションを探します。 |
skills |
skill_manage, skill_view, skills_list |
スキルの作成・閲覧・更新・削除と、見て回る操作です。 |
terminal |
process_manage, terminal |
シェルのコマンドの実行と、裏で動くプロセスの管理です。 |
todo |
todo_list |
セッションの中でやることの一覧を扱います。 |
tts |
text_to_speech |
文章から読み上げの音声を作ります。 |
vision |
vision_analyze |
画像を扱えるモデルによる画像の読み取りです。 |
video |
video_analyze |
動画を読み取って中身をつかむためのツールです（初めから入ってはいません。--toolsets で名指しして足します）。 |
web |
web_extract, web_search |
web の検索と、ページの中身の抜き出しです。 |
x_search |
x_search |
xAI に組み込まれた x_search の Responses ツールを使い、公開された X を読むだけで見て回ります。X API の認証付きの読み取りやアカウントの操作には xurl のスキルを使ってください。初めは切ってあります。hermes tools から自分で入れてください。xAI の資格情報（SuperGrok の OAuth か XAI_API_KEY）を設定したときだけ、この定義が登録されます。 |
yuanbao |
yb_query_group_info, yb_query_group_members, yb_search_sticker, yb_send_dm, yb_send_sticker |
Yuanbao の DM やグループの操作と、スタンプの検索です。hermes-yuanbao にだけ登録されます。 |
プラットフォームのツールセット
プラットフォームのツールセットは、ある動かし先に向けたツールの構成をひととおり決めたものです。メッセージ系のプラットフォームは、たいてい hermes-cli と同じ内容になっています。
| ツールセット | hermes-cli との違い |
|---|---|
hermes-cli |
すべてが入ったツールセットで、対話的な CLI セッションで最初から使われます。file、terminal、web、browser、memory、skills、vision、image_gen、todo、tts、delegation、code_execution、cronjob、session_search、clarify、computer_use、そして kanban のツールが入ります（いずれも実行時に check_fn で判定されます）。 |
hermes-acp |
clarify、cronjob、image_generate、text_to_speech、computer_use、kanban のツールを外します。IDE の中でのコードの作業に的を絞っています。 |
hermes-api-server |
clarify、text_to_speech、computer_use、kanban のツールを外します。それ以外はそのままで、人が応じられないプログラムからの利用に向いています。 |
hermes-cron |
hermes-cli と同じです。 |
hermes-telegram |
hermes-cli と同じです。 |
hermes-discord |
hermes-cli に discord と discord_admin を足します。 |
hermes-slack |
hermes-cli と同じです。 |
hermes-whatsapp |
hermes-cli と同じです。 |
hermes-signal |
hermes-cli と同じです。 |
hermes-matrix |
hermes-cli と同じです。 |
hermes-mattermost |
hermes-cli と同じです。 |
hermes-email |
hermes-cli と同じです。 |
hermes-sms |
hermes-cli と同じです。 |
hermes-bluebubbles |
hermes-cli と同じです。 |
hermes-dingtalk |
hermes-cli と同じです。 |
hermes-feishu |
feishu_doc_* と feishu_drive_* の五つのツールを足します（文書コメントの処理だけが使い、ふだんのチャットのつなぎ役は使いません）。 |
hermes-qqbot |
hermes-cli と同じです。 |
hermes-wecom |
hermes-cli と同じです。 |
hermes-wecom-callback |
hermes-cli と同じです。 |
hermes-weixin |
hermes-cli と同じです。 |
hermes-yuanbao |
hermes-cli に yb_* の五つのツール（DM・グループ・スタンプ）を足します。 |
hermes-webhook |
安全な範囲に絞った内容で、web_search、web_extract、vision_analyze、clarify だけです。webhook から始まった実行には、端末もファイルもブラウザも渡しません。 |
hermes-gateway |
gateway が内側で使う差配用のツールセットで、hermes-<platform> のすべてを合わせたものです。gateway がどんな送り元のメッセージでも受け取る必要があるときに使います。 |
プラグインが提供するプラットフォームには、hermes-gateway に含まれない hermes-<platform> のまとまりが暗黙に用意されます。たとえば hermes-homeassistant は、カタログの homeassistant プラグインを入れれば引き続き解決されますが、初めから入っているツールセットではなくなりました。
動的なツールセット
MCP サーバーのツールセット
設定した MCP サーバーごとに、動かしている最中に mcp-<server> というツールセットが作られます。例えば github の MCP サーバーを設定すると、そのサーバーが出しているツールをすべて含む mcp-github というツールセットができます。
# config.yaml
mcp_servers:
github:
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]こうしてできた mcp-github は、--toolsets やプラットフォームの設定から名指しできます。サーバー名をそのまま書いた github も、別名として使えます。初めから入っているツールセットと同じ名前（browser、web）をサーバーに付けた場合、その名前は、初めから入っているツールと、そのサーバーの mcp__<server>__* のツールの両方を指します。どちらか一方がもう一方を隠すことはありません。
プラグインのツールセット
プラグインは、自分の初期化のときに ctx.register_tool() を呼んで、自前のツールセットを登録できます。登録されたものは初めから入っているツールセットと並んで現れ、同じやり方で有効にも無効にもできます。
自前のツールセット
config.yaml に自前のツールセットを書けば、その案件向けの束を作れます。
toolsets:
- hermes-cli
custom_toolsets:
data-science:
- file
- terminal
- code_execution
- web
- visionまとめ指定
allまたは*— 登録されているすべてのツールセット（初めから入っているもの、動的なもの、プラグインのもの）に広がります
一部のツールには、ツールセットに属しているかどうかとは別に、使えるかどうかの判定がもう一段あります。これらは all／* だけでは有効になりません。
- 前提で決まるツール（browser、
computer_use、code_execution、Feishu、cronjob）は、その裏側の仕組みや資格情報を設定したときだけ現れます。 - 進め方で決まるツール、つまり
kanbanのツールセットは、あえて自分で入れる形にしてあります。all／*では kanban は有効になりません。kanbanを名指しで並べるか、HERMES_KANBAN_TASKを持つ差配役の作業係である必要があります。kanban のツールは共有している板の状態を書き換えるので、allのときでも切ったままにしてあります。
hermes tools との関係
hermes tools のコマンドは、プラットフォームごとにツールを一つずつ切り替えるための curses の画面を出します。ここではツールの単位で（ツールセットより細かく）扱い、結果は config.yaml に残ります。切ったツールは、そのツールセットが有効でも取り除かれます。
あわせて、個々のツールとその引数をすべて並べたツール一覧もご覧ください。