エージェントを管理

Agent Registry を使用すると、登録済みエージェントを検査、更新、削除して、AI エコシステムのアクティブな機能をレジストリに正確に反映できます。登録されているすべてのエージェントの一覧表示と表示、手動で登録されたエージェントのメタデータまたはエンドポイントの更新、使用されなくなったエージェントの削除を行うことができます。

始める前に

  1. Agent Registry を設定する。

  2. 単一プロジェクトの設定の場合は、Agent Registry が有効になっているガバナンス プロジェクトのプロジェクト ID を取得します。複数のプロジェクトに管理境界を構成した場合は、境界全体の検出と登録に管理プロジェクトの ID を使用するか、単一プロジェクトのオペレーションにメンバー プロジェクト ID を指定します。

  3. Agent Registry にエージェントを登録します。

  4. このドキュメントの Google Cloud CLI コマンドを使用するには、gcloud CLI 環境を設定します。

必要なロール

Agent Registry で登録済みエージェントを管理するために必要な権限を取得するには、Agent Registry が有効になっているガバナンス プロジェクトに対する Agent Registry API 編集者（roles/agentregistry.editor）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

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

利用可能なエージェントを特定する

エージェントを登録すると、環境内でエージェントを検出し、エンドポイント、A2A スキル、関連するメタデータなどの詳細な構成を表示できます。

すべてのエージェントを一覧表示する

環境に登録されているすべてのエージェントを一覧表示し、エンドポイント、A2A スキル、関連するメタデータなどの詳細な構成を表示できます。

管理境界を構成した場合は、管理プロジェクトから複数のメンバー プロジェクトのエージェントを一覧表示できます。

エージェントを一覧表示する手順は次のとおりです。

コンソール

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

    [Agent Registry] に移動

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

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

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

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

gcloud

特定のロケーションのすべてのエージェントを一覧表示するには、gcloud agent-registry agents list コマンドを実行します。

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

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

  • PROJECT_ID: プロジェクト ID。管理境界を構成した場合は、管理プロジェクトの ID を指定して、境界内のすべてのメンバー プロジェクトの指定されたロケーションにあるエージェントを一覧表示します。返される各リソース名は、エージェントの ID を保持し、リクエストで指定されたプロジェクトを使用します。
  • REGION: レジストリのロケーション（us-central1、eu、global など）。管理プロジェクトでロケーションを指定すると、境界内のすべてのメンバー プロジェクトで同じロケーションのエージェントが集計されます。

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

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

コンソール

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

    [Agent Registry] に移動

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

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

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

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

    • ロケーションでフィルタするには、[ロケーション] メニューをクリックし、フィルタするロケーションを選択して、[適用] をクリックします。
    • ランタイムでフィルタするには、[ランタイム] メニューをクリックし、フィルタするランタイムを選択して、[適用] をクリックします。
    • システム作成の Google エージェントを表示または非表示にするには、テーブル ツールバーの [システム作成のエージェントを表示] または [システム作成のエージェントを非表示] をクリックします。組み込みの Google エージェントのみを一覧表示するには、[フィルタ] をクリックし、[エージェント ID] フィールドに「urn:agent:googleapis.com:」と入力して、[適用] をクリックします。

    選択した条件に一致する登録済みエージェントのリストが表示されます。

gcloud

--filter フラグを gcloud agent-registry agents list コマンドに渡して、特定のメタデータに一致するリソースのみを返すようにエージェント リストをフィルタします。

gcloud 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' を使用します。
    • 組み込みの Google エージェントのみを一覧表示するには、agentId:"urn:agent:googleapis.com:" を使用します。
    • 管理プロジェクトをクエリするときに特定のメンバー プロジェクトでフィルタするには、agentId:"urn:agent:projects-MEMBER_PROJECT_NUMBER:" を使用します。

Terraform

メタデータでフィルタして特定の登録済みエージェントを取得するには、filter 引数を使用して google_agent_registry_agent データソースを構成します。

data "google_agent_registry_agent" "filtered_agent" {
  location = "REGION"
  filter   = "displayName=\"DISPLAY_NAME\""
}

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

  • REGION: レジストリ リージョン。
  • DISPLAY_NAME: フィルタするエージェントの人が読める形式の名前（例: Support Agent）。

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

特定のエージェントの詳細（プロトコル、A2A スキル、ID など）を表示します。

コンソール

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

    [Agent Registry] に移動

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

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

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

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

    詳細ページには、エージェントの詳細を示すタブがあります。

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

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

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

gcloud

特定のエージェントの詳細なメタデータを表示するには、gcloud agent-registry agents describe コマンドを実行します。

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

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

  • AGENT_NAME: エージェントの名前（例: my-custom-agent）。
  • PROJECT_ID: プロジェクト ID。管理境界では、管理プロジェクト ID またはエージェントがデプロイされているメンバー プロジェクトの ID を指定できます。返されたリソース名は、エージェントの ID を保持し、リクエストで指定されたプロジェクトを使用します。
  • REGION: レジストリ リージョン。

Terraform

