角色(Role) 和 聯絡人(Contact) 的差異

內部成員用角色（Role）管理平台權限，外部使用者用聯絡人（Contact）識別身分；完整對照見使用者手冊

MaiAgent 中有兩種「人」：成員（Member） 登入 MaiAgent 後台操作，權限由角色（Role） 決定；聯絡人（Contact） 是跟 Agent 對話的終端使用者，不需要 MaiAgent 帳號，對話歷史、自訂屬性、知識查詢範圍（query_metadata）與工具憑證都掛在聯絡人上。串接對外服務時用聯絡人，對內發放平台權限時用角色，兩者各走各的機制。

定義、差異對照與選擇方式，見使用者手冊角色和聯絡人的差異；聯絡人的 API 串接見聯絡人 (Contact) 介紹及串接，知識範圍的設定見知識管理權限（Query Metadata）。