ListAgentsとは?エージェント一覧を取得する仕組み

ListAgents は「今どんなエージェントが使えるか」を尋ねる操作

Claude Code を触っていると、ときどき ListAgents という名前を目にすることがあります。名前の見た目そのままで、「List(一覧にする)」+「Agents(エージェントたち)」、つまり「利用できるエージェントの一覧をください」というリクエストを表す操作名です。

初めて見ると身構えてしまう単語ですが、やっていることはとてもシンプルです。難しい処理をしているわけではなく、「今この環境で呼び出せるエージェントはこれとこれです」という名簿を返してもらうだけ、と考えて大きく外れません。

レストランのメニュー表に近い

例え話をします。初めて入ったレストランで、いきなり「オムライスください」とは言いにくいですよね。まずメニュー表をもらって、何が注文できるかを確認します。ListAgents はこのメニュー表をもらう行為にあたります。

メニューを見て初めて「ああ、この店にはパスタもあるのか」と分かるように、一覧を取得して初めて「この環境にはコードレビュー用のエージェントが用意されているんだな」と分かる。そして実際に仕事を頼むのは、その後の別の操作です。一覧を見ること自体は、まだ何も注文していない状態だという点がポイントです。

そもそも「エージェント」って何だっけ

用語の片方だけ分からないと全体がぼやけるので、こちらも簡単に。ここで言うエージェントは、ざっくり「特定の役割を持った、代わりに作業してくれる存在」だと思ってください。

人間のチームでも、設計が得意な人、テストを書くのが速い人、ドキュメントを整えるのが上手い人、と役割が分かれていることがあります。それぞれに得意分野があって、頼む相手を選べる。エージェントもそれと同じ発想で、役割ごとに分かれた「担当者」が複数いる、というイメージです。

担当者が複数いるということは、当然「今どの担当者がいるんだっけ?」を確認したくなります。その確認手段が ListAgents というわけです。

なぜ一覧を取る操作がわざわざ用意されているのか

正直、最初は「一覧なんて設定ファイルを見れば分かるのでは」と思うかもしれません。ただ、実際に使う側に立つと、一覧取得が独立した操作になっている理由が見えてきます。

環境によって顔ぶれが変わるから

エージェントは、プロジェクトごとに用意されていたり、個人の設定として持っていたりします。つまりどこで動かすかによって、使えるエージェントの顔ぶれが変わる。だからこそ、その場で問い合わせて確かめる手段が必要になります。

引っ越し先の街で「近所にどんな店があるか」をその都度調べるのと同じで、前の環境の記憶をそのまま持ち込んでも当てにならないんですね。

ツール側が自動で把握するため

もうひとつ大きいのが、人間ではなくプログラム側が使うケースです。何かの仕組みが「利用可能なエージェントを把握してから処理を組み立てる」という動きをするとき、決まった形式で一覧を返してくれる窓口があると都合がいい。ListAgents のような名前の操作は、そういう機械同士のやり取りで使われることが多い名前です。

覚えておくとよい区別

やりたいこと	対応するイメージ
どんなエージェントがあるか知りたい	ListAgents(一覧取得)
特定のエージェントに仕事を頼みたい	一覧とは別の、呼び出し操作

この2つを混同すると「一覧を取ったのに何も起きない」と戸惑うことになります。一覧はあくまで下調べ。実行はその次の段階、と切り分けて覚えておくと迷いません。

まず押さえるべきこと

ListAgents という単語を見かけたら、「ああ、エージェントの名簿を出す話をしているんだな」と読み替えられればまずは十分です。実際にどんな形式で一覧が返るか、どんな情報が含まれるかは環境や実装によって異なるので、そこは実際に使う場面のドキュメントを確認するのが確実です。

名前から意味が推測できる操作は、慣れてくると読み飛ばせるようになります。List〜 で始まる名前を見たら「一覧取得なんだな」と当たりをつける、という読み方の癖をつけておくと、他の場面でも応用が効きます。