クイックスタート: エージェントを検出する

検出は、エージェント ワークロードによる開発を加速するためのコア メカニズムです。Agent Registry 内を検索することで、既存の「Corporate Policy Agent」や「Flight Booking Agent」など、必要なスキルを持つ既存のエージェントを見つけることができます。これにより、重複するインテグレーションをゼロから構築する必要がなくなります。

このクイックスタートでは、Agent Registry に登録されているエージェントを検出する方法について説明します。

始める前に

このクイックスタートを開始する前に、エージェント レジストリにエージェントを登録します。これらのタスクを行うには、プロジェクト ID も必要です。

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

必要なロール

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

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

使用可能なエージェントを一覧表示する

レジストリに登録され、インデックス登録されたすべてのエージェントの完全なリストを表示します。

コンソール

  1. Google Cloud コンソールで、[エージェント レジストリ] に移動します。

    Agent Registry に移動

  2. プロジェクト選択ツールから、エージェント レジストリを設定した Google Cloud プロジェクトを選択します。

  3. [エージェント] タブを選択します。

    このページには、登録されているすべてのエージェントのリストと、名前、識別子、説明、ランタイム、ロケーションなどの詳細が表示されます。

  4. エージェントの詳細を表示するには、エージェントの名前をクリックします。

gcloud

特定のロケーションにあるすべてのエージェントを一覧表示するには、agents list コマンドを使用します。

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION

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

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

出力は、次の例のようになります。

- name: projects/1234567890/locations/us-central1/agents/my-travel-agent
  displayName: Travel Orchestrator Agent
  description: 'Decomposes natural language travel requests into sub-tasks.'
  version: 1.0.0
  protocols:
    - type: A2A_AGENT
      protocolVersion: "0.3"
      interfaces:
        - url: https://api.example.com/.well-known/agent-card.json
          protocolBinding: HTTP_JSON
  attributes:
    agentregistry.googleapis.com/system/Framework:
      framework: "google-adk"
    agentregistry.googleapis.com/system/RuntimeIdentity:
      identity: "principal://..."
  card:
    type: A2A_AGENT_CARD
    content: {...}

card フィールドには、利用可能な場合は A2A エージェント カードのすべてのコンテンツが含まれます。

登録済みエージェントをフィルタする

複数のエージェントがある場合や、特定のエージェントの登録を確認する場合は、エージェントのメタデータでリストをフィルタできます。

コンソール

  1. Google Cloud コンソールで、[エージェント レジストリ] に移動します。

    Agent Registry に移動

  2. プロジェクト選択ツールから、エージェント レジストリを設定した Google Cloud プロジェクトを選択します。

  3. [エージェント] タブを選択します。

    このページには、登録されているすべてのエージェントのリストと、名前、識別子、説明、ランタイム、ロケーションなどの詳細が表示されます。

  4. エージェントのロケーションまたはランタイム リソースでリストをフィルタします。

    • 地域でフィルタするには、[地域] メニューをクリックし、フィルタする地域を選択して、[適用] をクリックします。
    • ランタイムでフィルタするには、[ランタイム] メニューをクリックし、フィルタするランタイムを選択して、[適用] をクリックします。

    このページには、選択した条件でフィルタされた登録済みエージェントのリストが表示されます。

gcloud

--filter フラグを使用して、特定 Key-Value ペアに一致するリソースのみを返すようにエージェント リストをフィルタします。

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

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

  • PROJECT_ID: プロジェクト ID。
  • REGION: レジストリ リージョン。
  • FILTER_EXPRESSION: フィルタするエージェントのフィルタ式。たとえば、表示名でフィルタリングするには、displayName='DISPLAY_NAME' を使用します。グローバルに一意の識別子（URN）でフィルタするには、agentId='urn:agent:AGENT_URN' を使用します。

エージェントの詳細を表示する

使用するエージェントを特定している場合は、ランタイム エンドポイントやスキルの完全なリストなど、エージェントの完全なメタデータを取得できます。

