角色和聯絡人的差異

內部成員用角色管理平台權限，跟 Agent 對話的終端使用者用聯絡人識別身分；說明兩者的定義、差異與選擇方式

MaiAgent 中有兩種「人」：成員是登入 MaiAgent 後台操作的帳號，權限由角色決定；聯絡人是跟 Agent 對話的終端使用者，不需要 MaiAgent 帳號。兩者各走各的機制，本頁說明差異與選擇方式。

兩種「人」的定義

聯絡人

聯絡人代表「跟 Agent 對話的終端使用者」：您網站上的訪客、會員系統的使用者、LINE 好友都是聯絡人。聯絡人不登入 MaiAgent，由系統在對話時自動建立，或由您的系統透過 API 建立，並以來源 ID（Source ID）對應到自家帳號。Agent 靠聯絡人認得「誰在問」，該使用者的對話歷史、自訂屬性、查詢元資料（可查詢的知識範圍）與工具憑證都掛在聯絡人上。

欲了解聯絡人，請參考 聯絡人

未設定聯絡人姓名：用戶預設為匿名

角色

角色是成員的權限範本：定義登入 MaiAgent 後台的成員可以使用哪些功能、存取哪些資源（Agent、知識庫、對話平台等）。企業可預先定義「客服人員」「行政人員」「實習生」等角色，成員加入組織時直接套用，不必逐人設定。被指派角色的人必須擁有 MaiAgent 帳號並加入組織。

成員基本資料中的角色設定

欲了解角色，請參考 角色權限管理

權限方式對比

Agent 嵌入畫面

比較項目	聯絡人	角色
🎯 對象	外部終端使用者（訪客、會員、客戶）	內部成員（員工、管理者）
👤 MaiAgent 帳號	❌ 不需要	✅ 需要（成員登入平台）
📋 建立方式	對話時自動建立、API 建立、後台手動建立或批次匯入	後台預先定義角色，成員套用
🎯 控制什麼	該使用者的對話歷史、自訂屬性、可查詢的知識範圍（查詢元資料）、工具憑證	成員在後台的操作權限與資源存取範圍
⚙️ 管理入口	後台「聯絡人」或 API 串接	後台「角色權限管理」

知識範圍控制的分工

兩者都能影響「查得到哪些知識」，但機制不同：

• 聯絡人：在聯絡人上設定查詢元資料，限制該使用者對話時 AI 可檢索的知識庫、文件與標籤範圍。

• 角色：控制成員在平台內看得到、管得到哪些資源；成員在內部問答中，則可逐訊息選擇要參考的知識範圍。角色不是查詢元資料的設定層級。

典型應用場景

聯絡人使用情境：對外服務，依「誰在問」提供差異化內容

• 企業官網：訪客依身分獲得不同產品資訊

• 會員中心：依等級存取對應服務內容

• 客服中心：依客戶類型提供差異化支援

角色使用情境：對內使用，依職責發放平台權限

• 內部作業：員工依部門角色處理工作

• 客服團隊：依職責範圍查詢知識庫

• 管理階層：依權限進行內容審核維護

綜合使用策略

• 對外服務（官網客服、會員中心、嵌入自家產品）：使用者不需要也不該有 MaiAgent 帳號，用聯絡人，依身分設定查詢元資料或自訂屬性做差異化。

• 對內使用（員工用內部問答、團隊維運 Agent）：成員登入平台，用角色統一發放權限。

• 兩者可並存：同一個企業通常同時有「管後台的成員」與「跟 AI 對話的聯絡人」，各走各的機制，互不重疊。

聯絡人與角色授權使用建議

用 API 建立聯絡人、同步身分與工具憑證，請見技術人員手冊 聯絡人 (Contact) 介紹及串接。