エンドポイントの登録

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

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

始める前に

始める前に、エージェント レジストリを設定します。これらのタスクを実行するには、プロジェクト ID が必要です。

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

必要なロール

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

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

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

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

コンソール

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

    Agent Registry に移動

  2. プロジェクト選択ツールから、エージェント レジストリを設定した Google Cloud プロジェクトを選択します。

  3. [エンドポイント] タブを選択します。

  4. [エンドポイントを追加] をクリックします。

  5. [エンドポイントの詳細] パネルで、表示名、説明、地理的リージョン、リンク先 URL を入力します。このパネルから、リンク先 URL への接続をテストできます。

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

gcloud

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

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

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

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

  • SERVICE_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 リソースが作成されると、エージェント レジストリは、エージェントとオーケストレーターが検出して使用できる読み取り専用の Endpoint リソースをコンシューマー側に自動的に生成します。