# 角色成員篩選

### 功能簡介 <a href="#feature-intro" id="feature-intro"></a>

角色成員篩選功能讓組織管理者能夠依照角色（角色）快速篩選成員列表,大幅提升大型組織的成員管理效率。透過此功能,您可以快速找到特定角色的成員,進行批次操作或權限調整。

{% hint style="info" %}
此功能特別適合擁有多個角色與大量成員的組織,能有效簡化成員管理流程。
{% endhint %}

***

### 使用篩選功能 <a href="#using-filter" id="using-filter"></a>

#### 基本篩選 <a href="#basic-filter" id="basic-filter"></a>

1. **進入成員管理頁面**
   * 點選左側選單「<mark style="color:blue;">組織設定</mark>」
   * 點選「<mark style="color:blue;">組織概覽</mark>」
   * 點選「<mark style="color:blue;">編輯成員</mark>」
2. **選擇篩選條件**
   * 在成員列表上方找到「<mark style="color:blue;">依角色篩選</mark>」下拉選單
   * 選擇要篩選的角色（角色）
   * 成員列表會立即更新,只顯示該角色的成員

<figure><img src="/files/1svp68GcsDArXcqVeRbS" alt="成員列表與角色篩選"><figcaption><p>成員列表頁面，可透過「選擇角色篩選」下拉選單篩選特定角色的成員</p></figcaption></figure>

#### 篩選選項 <a href="#filter-options" id="filter-options"></a>

<table><thead><tr><th width="200">篩選選項</th><th>說明</th></tr></thead><tbody><tr><td><strong>全部成員</strong></td><td>顯示組織內所有成員（預設選項）</td></tr><tr><td><strong>擁有者角色</strong></td><td>只顯示擁有者角色的成員</td></tr><tr><td><strong>預設角色</strong></td><td>顯示僅擁有預設角色的成員（未分配其他角色）</td></tr><tr><td><strong>自訂角色</strong></td><td>依您建立的自訂角色名稱篩選<br>（如:行銷部、客服組、研發團隊等）</td></tr></tbody></table>

***

### 進階操作 <a href="#advanced-operations" id="advanced-operations"></a>

#### 組合篩選與搜尋 <a href="#combine-filter-and-search" id="combine-filter-and-search"></a>

您可以結合角色篩選與關鍵字搜尋,更精確地找到目標成員:

1. 先選擇角色篩選（例:「客服組」）
2. 再使用搜尋框輸入成員姓名或 Email
3. 系統會在已篩選的結果中進一步搜尋

**範例**:

```
篩選條件:客服組
搜尋關鍵字:王
→ 結果:客服組中姓名包含「王」的所有成員
```

***

### 應用情境 <a href="#use-cases" id="use-cases"></a>

#### 情境一:新專案團隊組建 <a href="#use-case-new-project-team" id="use-case-new-project-team"></a>

**需求**:公司啟動新專案,需要從現有成員中挑選合適人選組成專案團隊

**操作流程**:

1. 創建新角色「專案 A 團隊」
2. 依序篩選相關部門:
   * 篩選「研發部」→ 找到 3 位工程師
   * 篩選「設計部」→ 找到 2 位設計師
   * 篩選「行銷部」→ 找到 1 位行銷專員
3. 將選定成員加入「專案 A 團隊」角色
4. 為該角色配置專案所需的 AI 助理與知識庫權限

#### 情境二:定期權限審查 <a href="#use-case-periodic-permission-review" id="use-case-periodic-permission-review"></a>

**需求**:每季檢視各部門成員權限,確保符合最小權限原則

**操作流程**:

1. 逐一篩選各部門角色
2. 檢查每個成員的權限配置:
   * 是否有不必要的權限？
   * 是否缺少必要權限？
3. 記錄需要調整的成員
4. 進行權限調整

#### 情境三:離職員工權限收回 <a href="#use-case-offboarding-revoke" id="use-case-offboarding-revoke"></a>

**需求**:員工離職,需要快速收回所有權限

**操作流程**:

1. 搜尋該員工姓名
2. 查看該員工所屬的所有角色
3. 逐一進入各角色的成員列表
4. 使用篩選快速定位該員工
5. 將該員工從所有角色中移除
6. 確認該員工僅剩預設角色（最低權限）

***

### 篩選效能優化 <a href="#filter-performance-optimization" id="filter-performance-optimization"></a>

#### 大型組織建議 <a href="#large-org-recommendations" id="large-org-recommendations"></a>

如果您的組織擁有 100 位以上成員,建議:

1. **明確的角色命名**
   * 使用清楚的命名規則（如:部門-職能-專案）
   * 範例:「業務部-客戶服務-VIP專案」
2. **合理的角色數量**
   * 避免建立過多細分的角色
   * 建議每個組織的角色數量控制在 20 個以內
3. **定期清理**
   * 刪除不再使用的角色
   * 移除已離職員工
   * 合併功能相似的角色
4. **善用批次功能**
   * 使用 Excel 批次管理（參考:[批次成員與權限管理](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/zh-tw/org/bulk-role-permission.md)）

***

### 常見問題 <a href="#faq" id="faq"></a>

#### Q:一個成員屬於多個角色,在哪個篩選結果中會顯示？ <a href="#faq-member-in-multiple-roles" id="faq-member-in-multiple-roles"></a>

**A**:該成員會在所有其所屬角色的篩選結果中顯示。例如小王同時屬於「行銷部」和「專案 A」,則在篩選這兩個角色時都會看到小王。

#### Q:篩選條件可以儲存嗎？ <a href="#faq-save-filter" id="faq-save-filter"></a>

**A**:目前不支援儲存篩選條件。但瀏覽器會記住您最近一次的篩選選擇,下次開啟頁面時會自動套用。

#### Q:為什麼我看不到某些角色的篩選選項？ <a href="#faq-cannot-see-role-filter" id="faq-cannot-see-role-filter"></a>

**A**:可能原因:

* 您沒有該角色的管理權限
* 該角色已被刪除
* 您不是組織擁有者（部分角色僅擁有者可見）

#### Q:篩選速度很慢怎麼辦？ <a href="#faq-slow-filter" id="faq-slow-filter"></a>

**A**:可能原因與解決方式:

* **成員過多**（>500 人）:建議使用更精確的搜尋條件
* **瀏覽器快取過多**:清除瀏覽器快取後重新嘗試
* **網路延遲**:檢查網路連線狀況

***

### 相關功能 <a href="#related-features" id="related-features"></a>

{% hint style="info" %}
**延伸功能**

* [組織與成員管理](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/zh-tw/org/rbac.md)
* [角色權限管理](/org/role-permission.md)
* [批次成員與權限管理](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/zh-tw/org/bulk-role-permission.md)
* [角色資源存取權限](/org/group-resource-access.md)
  {% endhint %}


---

# 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/group-member-filtering.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.