批次成員與權限管理

功能簡介

MaiAgent 提供強大的批次管理功能，適合需要大量新增或管理成員的情境。透過 Excel 檔案匯入，可一次完成多位成員的新增與角色分配，大幅提升管理效率。

---

批次功能入口

在成員管理頁面，點擊右上角的「批次功能」按鈕：

[[IMG→批次功能下拉選單截圖]]

---

批次新增成員至組織

此功能可透過 Excel 檔案一次新增多位成員到組織。

[[IMG→批次新增成員視窗截圖]]

操作步驟：

1. 下載範本：點擊「下載範本」取得 Excel 範本檔案

2. 編輯範本：在範本中填入成員的 Email（必填欄位）

3. 上傳檔案：將編輯好的檔案拖放或點擊上傳

4. 執行匯入：點擊「上傳並執行」完成批次新增

Excel 檔案格式

欄位名稱	必填	說明
Name	選填	成員顯示名稱，若未填則自動使用 Email 前綴
Email(required)	✅ 必填	成員的電子郵件地址

範例檔案內容

Name	Email(required)
王小明	[email protected]
李小華	[email protected]
張大偉	[email protected]
	[email protected]

案例說明

某企業需要將 50 位新進員工加入 MaiAgent 組織：

1. IT 管理員從人資系統匯出員工名單（含姓名、Email）

2. 將資料整理成上述格式的 Excel 檔案

3. 上傳執行後，系統會：

   • 為已有 MaiAgent 帳號的員工：直接加入組織

   • 為尚無帳號的員工：自動建立帳號並加入組織

4. 所有新成員自動獲得「預設角色」權限

檔案格式說明

• 僅支援 .xlsx 格式

• 檔案大小限制 10 MB

• Email 為必填欄位

• 已存在組織的成員將被忽略（不會重複加入）

---

批次新增角色成員

此功能可批次為多位成員指派角色，實現自動分配權限。

操作步驟：

1. 下載範本：點擊「下載上傳範本」取得 Excel 範本

2. 下載參考資料（選用）：點擊「下載目前成員角色分配」查看現有配置

3. 編輯範本：

   • 填入成員 Email

   • 填入要分配的角色 ID

4. 上傳檔案：將編輯好的檔案拖放或點擊上傳

5. 執行匯入：點擊「上傳並執行」完成批次角色分配

Excel 檔案格式

欄位名稱	必填	說明
Name	選填	成員顯示名稱，若未填則自動使用 Email 前綴
Email(required)	✅ 必填	成員的電子郵件地址
Group_id(required)	✅ 必填	要分配的角色 ID（UUID 格式）
Group_name	選填	角色名稱（僅供參考，系統以 Group_id 為準）

如何取得角色 ID？

點擊「下載目前成員角色分配」可匯出包含所有角色 ID 的參考檔案，或至 角色權限管理 頁面查看各角色的 ID。

範例檔案內容

Name	Email(required)	Group_id(required)	Group_name
王小明	[email protected]	4e368ab4-c543-48a2-bbb8-f6f5a0bf6c61	產品部門
王小明	[email protected]	7a2b3c4d-e5f6-7890-abcd-ef1234567890	AI 助理管理員
李小華	[email protected]	4e368ab4-c543-48a2-bbb8-f6f5a0bf6c61	產品部門
張大偉	[email protected]	8b9c0d1e-f2a3-4567-89ab-cdef01234567	研發部門
新員工	[email protected]	4e368ab4-c543-48a2-bbb8-f6f5a0bf6c61	產品部門

案例說明：部門權限批次設定

某企業完成 Azure AD 串接後，需要為 100 位員工依部門分配不同的資源存取權限（關於 Azure AD 設定，請參閱[[LINK→第三方登入（SSO）]]）：

步驟 1：準備角色

• 在 MaiAgent 建立部門角色：「產品部門」「研發部門」「業務部門」

• 為各角色設定對應的功能權限（詳見[[LINK→角色權限管理]]）

• 為各角色分配可存取的 AI 助理、知識庫、對話平台

步驟 2：準備 Excel

• 從人資系統匯出員工名單（含部門資訊）

• 對照部門名稱填入對應的角色 ID

• 同一位員工可出現多列（例如王小明同時屬於產品部門和 AI 助理管理員）

步驟 3：執行匯入

• 上傳 Excel 後，系統會：

  • 已在組織的成員：直接分配角色

  • 尚未加入組織的 Email：自動邀請加入並分配角色

  • 成員立即獲得角色對應的權限

成果

• 100 位員工在 5 分鐘內完成權限設定

• 各部門員工僅能存取與其業務相關的 AI 助理、知識庫、對話平台

檔案格式說明

• 僅支援 .xlsx 格式

• 檔案大小限制 10 MB

• Email 和角色 ID 為必填欄位

• 同一 Email 可出現在多列（一人可擁有多個角色）

• 不存在組織的 Email 將自動建立帳號並邀請至組織

• 預設角色（DEFAULT）不可透過 Excel 批次分配

• 擁有者角色（OWNER）不可透過 Excel 批次分配

---

批次管理流程圖

sequenceDiagram
    participant Admin as 管理員
    participant MaiAgent as MaiAgent 平台
    participant System as 系統處理
    
    Admin->>MaiAgent: 1. 下載 Excel 範本
    Admin->>Admin: 2. 編輯範本（填入 Email、角色 ID）
    Admin->>MaiAgent: 3. 上傳 Excel 檔案
    MaiAgent->>System: 4. 解析檔案內容
    System->>System: 5. 驗證資料格式
    
    alt 成員已存在於組織
        System->>System: 6a. 更新角色分配
    else 成員不存在於組織
        System->>System: 6b. 自動邀請加入組織
        System->>System: 6c. 分配自訂角色
    end
    
    System->>MaiAgent: 7. 回傳處理結果
    MaiAgent->>Admin: 8. 顯示成功/失敗訊息

---

延伸閱讀

• 角色與權限的詳細設定，請參閱[[LINK→角色權限管理]]

• EIP 登入的自動角色同步機制，請參閱[[LINK→第三方登入（SSO）]]