管理繫結

在代理登錄中，繫結可讓 orchestrator 代理連線至下游代理、MCP 伺服器和端點，不必在程式碼中硬式編碼連線或驗證詳細資料。您可以在代理程式登錄資料庫中建立、查看、更新及刪除繫結，管理資源連線和委派權限。

事前準備

  1. 設定 Agent Registry。

  2. 如果是單一專案設定，請取得已啟用 Agent Registry 的管理專案ID。如果您為多個專案設定了管理邊界，請使用管理專案的 ID 進行邊界範圍的探索和註冊，或指定成員專案 ID 進行單一專案作業。

  3. 註冊來源和目標元件。詳情請參閱「註冊模式」。

  4. 如要設定委派權限的繫結，請使用 Agent Identity 驗證管理工具建立驗證提供者。詳情請參閱「向工具和資源進行驗證」。

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

必要的角色

如要取得管理 Agent Registry 繫結所需的權限，請要求管理員在已啟用 Agent Registry 的治理專案中，授予您下列 IAM 角色：

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

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

繫結情境

您可以使用繫結連結資源及委派權限。舉例來說，您可以在下列情況使用繫結：

  • 資源連線：將來源代理連結至目標資源，例如其他代理、MCP 伺服器或端點。這個情境可讓您規劃多代理工作流程，由主要協調器將工作委派給專門的子代理或工具。
  • 委派權限：將代理與驗證供應商建立關聯，讓代理使用自己的憑證或代表個別使用者，連結至外部目標或自訂工具。如果代理需要使用 OAuth 權杖或 API 金鑰，向遠端 MCP 伺服器或工具進行驗證，就必須進行這項繫結。有了繫結，您就不必在程式碼中手動定義驗證供應商。如需詳細操作說明，請參閱本文的「建立驗證提供者繫結」一節。

建立繫結

建立繫結，將來源代理連結至目標資源：

gcloud

請執行 gcloud agent-registry bindings create 指令。

gcloud agent-registry bindings create BINDING_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --display-name="DISPLAY_NAME" \
    --source-identifier="SOURCE_ID" \
    --target-identifier="TARGET_ID"

更改下列內容：

  • BINDING_NAME：要為繫結指定的名稱，例如 my-custom-binding。
  • PROJECT_ID：專案 ID。
  • REGION：登錄檔區域。
  • DISPLAY_NAME：要為繫結指定的人類可讀名稱，例如 My Custom Binding。
  • SOURCE_ID：來源代理的代理 ID，格式為統一資源名稱 (URN)。
  • TARGET_ID：目標資源的登錄檔 ID，格式為 URN，例如代理 ID、MCP 伺服器 ID 或端點 ID。

Terraform

如要建立來源代理和目標資源之間的繫結，請設定 google_agent_registry_binding 資源。繫結需要 target 區塊：

resource "google_agent_registry_binding" "agent_binding" {
  location     = "REGION"
  binding_id   = "BINDING_NAME"
  display_name = "DISPLAY_NAME"
  description  = "Connects a source agent to a target resource."

  source {
    identifier = "SOURCE_ID"
  }

  target {
    identifier = "TARGET_ID"
  }
}

更改下列內容：

  • REGION：登錄檔區域。
  • BINDING_NAME：要為繫結指定的專屬名稱。
  • DISPLAY_NAME：繫結的人類可讀名稱。
  • SOURCE_ID：來源代理的代理 ID，格式為 URN。
  • TARGET_ID：目標資源的登錄檔 ID，格式為 URN。

建立驗證提供者繫結

您可以將代理與驗證供應商建立關聯，以便委派權限。建立這項繫結前，您必須先使用驗證管理工具建立驗證提供者。詳情請參閱「向工具和資源進行驗證」。

指定 --auth-provider-binding 資源名稱時，必須使用專案 ID：

gcloud

執行 gcloud agent-registry bindings create 指令並加上 --auth-provider-binding 旗標：

