エージェントを管理

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

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

始める前に

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

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

必要なロール

Agent Registry に登録されているエージェントを管理するために必要な権限を取得するには、管理者に プロジェクトに対するAgent Registry API 編集者 （roles/agentregistry.editor）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: レジストリ リージョン。

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

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

コンソール

  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"

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

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

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

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

コンソール

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

    Agent Registry に移動

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

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

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

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

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

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

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

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

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

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

Agent Registry API では、検出に Agent リソースが使用されます。そのため、登録済みの Service リソースを直接更新する必要があります。

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

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

    gcloud alpha 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 alpha 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 alpha agent-registry services update AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --agent-spec-content=AGENT_SPEC

    AGENT_SPEC は、新しいエージェント仕様の名前に置き換えます（例: new-agent-card.json）。

エージェントを削除する

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

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

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

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

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

次のステップ