エージェントとツールを検索する

エージェント エコシステムが拡大するにつれて、適切なエージェントやツールを見つけることが重要になります。Agent Registry には検索機能が用意されており、エージェントと Model Context Protocol（MCP）サーバー全体で高度なキーワード検索と接頭辞検索を実行できます。

このドキュメントでは、検索クエリを作成して環境内の機能を見つける方法について説明します。

始める前に

Agent Registry でエージェントまたはツールを検索する前に、 エージェントまたは MCP サーバーを登録します。これらのタスクを実行するには、 プロジェクト ID も必要です。

このドキュメントの gcloud CLI コマンドを使用するには、Google Cloud CLI 環境を 設定していることを確認してください。

必要なロール

Agent Registry でエージェントとツールを検索するために必要な権限を取得するには、プロジェクトに対するAgent Registry API 閲覧者 （roles/agentregistry.viewer）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。

キーワード検索を実行すると、エージェントのスキルや MCP サーバーのツールなど、機能全体で特定の用語に一致するリソースを見つけることができます。 これらの機能がレジストリでどのように構造化されているかについては、 JSON スキーマをご覧ください。検索可能な フィールドの完全なリストについては、API リファレンスをご覧ください。

キーワードで検索するには、--search-string フラグを指定します。このパラメータはフリーテキスト クエリを受け入れ、論理演算子 AND、OR、NOT をサポートしています。

たとえば、フライトの予約を処理できるエージェントを検索するには、次のようにします。

gcloud alpha agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="flight OR booking"

また、提供する特定のツールまたは説明に基づいて MCP サーバーを検索することもできます。たとえば、データベース ツールを提供する MCP サーバーを検索するには、次のようにします。

gcloud alpha agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="database"

次のように置き換えます。

  • PROJECT_ID: プロジェクト ID。
  • REGION: レジストリ リージョン。

接頭辞検索はレイテンシが大幅に最適化されているため、ユーザーの入力に応じて関連するエージェントとツールをアプリケーションで動的に取得できます。

オーケストレータ インターフェースまたは自動補完機能を構築する場合は、Agent Registry で接頭辞検索を実行して、クエリ文字列の先頭に一致する結果を取得できます。接頭辞検索では、サフィックス ワイルドカード記号（*）を使用して単語の先頭を照合します。

たとえば、表示名が特定の接頭辞（Best_A2A_* など）で始まるエージェントを検索するには、次のようにします。

gcloud alpha agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Best_A2A_*"

同様に、表示名が特定の接頭辞（Prod_Server_* など）で始まる MCP サーバーを検索することもできます。

gcloud alpha agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Prod_Server_*"

次のように置き換えます。

  • PROJECT_ID: プロジェクト ID。
  • REGION: レジストリ リージョン。