gcloud agent-registry bindings create BINDING_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --display-name="DISPLAY_NAME" \
    --source-identifier="SOURCE_ID" \
    --target-identifier="TARGET_ID" \
    --auth-provider-binding="projects/PROJECT_ID/locations/REGION/authProviders/AUTH_PROVIDER_ID"

更改下列內容：

  • BINDING_NAME：要為繫結指定的專屬名稱。
  • PROJECT_ID：專案 ID。
  • REGION：登錄檔區域。
  • DISPLAY_NAME：繫結的人類可讀名稱。
  • SOURCE_ID：來源代理的代理 ID，格式為 URN。
  • TARGET_ID：目標資源的登錄檔 ID，格式為 URN。
  • AUTH_PROVIDER_ID：驗證供應商的 ID。

Terraform

如要在 Terraform 中設定驗證提供者繫結，請指定 auth_provider_binding 區塊，並提供驗證提供者的資源名稱、範圍和接續 URI：

resource "google_agent_registry_binding" "auth_binding" {
  location     = "REGION"
  binding_id   = "BINDING_NAME"
  display_name = "DISPLAY_NAME"

  source {
    identifier = "SOURCE_ID"
  }

  target {
    identifier = "TARGET_ID"
  }

  auth_provider_binding {
    auth_provider = "projects/PROJECT_ID/locations/REGION/authProviders/AUTH_PROVIDER_ID"
    scopes        = [SCOPES]
    continue_uri  = "CONTINUE_URI"
  }
}

更改下列內容：

  • REGION：登錄檔區域。
  • BINDING_NAME：要為繫結指定的專屬名稱。
  • DISPLAY_NAME：繫結的人類可讀名稱。
  • SOURCE_ID：來源代理的代理 ID，格式為 URN。
  • TARGET_ID：目標資源的登錄檔 ID，格式為 URN。
  • PROJECT_ID：專案 ID。
  • AUTH_PROVIDER_ID：驗證提供者的 ID。
  • SCOPES：以半形逗號分隔的 OAuth 2.0 範圍清單，例如 "https://www.googleapis.com/auth/cloud-platform"。
  • CONTINUE_URI：驗證提供者的繼續 URI，例如 https://example.com/continue。

如要瞭解如何在代理程式碼中使用這些繫結，請參閱「在 Agent Development Kit (ADK) 程式碼中解析繫結」。

列出繫結

執行 gcloud agent-registry bindings list 指令，列出特定位置的所有繫結：

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

更改下列內容：

  • PROJECT_ID：專案 ID。
  • REGION：登錄檔區域。

查看繫結詳細資料

執行 gcloud agent-registry bindings describe 指令，擷取單一繫結的詳細資料：

gcloud agent-registry bindings describe BINDING_NAME \
    --project=PROJECT_ID \
    --location=REGION

更改下列內容：

  • BINDING_NAME：繫結名稱。
  • PROJECT_ID：專案 ID。
  • REGION：登錄檔區域。

更新繫結

更新現有繫結的參數，例如顯示名稱或說明：

gcloud

請執行 gcloud agent-registry bindings update 指令。

gcloud agent-registry bindings update BINDING_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --display-name="NEW_DISPLAY_NAME"

更改下列內容：

  • BINDING_NAME：要更新的繫結名稱。
  • PROJECT_ID：專案 ID。
  • REGION：登錄檔區域。
  • NEW_DISPLAY_NAME：繫結的新人類可讀名稱。

Terraform

如要使用 Terraform 更新繫結的顯示名稱或說明，請修改設定中現有的 google_agent_registry_binding 資源，然後執行 terraform apply。

刪除繫結

如要移除資源之間的連結，請刪除繫結：

gcloud

請執行 gcloud agent-registry bindings delete 指令。

gcloud agent-registry bindings delete BINDING_NAME \
    --project=PROJECT_ID \
    --location=REGION

更改下列內容：

  • BINDING_NAME：要刪除的繫結名稱。
  • PROJECT_ID：專案 ID。
  • REGION：登錄檔區域。

Terraform

從 Terraform 設定中移除代表繫結的 google_agent_registry_binding 資源，然後執行 terraform apply。

後續步驟