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

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

事前準備

如要共用服務專員，必須符合下列條件：

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

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

共用代理

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

控制台

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

前往 Gemini Enterprise

  1. 選取專案。

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

  3. 點選導覽選單中的「代理」。

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

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

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

  7. 設定權限詳細資料：

    1. 在「成員類型」部分選取下列任一選項：

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

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

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

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

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

    2. 輸入專屬成員 ID，然後選取角色：

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

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

  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 控制台的「代理程式」頁面中，代理程式的「共用」欄必須顯示「已啟用」。無法轉移私人 (未共用) 代理程式。
  • 單一擁有者：每個代理程式都只有一位擁有者。轉移擁有權後，所選收件者就會成為代理程式的唯一擁有者。
  • 先前擁有者的存取權：轉移擁有權後，先前擁有者在服務專員中的角色會降級為 agentUser。他們仍可查詢及執行代理程式，但無法再編輯代理程式的設定或設定。
  • 支援的代理程式類型：支援轉移員工建立的代理程式擁有權 (在網頁應用程式中建立的低程式碼和工作流程代理程式)。
  • 有時間表或觸發條件的代理：如果轉移的代理有時間表觸發條件或事件觸發條件，轉移作業會將這些時間表或事件標示為已停用。新擁有者必須啟用排程或事件觸發條件，才能使用代理程式。

轉移代理程式擁有權

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

控制台

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

    前往 Gemini Enterprise

  2. 選取專案。

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

  4. 點選導覽選單中的「代理」。

  5. 按一下共用代理的「顯示名稱」。

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

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

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

    • 自己：將代理商擁有權轉移至目前的管理員帳戶。如果你已擁有代理程式，這個選項就會停用。
    • 其他使用者：將擁有權轉移給機構中的其他使用者。

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

    • Google Identity 和 Cloud Identity：在「新擁有者電子郵件地址」欄位中輸入使用者的電子郵件地址 (例如 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 角色。