# 成員管理

## 什麼是成員？

**成員**(Member)是組織內的使用者，透過被分配到不同的角色來獲得相應的權限和資源。

{% hint style="info" %}
**簡單理解：**

成員就像是「公司的員工」，每位員工可以加入不同的部門（角色），並根據所屬部門獲得對應的工作權限。
{% endhint %}

***

## 成員類型說明

<table><thead><tr><th>成員類型</th><th width="215">說明</th><th>權限範圍</th></tr></thead><tbody><tr><td>擁有者</td><td>預設為組織的創建者</td><td>擁有所有資源的完整存取權限<br>可以管理組織設定與角色權限</td></tr><tr><td>一般成員</td><td>角色內的成員</td><td>擁有所屬角色的權限與資源，如問答、對話權限等</td></tr></tbody></table>

{% hint style="info" %}
**簡單理解：**

* **擁有者** = 公司的總經理或系統管理員，可以管理所有事情
* **一般成員** = 公司的員工，根據所屬部門（角色）擁有不同權限
  {% endhint %}

{% hint style="info" %}
角色權限的詳細設定請參閱 [角色權限管理](https://docs.maiagent.ai/org/role-permission)。
{% endhint %}

***

## 基礎操作

### 進入成員管理介面

1. 登入 MaiAgent 平台
2. 從左側選單點擊 「<mark style="color:blue;">組織設定</mark>」
3. 點擊 「<mark style="color:blue;">組織概覽</mark>」
4. 點擊 「<mark style="color:blue;">編輯成員</mark>」按鈕進入成員管理頁面

### 如何選擇加入成員的方式？

MaiAgent 提供三種方式將成員加入組織，請根據您的情境選擇最適合的方式：

{% hint style="info" %}
**快速判斷**

* 對方**已有** MaiAgent 帳號 → 使用「**新增成員**」
* 對方**沒有** MaiAgent 帳號，你有名單 → 使用「**Email 邀請**」
* 對方**沒有** MaiAgent 帳號，想讓大家自助註冊 → 使用「**組織邀請連結**」
  {% endhint %}

{% hint style="success" %}
**情境範例：企業批次開通 30 位員工帳號**

**情況 A：員工都沒有 MaiAgent 帳號，你有名單** → 使用「Email 邀請」的批量導入功能，一次輸入 30 個 Email

**情況 B：員工都沒有 MaiAgent 帳號，想讓大家自助註冊** → 使用「組織邀請連結」，將連結透過公告或群組分享給員工

**情況 C：部分員工已有 MaiAgent 帳號** → 已有帳號：使用「新增成員」直接加入 → 沒有帳號：使用「Email 邀請」或「組織邀請連結」
{% endhint %}

***

### 新增成員（已有 MaiAgent 帳號）

當您要加入的成員**已經擁有 MaiAgent 帳號**時，可以直接透過 Email 將其加入組織。

**操作步驟：**

1. 在成員管理頁面，點擊「<mark style="color:blue;">編輯成員</mark>」
2. 點擊「<mark style="color:blue;">新增成員</mark>」
3. 輸入該使用者的 Email
4. 確認後，該成員即加入組織

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-9e19805e3dd65de9bfba2de6631c077d8dfd7a5f%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.32.15.png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-47a5de5d14030136251bae2b50dc0a2623d25aaf%2F%E6%96%B0%E5%A2%9E%E7%B5%84%E7%B9%94%E6%88%90%E5%93%A1%20(1).png?alt=media" alt=""><figcaption><p>編輯成員頁面</p></figcaption></figure></div>

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-78deea8dcf8a173ea6b79c703794b4f7b865aafa%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.33.16.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
使用此功能時，對方必須已擁有 MaiAgent 帳號。若對方尚未註冊，請改用「Email 邀請」或「組織邀請連結」。
{% endhint %}

***

### Email 邀請（沒有帳號，有名單）

當您要邀請的成員**尚未擁有 MaiAgent 帳號**，且您已有對方的 Email 名單時，可透過 Email 邀請功能發送邀請信。

**步驟 1：進入邀請功能**

1. 從左側選單點擊「<mark style="color:blue;">組織設定</mark>」>「<mark style="color:blue;">組織概覽</mark>」
2. 點擊「<mark style="color:blue;">邀請狀態</mark>」頁籤
3. 點擊右上角「<mark style="color:blue;">邀請新成員</mark>」按鈕

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-1b2afc2271ee2b61312a979bfe06abf6292fec9e%2Finvitation-email-step1.png?alt=media" alt=""><figcaption></figcaption></figure>

**步驟 2：設定邀請內容**

1. 選擇「<mark style="color:blue;">透過 Email 邀請</mark>」頁籤
2. 選擇角色（可多選）：設定受邀者加入組織後的預設角色
3. 設定邀請有效期：可選擇 1 天、3 天、7 天、14 天、30 天、90 天或自訂日期

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-6fb0392320dbcfc35d474e7af316c1dde8a0da39%2Finvitation-email-step2.png?alt=media" alt=""><figcaption></figcaption></figure>

**步驟 3：輸入受邀者 Email**

在 Email 地址欄位輸入受邀者的電子郵件，點擊「<mark style="color:blue;">新增</mark>」將其加入邀請清單。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-b591785ccda985c6cd125e1836c030d09216c44e%2Finvitation-email-step3.png?alt=media" alt=""><figcaption></figcaption></figure>

新增後，Email 會顯示在「已添加」清單中。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-f35ffe90f895073f0ad1e23e4c88cb7aa153d40f%2Finvitation-email-step4.png?alt=media" alt=""><figcaption></figcaption></figure>

**步驟 4：批量輸入多個 Email（選用）**

若需要一次邀請多位成員，點擊「<mark style="color:blue;">批量導入</mark>」切換至批量輸入模式，可直接貼上多個 Email（以逗號、分號或換行分隔）。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-3ef32100f74f9b47a4dc20ffa5263edb18096df6%2Finvitation-email-step5.png?alt=media" alt=""><figcaption></figcaption></figure>

**步驟 5：發送邀請**

確認邀請清單無誤後，點擊「<mark style="color:blue;">發送邀請</mark>」。系統將發送邀請信至所有受邀者的信箱。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-04c4ce9fc34718da4c6db26df836d4dcdb438c1c%2Finvitation-email-step6.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**受邀者流程**

受邀者會收到一封邀請信，點擊信中的連結後即可進入註冊頁面，完成註冊後將自動加入您的組織並獲得指定的角色權限。
{% endhint %}

#### 受邀者註冊教學

以下為受邀者收到邀請信後的完整註冊流程，您可以將此段落提供給受邀者參考。

**步驟 1：開啟邀請信**

請至電子信箱中，找到由 **<no-reply@maiagent.ai>** 寄出、主旨為「**邀請您加入 MaiAgent**」的邀請信。信件中會顯示邀請您的組織管理員姓名與聯絡信箱。確認資訊無誤後，點擊信中的「<mark style="color:blue;">立即註冊</mark>」按鈕。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-52eb5ab366e81cee092157245f90175357ce3452%2Finvitation-register-step1.png?alt=media" alt=""><figcaption><p>邀請信範例</p></figcaption></figure>

**步驟 2：填寫註冊資料**

點擊「立即註冊」後，瀏覽器會跳轉至 MaiAgent 的註冊頁面。請依照欄位填寫以下資訊：

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-5733edf7095467d821bf7913eb22220248c250f5%2Finvitation-register-step2.png?alt=media" alt=""><figcaption><p>註冊頁面</p></figcaption></figure>

* **真實姓名**：填寫您的全名
* **公司名稱**：填寫您的公司全名
* **公司信箱**：填寫您的公司電子信箱（與收到邀請信的信箱一致）
* **密碼**：設定登入密碼（建議至少 8 個字元，包含英文大小寫＋數字＋特殊符號）
* **確認密碼**：再次輸入相同密碼以確認
* 勾選「我已經閱讀且同意隱私政策和服務條款」

填寫完成後，點擊頁面下方的「<mark style="color:blue;">註冊</mark>」按鈕送出。

**步驟 3：登入並加入組織**

註冊成功後，系統會自動跳轉至登入頁面。使用剛才註冊時填寫的 **公司信箱** 與 **密碼** 進行登入，即可成功加入組織並開始使用 MaiAgent。

***

### 組織邀請連結（沒有帳號，自助註冊）

當您要邀請的成員**尚未擁有 MaiAgent 帳號**，且希望讓大家自行註冊時，可生成一個邀請連結分享給受邀者。

**步驟 1：生成邀請連結**

1. 點擊「<mark style="color:blue;">邀請新成員</mark>」按鈕
2. 選擇「<mark style="color:blue;">生成邀請連結</mark>」頁籤
3. 選擇角色（可多選）：設定透過此連結註冊者的預設角色
4. 設定邀請有效期
5. （選填）輸入連結描述，方便後續辨識管理
6. 點擊「<mark style="color:blue;">生成邀請連結</mark>」

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-efc0cd4f67c5596ddec3226d7f0a889707906393%2Finvitation-link-step1.png?alt=media" alt=""><figcaption></figcaption></figure>

**步驟 2：複製並分享連結**

連結生成後，點擊「<mark style="color:blue;">複製連結</mark>」即可將邀請連結複製到剪貼簿，透過 Email、通訊軟體或內部公告分享給受邀者。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-fa5ee2189a5768d85a2584be0627e35bbad6e62a%2Finvitation-link-step2.png?alt=media" alt=""><figcaption></figcaption></figure>

**步驟 3：受邀者完成註冊**

受邀者點擊連結後會進入 MaiAgent 註冊頁面，填寫基本資料並完成註冊後，即自動加入您的組織。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-134ca4280b7bf2616f4dd7c48a49b11702bab8de%2Finvitation-link-step3.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**注意事項**

* 邀請連結有使用期限，過期後將無法使用
* 同一連結可供多人使用註冊
* 您可以在「邀請連結」頁籤中管理已建立的連結（啟用/停用）
  {% endhint %}

***

### 刪除成員

透過 「<mark style="color:blue;">刪除</mark>」 按鈕可將成員從組織中移除。

### 為成員分配角色

成員加入組織後，您可以賦予每位成員不同的角色，根據角色給予其對應的權限。詳細設定請參閱 [角色權限管理](https://docs.maiagent.ai/org/role-permission)。

***

## 進階操作：批次成員與權限管理

{% hint style="info" %}
**什麼時候需要批次操作？**

當您需要一次新增大量成員（例如：50 位新員工）或為多位員工分配角色時，使用批次功能可以節省大量時間。
{% endhint %}

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

### 批次功能入口

在成員管理頁面，點擊右上角的 「<mark style="color:blue;">批次功能</mark>」按鈕：

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2F9MIZzBIZyzgWNOU8nir2%2Fimage.png?alt=media&#x26;token=d347be3c-8c74-4e2f-9f19-c71377c0d3a9" alt=""><figcaption></figcaption></figure>

***

### 批次新增成員至組織

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

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2FCFxXhXAdFxOXH3UF6e7u%2F%E6%88%AA%E5%9C%96%202025-12-10%20%E4%B8%8B%E5%8D%883.24.55.png?alt=media&#x26;token=0fc03620-c58b-4211-91c5-b262e8a781d0" alt=""><figcaption></figcaption></figure>

**操作步驟：**

1. **下載範本**：點擊「下載範本」取得 Excel 範本檔案
2. **編輯範本**：在範本中填入成員的 Email（必填欄位）
3. **上傳檔案**：將編輯好的檔案拖放或點擊上傳
4. **執行匯入**：點擊「上傳並執行」完成批次新增

#### Excel 檔案格式

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

#### 範例檔案內容

| Name | Email(required)           |
| ---- | ------------------------- |
| 王小明  | <ming.wang@company.com>   |
| 李小華  | <hua.li@company.com>      |
| 張大偉  | <david.zhang@company.com> |
|      | <john@company.com>        |

{% hint style="info" %}
**案例說明**

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

1. IT 管理員從人資系統匯出員工名單（含姓名、Email）
2. 將資料整理成上述格式的 Excel 檔案
3. 上傳執行後，系統會：
   * 為已有 MaiAgent 帳號的員工：直接加入組織
   * 為尚無帳號的員工：自動建立帳號並加入組織
4. 所有新成員自動獲得「預設角色」權限
   {% endhint %}

{% hint style="warning" %}
**檔案格式說明**

* 僅支援 .xlsx 格式
* 檔案大小限制 10 MB
* Email 為必填欄位
* 已存在組織的成員將被忽略（不會重複加入）
  {% endhint %}

***

### 批次新增角色成員

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

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2FHnsaMipM9H8V9C3YlLGc%2F%E6%88%AA%E5%9C%96%202025-12-10%20%E4%B8%8B%E5%8D%883.25.37.png?alt=media&#x26;token=3e5c23f3-5b50-4a53-93c1-5f0d0f885187" alt=""><figcaption></figcaption></figure>

**操作步驟：**

1. **下載範本**：點擊「下載上傳範本」取得 Excel 範本
2. **下載參考資料**（選用）：點擊「下載目前成員角色分配」查看現有配置
3. **編輯範本**：
   * 填入成員 Email
   * 填入要分配的角色 ID
4. **上傳檔案**：將編輯好的檔案拖放或點擊上傳
5. **執行匯入**：點擊「上傳並執行」完成批次角色分配

#### Excel 檔案格式

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

{% hint style="info" %}
**如何取得角色 ID？**

點擊「下載目前成員角色分配」可匯出包含所有角色 ID 的參考檔案，或至 [角色權限管理](https://docs.maiagent.ai/org/role-permission) 頁面查看各角色的 ID。
{% endhint %}

#### 範例檔案內容

| Name | Email(required)            | Group\_id(required)                  | Group\_name |
| ---- | -------------------------- | ------------------------------------ | ----------- |
| 王小明  | <ming.wang@company.com>    | 4e368ab4-c543-48a2-bbb8-f6f5a0bf6c61 | 產品部門        |
| 王小明  | <ming.wang@company.com>    | 7a2b3c4d-e5f6-7890-abcd-ef1234567890 | AI 助理管理員    |
| 李小華  | <hua.li@company.com>       | 4e368ab4-c543-48a2-bbb8-f6f5a0bf6c61 | 產品部門        |
| 張大偉  | <david.zhang@company.com>  | 8b9c0d1e-f2a3-4567-89ab-cdef01234567 | 研發部門        |
| 新員工  | <new.employee@company.com> | 4e368ab4-c543-48a2-bbb8-f6f5a0bf6c61 | 產品部門        |

{% hint style="success" %}
**案例說明：部門權限批次設定**

某企業完成 Azure AD 串接後，需要為 100 位員工依部門分配不同的資源存取權限（關於 Azure AD 設定，請參閱 [第三方登入（SSO）](https://docs.maiagent.ai/org/sso)）：

**步驟 1：準備角色**

* 在 MaiAgent 建立部門角色：「產品部門」「研發部門」「業務部門」
* 為各角色設定對應的功能權限（詳見 [角色權限管理](https://docs.maiagent.ai/org/role-permission)）
* 為各角色分配可存取的 AI 助理、知識庫、對話平台

**步驟 2：準備 Excel**

* 從人資系統匯出員工名單（含部門資訊）
* 對照部門名稱填入對應的角色 ID
* 同一位員工可出現多列（例如王小明同時屬於產品部門和 AI 助理管理員）

**步驟 3：執行匯入**

* 上傳 Excel 後，系統會：
  * 已在組織的成員：直接分配角色
  * 尚未加入組織的 Email：自動邀請加入並分配角色
  * 成員立即獲得角色對應的權限

**成果**

* 100 位員工在 5 分鐘內完成權限設定
* 各部門員工僅能存取與其業務相關的 AI 助理、知識庫、對話平台
  {% endhint %}

{% hint style="warning" %}
**檔案格式說明**

* 僅支援 .xlsx 格式
* 檔案大小限制 10 MB
* Email 和角色 ID 為必填欄位
* 同一 Email 可出現在多列（一人可擁有多個角色）
* 不存在組織的 Email 將自動建立帳號並邀請至組織
* **預設角色（DEFAULT）不可透過 Excel 批次分配**
* **擁有者角色（OWNER）不可透過 Excel 批次分配**
  {% endhint %}

***

## 延伸閱讀

* 角色與權限的詳細設定，請參閱 [角色權限管理](https://docs.maiagent.ai/org/role-permission)
* EIP 登入的自動角色同步機制，請參閱 [第三方登入（SSO）](https://docs.maiagent.ai/org/sso)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.maiagent.ai/org/member.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.