コンソール

  1. Google Cloud コンソールで、[エージェント レジストリ] に移動します。

    Agent Registry に移動

  2. プロジェクト選択ツールから、エージェント レジストリを設定した Google Cloud プロジェクトを選択します。

  3. [エージェント] タブを選択します。

    このページには、登録されているすべてのエージェントのリストと、名前、識別子、説明、ランタイム、ロケーションなどの詳細が表示されます。

  4. 表示するエージェントの名前をクリックします。

    詳細ページには、エージェントの詳細のタブが表示されます。

  5. 対応するタブをクリックして、特定のエージェントの詳細を表示します。

    利用できる機能はランタイムによって異なります。[セッション]、[プレイグラウンド]、[メモリ]、[評価] などのタブは、Vertex AI Agent Engine などのマネージド ランタイムで構築されたエージェントに表示される特定の機能です。

    • 概要: エージェントのコアの詳細（エージェントの名前、識別子、ロケーション、説明、ランタイムなど）。概要には、スキルとリソース URI も表示されます。これらは、トポロジグラフでクエリを構築するために必要です。
    • オブザーバビリティ: レイテンシ、トラフィック、エラー、トークン費用などのアプリケーション中心の分析情報。このタブは Google Cloud Observability ツールと統合され、リアルタイムのパフォーマンス指標とシステムレベルの使用率が表示されるため、費用とユーザー エクスペリエンスの管理に役立ちます。詳細については、オブザーバビリティの概要をご覧ください。
    • トレース: 会話の正確なパスをステップごとに示します。入力メッセージとアシスタント メッセージの詳細な形式を含み、複雑なマルチエージェント推論ループやツール呼び出しエラーをリアルタイムでデバッグできます。詳細については、エージェントのトレースを表示するをご覧ください。
    • セキュリティ: Model Armor と Security Command Center からの検出結果（コンテンツ ポリシー違反、データ漏洩のリスク、コンプライアンス評価など）。セキュリティの詳細については、セキュリティの検出結果を表示するをご覧ください。
    • トポロジ: エージェント、割り当てられたエージェント ゲートウェイ、エージェントがやり取りする MCP サーバー間の関係とトラフィック フローの視覚的なマップ。Agent Gateway の詳細については、Agent Gateway の概要をご覧ください。トポロジの詳細については、登録済みエージェントのグラフを表示するをご覧ください。
    • ID: ポリシーの適用に使用されるエージェント プリンシパル。この ID は、たとえば、ツールとリソースに対する認証の認証プロバイダ バインディングを構成するために使用します。
    • セッション: 永続的な会話履歴と、エージェントとのアクティブなインタラクションの追跡。
    • プレイグラウンド: エージェントの動作をテストするための直接チャット インターフェース。
    • メモリ: エージェントとの過去の会話から詳細を生成または呼び出し、やり取り全体でコンテキストを保持する長期的なパーソナライズ機能。
    • 評価: すべてのエージェント評価タスクの詳細。このタブでは、新しい評価タスクの作成、指標のアップロード、ライブ トラフィックまたは合成シミュレーションに対するエージェントの認知パフォーマンスとモデルの信頼性の評価を行うことができます。

gcloud

特定のエージェントの詳細なメタデータを表示するには、agents describe コマンドを使用します。

gcloud alpha agent-registry agents describe AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION

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

  • AGENT_NAME: エージェントの名前（例: my-travel-agent）。
  • PROJECT_ID: プロジェクト ID。
  • REGION: レジストリ リージョン。

エージェントのエンドポイント、スキル定義、基盤となるフレームワーク、ランタイム ID、完全な A2A エージェント カード ペイロードなどの出力専用メタデータを使用して、Agent Development Kit（ADK）または標準の API リクエストを使用して、エージェントをオーケストレーター ワークフローに安全にバインドできます。

次のステップ