ID を使用して特定の登録済みエージェントの詳細を取得するには、google_agent_registry_agent データソースを構成します。

data "google_agent_registry_agent" "my_agent" {
  location = "REGION"
  agent_id = "AGENT_ID"
}

output "agent_create_time" {
  description = "The timestamp when the agent was registered."
  value       = data.google_agent_registry_agent.my_agent.create_time
}

output "agent_update_time" {
  description = "The timestamp when the agent was last updated."
  value       = data.google_agent_registry_agent.my_agent.update_time
}

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

  • REGION: レジストリ リージョン。
  • AGENT_ID: エージェントの固有識別子（例: my-custom-agent）。

エージェントのメタデータとエンドポイントを更新する

エージェントのランタイム URL が変更された場合、または表示名、説明、仕様をオーバーライドする場合は、エージェントのメタデータを更新できます。

Agent Registry では、Agent リソースは読み取り専用の検出リソースです。手動で登録されたエージェントを更新するには、その Service リソースが登録されたプロジェクト ID を指定して、書き込み可能な Service リソースを直接更新する必要があります。自動的に登録されたエージェントの場合は、基盤となるランタイムでエージェントを更新して、Agent Registry が変更を同期するようにします。

コンソール

Google Cloud コンソールから、利用可能なエージェントの詳細を更新します。

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

    [Agent Registry] に移動

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

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

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

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

  5. エージェントの [概要] タブで、 [編集] をクリックします。

  6. [サービスを編集] パネルで、エージェントの更新された情報（新しい名前や説明など）を入力します。

  7. [保存] をクリックします。

gcloud

特定のフラグを指定して gcloud agent-registry services update コマンドを実行し、エージェントのパラメータを変更します。

  • 表示名と説明を更新する: --display-name フラグと --description フラグを使用します。次に例を示します。

    gcloud agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --display-name="New display name" \
    --description="Updated description of the agent's purpose."

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

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

  • エンドポイント URL を更新する: --interfaces フラグを使用して、新しいエンドポイントを指定します。次に例を示します。

    gcloud agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

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

    • AGENT_NAME: エージェントの名前（例: my-support-agent）。
    • PROJECT_ID: プロジェクト ID。
    • REGION: レジストリ リージョン。
    • ENDPOINT_URL: 新しい Agent Endpoint URL（例: https://new-api.example.com/agent）。
    • PROTOCOL: エンドポイントのプロトコル バインディング。有効な値は http-json、grpc、jsonrpc です。

  • エージェントの仕様を更新する: --agent-spec-content フラグを使用します。たとえば、新しいエージェント カードがある場合は、次のようにします。

    gcloud agent-registry services update AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --agent-spec-content=AGENT_SPEC_FILE

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

    • AGENT_NAME: エージェントの名前（例: my-support-agent）。
    • PROJECT_ID: プロジェクト ID。
    • REGION: レジストリ リージョン。
    • AGENT_SPEC_FILE: 新しいエージェント仕様ファイルのパス（例: new-agent-card.json）。仕様ファイルの最大ファイルサイズは 10 KB です。

Terraform

登録済みエージェントのメタデータ、エンドポイント URL、仕様を更新するには、構成内の既存の google_agent_registry_service リソースのパラメータを変更してから、terraform apply を実行します。

resource "google_agent_registry_service" "rest_agent" {
  location     = "REGION"
  service_id   = "AGENT_NAME"
  display_name = "New Display Name"
  description  = "Updated description of the agent's purpose."

  agent_spec {
    type = "NO_SPEC"
  }

  interfaces {
    url              = "ENDPOINT_URL"
    protocol_binding = "PROTOCOL"
  }
}

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

  • REGION: レジストリ リージョン。
  • AGENT_NAME: エージェントに付ける一意の名前（例: my-support-agent）。
  • ENDPOINT_URL: エージェントの API エンドポイント URL（例: https://api.example.com/v1/agents/1234）。
  • PROTOCOL: エンドポイントのプロトコル バインディング。有効な値は HTTP_JSON、GRPC、JSONRPC です。

エージェントを削除する

Agent Registry に自動的に登録されたエージェントを削除するには、特定の Google Cloud ランタイムで基盤となるエージェントを削除する必要があります。その後、エージェントはレジストリから自動的に削除されます。

手動で登録したエージェントをレジストリから削除するには、Service リソースが登録されているプロジェクト ID を指定して、Service リソースを削除する必要があります。この操作により、エージェントが検索結果から削除され、他のツールで検出できなくなります。

コンソール

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

    [Agent Registry] に移動

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

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

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

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

  5. エージェントの [概要] タブで、 [削除] をクリックします。

  6. 確認ダイアログで「DELETE」と入力して操作を確定します。

  7. [削除] をクリックします。

gcloud

gcloud agent-registry services delete コマンドを実行します。

gcloud agent-registry services delete AGENT_NAME \
    --project=PROJECT_ID \
    --location=REGION

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

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

Terraform

Terraform 構成からエージェントを表す google_agent_registry_service リソースを削除し、terraform apply を実行します。

次のステップ