註冊端點

在 Agent Registry 中，端點代表目標網址 (通常是 REST API)，代理程式會存取該網址。將這些目的地註冊為受管理資源，即可集中控管代理程式群組可連線的外部服務。

本文說明如何在登錄檔中明確註冊外部端點。

事前準備

開始之前，請先設定代理程式登錄。您需要專案 ID 才能執行這些工作。

如要使用本文中的 gcloud CLI 指令，請務必設定 Google Cloud CLI 環境。

必要的角色

如要取得在 Agent Registry 中註冊端點所需的權限，請要求管理員授予您專案的「Agent Registry API 編輯者」 (roles/agentregistry.editor) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

註冊端點

由於端點是自訂的外部目的地，請使用手動註冊，將端點新增至代理程式登錄：

控制台

  1. 前往 Google Cloud 控制台的「Agent Registry」：

    前往 Agent Registry

  2. 在專案選擇工具中，選取 Google Cloud 您設定 Agent Registry 的專案。

  3. 選取「端點」分頁標籤。

  4. 按一下「新增端點」。

  5. 在「端點詳細資料」面板中，輸入顯示名稱、說明、地理區域和到達網頁網址。您可以在這個面板中測試與到達網頁網址的連線。

  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：目標網址，例如 https://api.example.com/v1/data。
  • PROTOCOL：介面的通訊協定繫結。有效值為 HTTP_JSON、GRPC 或 JSONRPC。

建立 Service 資源後，Agent Registry 會在消費者端自動產生唯讀的 Endpoint 資源，供代理程式和協調器探索及使用。