# 角色和聯絡人的差異

## 對話中顯示 <a href="#in-conversation-display" id="in-conversation-display"></a>

### 聯絡人 <a href="#contact-display" id="contact-display"></a>

在 MaiAgent 同步使用者資訊的儲存體，會建立聯絡人 ID 用以判斷使用者對話資訊。

使用者不需登入或擁有 MaiAgent 帳號就能建立。

{% hint style="info" %}
欲了解聯絡人，請參考 [🌐聯絡人](/org/contact.md)
{% endhint %}

<figure><img src="/files/3Ic2kJECCssBeHgddV6a" alt=""><figcaption><p>未設定聯絡人姓名：用戶預設為匿名</p></figcaption></figure>

### 角色 <a href="#role-display" id="role-display"></a>

欲給予使用者角色，該使用者必須擁有 MaiAgent 帳號並加入組織內，企業內部可事先定義，如：客服人員、行政人員、實習生等。在機構內可事先建立角色可使用的權限及參考的資料庫，組織成員可根據需要選擇角色直接套用設定。

<figure><img src="/files/rJyrGajUeh5XuckifnIq" alt=""><figcaption><p>Role 使用者基本資料顯示</p></figcaption></figure>

{% hint style="info" %}
欲了解聯絡人，請參考 🌐[角色權限管理](/org/role-permission.md)
{% endhint %}

## 權限方式對比 <a href="#permission-comparison" id="permission-comparison"></a>

<figure><img src="/files/0ueDf9mVnM4EgNN3Ac6P" alt=""><figcaption><p>AI 助理嵌入畫面</p></figcaption></figure>

|        比較項目        |         聯絡人        |            角色            |
| :----------------: | :----------------: | :----------------------: |
|     🎯 **適用場景**    |      外部用戶、系統串接     |         內部用戶、組織管理        |
| 👤 **註冊 MaiAgent** |        ❌ 免註冊       |         ✅ 需註冊加入組織        |
|     📋 **建立方式**    |     系統自動建立或手動建立    |         預先定義角色模板         |
|     🔄 **更新機制**    |      動態同步使用者資訊     |         靜態角色權限設定         |
|     🎯 **使用目的**    |      判斷使用者對話資訊     | 套用預設權限設定，管理設定 AI 助理之後臺權限 |
|     👥 **適用對象**    |       外部訪客、會員      |         內部員工、組織成員        |
|     ⚙️ **管理方式**    |     透過 API 串接管理    |         透過後台角色管理         |
|     📊 **權限控制**    | 基於 Contact ID 動態控制 |       基於 Role 靜態控制       |

## 典型應用場景 <a href="#typical-use-cases" id="typical-use-cases"></a>

**聯絡人使用情境：適合需明確角色分工、權限定義的使用情境**

* **企業官網**：訪客依身份獲得不同產品資訊
* **會員中心**：依等級存取對應服務內容
* **客服中心**：依客戶類型提供差異化支援

**角色使用情境**

* **內部作業**：員工依部門角色處理工作
* **客服團隊**：依職責範圍查詢知識庫
* **管理階層**：依權限進行內容審核維護

## 綜合使用策略 <a href="#combined-strategy" id="combined-strategy"></a>

對外業務(不需要明確知道使用者身分者)適合使用聯絡人管理

對內業務(需要明確權限劃分 / 多個成員可用同一權限者)適合以角色管理

<figure><img src="/files/cyPkhnCc2mlwrd7JrIaC" alt=""><figcaption><p>聯絡人與角色授權使用建議</p></figcaption></figure>


---

# 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/contact-role-comparison.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.