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

エンドポイントの登録

Agent Registry では、エンドポイントはエージェントがアクセスするターゲット URL（通常は REST API）を表します。これらの宛先を Agent Registry 内でマネージドエージェントコンポーネントとして登録することで、エージェントフリートが接続できる外部エンドポイントを一元的に管理できます。

このドキュメントでは、レジストリに外部エンドポイントを明示的に登録する方法について説明します。

始める前に

始める前に、Agent Registry を設定します。これらのタスクを行うには、プロジェクト IDが必要です。

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

必要なロール

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

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

エンドポイントを登録する

エンドポイントはカスタムの外部宛先であるため、手動登録を使用して Agent Registry に追加します。

コンソール

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

Agent Registry に移動
プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを選択します。
[エンドポイント] タブを選択します。
[エンドポイントを追加] をクリックします。
[エンドポイントの詳細] パネルで、表示名、説明、地理的リージョン、宛先 URL を入力します。

必要に応じて、このパネルで [接続をテスト] をクリックして、宛先 URL への接続をテストします。

**注:** プライベート URL を使用するエンドポイントを登録できます。ただし、接続テストはパブリックエンドポイントでのみ機能し、パブリック URL に到達できるかどうかを確認します。このテストでは、Gemini Enterprise Agent Platform エンドポイントの Agent Runtime など、認証済みデータの送信を必要とするプライベート URL やエンドポイントはサポートされていません。
[保存] をクリックします。

gcloud

endpoint-spec-type が no-spec の Service リソースを作成します。

エンドポイントを登録し、インターフェース接続の詳細を定義します。

gcloud agent-registry services create ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --endpoint-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

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

ENDPOINT_NAME: エンドポイントに付ける名前（my-external-api など）。
PROJECT_ID: プロジェクト ID。
REGION: レジストリリージョン。
DISPLAY_NAME: エンドポイントの人が読める形式の名前。
ENDPOINT_URL: ターゲット URL（https://api.example.com/v1/data など）。
PROTOCOL: インターフェースのプロトコルバインディング。有効な値は HTTP_JSON、GRPC、JSONRPC です。

Service リソースが作成されると、Agent Registry はコンシューマー側に読み取り専用の Endpoint リソースを自動的に生成します。エージェントとオーケストレータは、このリソースを検出して使用できます。

Terraform

外部エンドポイントを登録するには、endpoint_spec ブロックを使用して google_agent_registry_service リソースを構成します。

resource "google_agent_registry_service" "endpoint" {
  location     = "REGION"
  service_id   = "ENDPOINT_NAME"
  display_name = "DISPLAY_NAME"
  description  = "An external REST API registered using Terraform."

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

  endpoint_spec {
    type = "NO_SPEC"
  }
}

output "endpoint_resource_name" {
  description = "The generated read-only Endpoint resource name."
  value       = google_agent_registry_service.endpoint.registry_resource
}