從 Google Cloud 控制台共用代理程式

本頁說明如何與貴組織使用者共用代理，以及管理員如何轉移共用代理的擁有權。管理員可以將可用的代理 (Google 製作、員工製作和自訂) 分享給個別使用者、群組、Workforce Identity 集區群組，或組織中的所有使用者，並將員工製作的共用代理擁有權轉移給自己或其他使用者。如要進一步瞭解 Gemini Enterprise 提供的不同代理類型，請參閱「代理總覽」。

事前準備

您必須符合下列條件，才能分享代理：

  1. 您必須有現成的 Gemini Enterprise 網頁應用程式。如要建立新應用程式，請參閱「建立應用程式」。

  2. 如要分享自訂代理，您必須使用下列任一選項，將自訂代理註冊或新增至 Gemini Enterprise：

共用代理

如要分享代理程式，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

前往 Gemini Enterprise

  1. 選取專案。

  2. 在「Name」(名稱) 欄中，按一下您的應用程式。導覽選單會更新。

  3. 按一下導覽選單中的「代理」。

  4. 按一下要共用代理程式的顯示名稱。

  5. 按一下「使用者權限」分頁標籤，系統會顯示「已授權使用者」頁面。

  6. 按一下「新增使用者」，系統會顯示「為代理新增使用者授權角色」 對話方塊。

  7. 設定權限詳細資料：

    1. 在「Member type」(成員類型) 區段中，選取下列其中一個選項：

      • 使用者：個別使用者。如要讓這類會員類型正常運作，您必須加入正確的 IAM 角色。詳情請參閱「IAM 角色和權限」。

      • 群組：一組使用者。如要讓這類會員類型正常運作，您必須加入正確的 IAM 角色。詳情請參閱「IAM 角色和權限」。

      • 主體：員工身分集區群組中的單一身分，包括非由 Google管理的外部群組。

      • 員工身分集區：員工身分集區中的所有身分。

      • 所有使用者：機構中的所有使用者。

    2. 輸入不重複的成員 ID，然後選取角色：

      成員類型 說明
      使用者 在「成員」欄位中輸入電子郵件地址。
      在「指派角色」欄位中選取角色。
      群組 在「成員」欄位中輸入電子郵件地址。
      在「指派角色」欄位中選取角色。
      主體 WIF 中的單一身分。
      員工身分集區 在「Member」(成員) 欄位中輸入主體 ID。
      在「指派角色」欄位中選取角色。

      如需主體組合範例，請參閱「主體組合」。
      所有使用者 在「Assign role」(指派角色) 欄位中選取角色。

  8. 按一下 [儲存]。

主體集

以下是可為員工身分集區成員類型指定的主體組合範例：

主要設定 說明
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID WIF 中的單一身分。
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID 群組中的所有員工身分。
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE 具有特定屬性值的所有員工身分。
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/* 員工身分集區中的所有身分。

在程式碼範例中，將下列預留位置替換為值：

  • PROJECT_NUMBER：資源路徑中用於識別特定 Google Cloud 專案的編號。
  • GROUP_ID：外部身分識別提供者 (IdP) 的特定群組 ID，可讓您授予該群組所有成員存取權。
  • POOL_ID：您在 Google Cloud中建立的員工身分集區專屬 ID。
  • SUBJECT_ID：員工身分集區中單一身分的專屬主體 ID。
  • ATTRIBUTE_NAME：您從外部身分識別提供者 (IdP) 對應的自訂屬性，使用者定義的名稱。
  • ATTRIBUTE_VALUE：用於限制存取權的 ATTRIBUTE_NAME 具體值。

轉移代理程式擁有權

管理員可以將共用代理程式的擁有權轉移給機構中的其他使用者或自己。這項功能適用於下列情境：

  • 離職員工：將離職員工建立的代理程式轉移給現職員工，確保維護作業不中斷。
  • 承包商交接：將臨時或約聘員工建立的代理交接給全職員工。
  • 團隊重組：隨著角色或專案演變，重新指派代理責任。

注意事項與限制

轉移代理擁有權前，請注意下列事項和限制：

  • 管理員權限：只有具備 Gemini Enterprise 管理員角色 (roles/discoveryengine.agentspaceAdmin) 或 Discovery Engine 管理員角色 (roles/discoveryengine.admin) 的管理員，才能轉移代理擁有權。目前的代理商擁有者必須同時是管理員，才能轉移擁有權。
  • 僅限共用代理程式：您只能轉移已共用代理程式的擁有權。在 Google Cloud 控制台的「Agents」(代理) 頁面中，代理的「Sharing」(共用) 欄必須顯示「Enabled」(已啟用)。無法轉移私人 (未共用) 代理。
  • 單一擁有者：每個代理程式只有一個擁有者。擁有權轉移後，所選接收者會成為代理的唯一擁有者。
  • 原擁有者存取權：擁有權轉移後，原擁有者會降級為代理程式使用者，並具備 agentUser 角色。他們仍有權查詢及執行代理，但無法再編輯代理的設定。
  • 支援的代理類型：員工建立的代理 (在網頁應用程式中建立的低程式碼和工作流程代理) 支援擁有權轉移。
  • 有排程或觸發條件的代理：如果轉移的代理有排程觸發條件或事件觸發條件，轉移作業會將這些觸發條件標示為停用的排程或事件。新擁有者必須啟用排程或事件觸發條件，才能使用代理。

轉移代理擁有權

如要轉移代理程式擁有權，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

    前往 Gemini Enterprise

  2. 選取專案。

  3. 在「Name」(名稱) 欄中，按一下您的應用程式。導覽選單會更新。

  4. 按一下導覽選單中的「代理」。

  5. 按一下共用代理程式的顯示名稱。

  6. 按一下「使用者權限」分頁標籤。系統會顯示「具備權限的使用者」清單。

  7. 按一下「轉移擁有權」。系統會開啟「轉移擁有權」對話方塊。

  8. 在「將擁有權轉移給」下方，選擇下列任一選項：

    • 本人：將代理商擁有權轉移至目前的管理員帳戶。如果您已擁有代理，這個選項會停用。
    • 其他使用者：將擁有權轉移給組織中的其他使用者。

  9. 如果您選取「其他使用者」，請指定新的擁有者：

    • Google Identity 和 Cloud Identity：在「New owner email」(新擁有者電子郵件) 欄位中輸入使用者的電子郵件地址 (例如 user@example.com)。
    • 員工身分聯盟 (WIF) 帳戶：在「New owner principal」(新擁有者主體) 欄位中，輸入單一身分主體 ID：
    //iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID

    或者，您也可以加入 principal: 前置字元：

    principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID

    更改下列內容：

    • POOL_ID：員工身分集區的專屬 ID。
    • SUBJECT_ID：員工身分集區中的使用者主體 ID。

  10. 按一下「轉移擁有權」。

    代理的擁有者已更新。前任擁有者會保留為具備 agentUser 角色的授權使用者。