# 組織與成員管理

## 什麼是組織與成員管理？

MaiAgent 的組織與成員管理功能，就像是為您的企業打造一個「數位辦公室」。透過這個功能，您可以建立公司架構、分配員工職位、設定誰能做什麼事，讓團隊協作更有條理。

本系統基於 **RBAC**(Role-Based Access Control,角色權限控制)設計，提供完整的組織管理解決方案,讓企業能夠有效地組織團隊、分配權限並監控資源使用。

{% hint style="info" %}
**什麼是 RBAC？**

RBAC 是一種「先設定職位，再把人員加入職位」的管理方式。例如：您先定義「客服專員」這個角色可以做哪些事，然後把張先生、李小姐加入這個角色，他們就自動擁有客服專員的所有權限，不需要逐一為每個人設定。
{% endhint %}

***

## 系統架構

### 三層式結構

MaiAgent 採用清楚的三層式架構：**組織 → 角色 → 成員**

```
組織 (Organization)
└─ 您的公司
   │
   ├─ 角色 (Role)
   │  └─ 職位/部門 (例如：客服部、行銷部)
   │     │
   │     └─ 成員 (Member)
   │        └─ 員工 (例如：張先生、李小姐)
```

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

* **組織** = 您的公司
* **角色** = 公司內的部門或職位（例如：客服部、行銷部）
* **成員** = 公司的員工（例如：張先生、李小姐）
  {% endhint %}

### 運作方式

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-5503ceba3aecfd5845b8e547dd7bd206c16f2c85%2Fimage%20(80).png?alt=media" alt=""><figcaption></figcaption></figure>

**設定步驟：**

1. **建立組織**：在系統中建立您的公司
2. **建立角色**：在組織內建立部門或職位（例如：客服部、行銷部）
3. **設定權限**：為每個角色設定可以做什麼（決定功能權限）
4. **分配成員**：將員工加入對應的角色
5. **自動生效**：成員自動獲得該角色的所有權限

***

## 核心概念說明

### 組織 (Organization)

**組織**是最上層的管理單位，代表您的公司或團隊。每個組織擁有獨立的成員、角色、權限和資源。

{% hint style="info" %}
\*\*簡單理解：\*\*組織就像是「公司」，每個公司有自己的員工（成員）、部門（角色）和資料（AI 助理、知識庫等）。
{% endhint %}

### 角色 (Role)

**角色**是組織內的功能單位，定義了一組權限和資源。

**三種角色類型：**

* **擁有者角色**：最高權限，可管理所有設定
* **預設角色**：所有成員自動擁有的基礎權限
* **自訂角色**：根據需求建立的部門或職位角色

{% hint style="info" %}
\*\*簡單理解：\*\*角色就像公司的「部門」或「職位」（例如：客服部、行銷部、主管），每個角色有不同的職責和權限。
{% endhint %}

### 成員 (Member)

**成員**是組織內的使用者，透過角色獲得權限。

**成員類型：**

<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 %}

### 權限 (Permission)

**權限**控制成員可以使用哪些功能。

MaiAgent 採用**層級式權限架構**：

{% hint style="info" %}
**什麼是「層級式權限架構」？**

就像資料夾的結構：

* **主權限** = 主資料夾（例如：「AI 功能」）
* **子權限** = 子資料夾（例如：「AI 助理」、「知識庫」、「爬蟲」）

**實際運作：**

* 勾選主權限會自動包含底下所有子權限
* 也可以只勾選部分子權限，實現更精細的控制
  {% endhint %}

### 資源 (Resource)

**資源**是組織內的實體項目，可分配給特定角色使用。

**資源類型：**

* **AI 助理**：指定角色可操作的 AI 助理
* **知識庫**：指定角色可存取的知識庫
* **對話平台**：指定角色可使用的對話平台

***

## 設定流程導引

{% hint style="success" %}
**建議的設定順序**

建議依照以下順序進行設定，可以避免混亂：

1. ✅ **建立組織**：先建立您的公司組織
2. ✅ **建立角色**：在組織內建立需要的部門或職位
3. ✅ **設定權限**：為每個角色設定功能權限
4. ✅ **分配資源**：為每個角色指定可使用的 AI 助理、知識庫
5. ✅ **新增成員**：將員工加入組織
6. ✅ **分配角色**：將成員指派到對應的角色
   {% endhint %}

***

## 相關頁面

接下來，您可以依照您的需求，參考以下詳細說明：

* [組織管理](https://docs.maiagent.ai/org/organization)：如何建立、切換、管理組織
* [角色權限管理](https://docs.maiagent.ai/org/role-permission)：如何建立角色、設定權限、分配資源
* [成員管理](https://docs.maiagent.ai/org/member)：如何新增、刪除成員、分配角色

***

## 設計優勢

{% hint style="info" %}
僅有在您組織下的成員可以查看、管理該組織下所有的 AI 助理相關功能。
{% 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/overview.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.
