Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

エージェントを管理

エージェントのフリートを効果的に管理するには、AI エコシステムの進化に合わせてエージェントの詳細を表示して更新し、メタデータをオーバーライドするか、使用されなくなったエージェントを削除して、レジストリを正確に保つ必要があります。

このドキュメントでは、登録済みエージェントの詳細と構成を表示して変更する方法について説明します。

始める前に

エージェントを管理する前に、エージェントがエージェントレジストリに登録されていることを確認してください。これらのタスクを行うには、プロジェクト ID も必要です。

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

必要なロール

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

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

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

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

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

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

コンソール

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

Agent Registry に移動
プロジェクト選択ツールから、エージェントレジストリを設定した Google Cloud プロジェクトを選択します。
[エージェント] タブを選択します。

このページには、登録されているすべてのエージェントのリストが表示されます。リストには、エージェントの名前、識別子、タイプ、説明、バージョン、ランタイム、場所が含まれます。
エージェントの詳細を表示するには、エージェントの名前をクリックします。

gcloud

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

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

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

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

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

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

コンソール

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

Agent Registry に移動
プロジェクト選択ツールから、エージェントレジストリを設定した Google Cloud プロジェクトを選択します。
[エージェント] タブを選択します。

このページには、登録されているすべてのエージェントのリストが表示されます。リストには、エージェントの名前、識別子、タイプ、説明、バージョン、ランタイム、場所が含まれます。
エージェントのロケーションまたはランタイムリソースでリストをフィルタします。
- 地域でフィルタするには、[地域] メニューをクリックし、フィルタする地域を選択して、[適用] をクリックします。
- ランタイムでフィルタするには、[ランタイム] メニューをクリックし、フィルタするランタイムを選択して、[適用] をクリックします。
このページには、選択した条件に一致する登録済みエージェントのフィルタされたリストが表示されます。

gcloud

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

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

FILTER_EXPRESSION は、フィルタするエージェントのフィルタ式に置き換えます。たとえば、次のフィルタを使用できます。

表示名でフィルタするには、displayName='DISPLAY_NAME' を使用します。
グローバルに一意の識別子（URN）で検索するには、agentId='urn:agent:AGENT_URN' を使用します。

Terraform

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

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

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

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

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

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

コンソール

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

Agent Registry に移動
プロジェクト選択ツールから、エージェントレジストリを設定した Google Cloud プロジェクトを選択します。
[エージェント] タブを選択します。

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

詳細ページには、エージェントの詳細のタブが表示されます。
対応するタブをクリックすると、特定のエージェントの詳細が表示されます。

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

gcloud

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

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

AGENT_NAME は、エージェントの名前に置き換えます（例: my-custom-agent）。

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 API では、Agent リソースが検出に使用されます。したがって、登録済みの Service リソースを直接更新する必要があります。

コンソール

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

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

Agent Registry に移動
プロジェクト選択ツールから、エージェントレジストリを設定した Google Cloud プロジェクトを選択します。
[エージェント] タブを選択します。

このページには、登録されているすべてのエージェントのリストが表示されます。リストには、エージェントの名前、識別子、タイプ、説明、バージョン、ランタイム、場所が含まれます。
更新するエージェントの名前をクリックします。
エージェントの [概要] タブで、 [編集] をクリックします。
[サービスを編集] パネルで、エージェントの更新された情報（新しい名前や説明など）を入力します。
[保存] をクリックします。

gcloud

特定のフラグを指定して gcloud CLI を使用し、エージェントのパラメータを変更します。

表示名と説明を更新する: --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
```
次のように置き換えます。
- ENDPOINT_URL: 新しいエージェントエンドポイント 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
```
AGENT_SPEC は、新しいエージェント仕様ファイルの名前（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.remote-service.com/v1/agents/1234）。
PROTOCOL: エンドポイントのプロトコルバインディング。有効な値は HTTP_JSON、GRPC、JSONRPC です。

エージェントを削除する

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

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

コンソール

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

Agent Registry に移動
プロジェクト選択ツールから、エージェントレジストリを設定した Google Cloud プロジェクトを選択します。
[エージェント] タブを選択します。

このページには、登録されているすべてのエージェントのリストが表示されます。リストには、エージェントの名前、識別子、タイプ、説明、バージョン、ランタイム、場所が含まれます。
削除するエージェントの名前をクリックします。
エージェントの [概要] タブで、[ 削除] をクリックします。
確認ダイアログで「DELETE」と入力して、アクションを確定します。
[削除] をクリックします。

gcloud

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

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

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

Terraform

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

次のステップ

トポロジグラフを使用してエージェントの関係を表示する方法を確認する。
自然言語クエリを使用してエージェントとツールを検索する方法について説明します。

エージェントを管理 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

必要なロール

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

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

コンソール

gcloud

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

コンソール

gcloud

Terraform

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

コンソール

gcloud

Terraform

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

コンソール

gcloud

Terraform

エージェントを削除する

コンソール

gcloud

Terraform

次のステップ

エージェントを管理