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

ディスカバリは、エージェント ワークロードによる 開発を加速させるためのコアメカニズムです。Agent Registry 内で検索することで、重複する統合をゼロから構築するのではなく、必要なスキルを持つ既存のエージェント（既存の「企業ポリシー エージェント」や「フライト予約エージェント」など）を見つけることができます。

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

始める前に

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

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

必要なロール

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

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

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

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

コンソール

  1. コンソールで [Agent Registry] に移動します。 Google Cloud

    Agent Registry に移動

  2. プロジェクト選択ツールから、Agent Registry を設定した 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. コンソールで [Agent Registry] に移動します。 Google Cloud

    Agent Registry に移動

  2. プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを 選択します。

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

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

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

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

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

gcloud

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

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. コンソールで [Agent Registry] に移動します。 Google Cloud

    Agent Registry に移動

  2. プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを 選択します。

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

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

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

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

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

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

    • 概要: エージェントの名前、 識別子、 ロケーション、説明、ランタイムなど、エージェントのコアの詳細。概要には、トポロジ グラフでクエリを作成するために必要なスキルとリソース URI も表示されます。
    • オブザーバビリティ: レイテンシ、 トラフィック、エラー、トークンの使用量など、アプリケーション中心の分析情報。このタブは Google Cloud Observability ツールと統合されており、リアルタイムのパフォーマンス指標とシステムレベルの使用率を表示して、費用とユーザー エクスペリエンスの管理に役立ちます。 詳細については、オブザーバビリティの概要をご覧ください。
    • トレース: 会話の正確なパスをステップごとに表示します。 入力メッセージとアシスタント メッセージの詳細なフォーマットを表示して、複雑な マルチエージェント推論ループやツールの呼び出しエラーをリアルタイムでデバッグできます。 詳細については、エージェントのトレースを表示するをご覧ください。
    • セキュリティ: Model Armor と Security Command Center の検出結果（ コンテンツ ポリシー違反、データ漏洩のリスク、 コンプライアンス評価など）。セキュリティの詳細については、 セキュリティの検出結果を表示するをご覧ください。
    • トポロジ: エージェント、割り当てられたエージェント ゲートウェイ、やり取りする MCP サーバー間の関係とトラフィック フローのビジュアル マップ。エージェント ゲートウェイの詳細については、 エージェント ゲートウェイの概要をご覧ください。 トポロジの詳細については、 登録済みエージェントのグラフを表示するをご覧ください。
    • 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 リクエストを使用して、エージェントをオーケストレータ ワークフローに安全にバインドできます。

次のステップ