ロール（Role）と連絡先（Contact）の違い

社内メンバーはロール（Role）でプラットフォーム権限を管理し、外部ユーザーは連絡先（Contact）で ID を識別します。それぞれの定義、違い、選択方法を説明します

MaiAgent には2種類の「人」が存在します。**メンバー（Member）は、MaiAgent プラットフォームにログインして管理画面を操作するアカウントで、その権限はロール（Role）**によって決まります。**連絡先（Contact）**は、AI アシスタントと対話するエンドユーザーであり、MaiAgent アカウントは必要ありません。連携時によくある混同は、この2つを取り違えることです。このページでは両者の違いを明確に説明します。

定義

連絡先（Contact）

「AI アシスタントと対話するエンドユーザー」を表します。Web サイトの訪問者、会員システムのユーザー、LINE の友だちはすべて連絡先です。連絡先は MaiAgent にログインしません。会話時にシステムによって自動作成されるか、お客様のシステムから API 経由で作成され、自社アカウントに対応付けられます。会話履歴、パーソナライズ属性、ナレッジ検索範囲、ツールの認証情報は、すべて連絡先に関連付けられます。

連絡先のデータモデルと連携方法については、連絡先（Contact）の概要と連携を参照してください。

氏名が設定されていない連絡先は、デフォルトで匿名と表示されます

ロール（Role）

ロールはメンバーの権限テンプレートです。MaiAgent の管理画面にログインしたメンバーが操作できる機能と、アクセスできるリソース（AI アシスタント、ナレッジベース、受信トレイなど）を定義します。企業は「カスタマーサービス担当者」「管理部門担当者」「インターン」などのロールを事前に定義し、メンバーが組織に参加するときに適用できます。これにより、メンバーごとに設定する必要がなくなります。

メンバーの基本情報にあるロール設定

違いの比較

AI アシスタントの埋め込み画面

比較項目	連絡先（Contact）	ロール（Role）
🎯 対象	外部のエンドユーザー（訪問者、会員、顧客）	社内メンバー（従業員、管理者）
👤 MaiAgent アカウント	❌ 不要	✅ 必要（メンバーがプラットフォームにログイン）
📋 作成方法	会話時に自動作成、API で作成、または管理画面で手動作成	管理画面でロールを事前に定義し、メンバーに適用
🎯 制御する内容	ユーザーの会話履歴、パーソナライズ属性、ナレッジ検索範囲（query_metadata）、ツールの認証情報	管理画面でのメンバーの操作権限とリソースへのアクセス範囲
⚙️ 管理画面	API 連携または管理画面の「連絡先」	管理画面の「ロール権限管理」

ナレッジ範囲を制御する役割分担

どちらも「検索できるナレッジ」に影響しますが、その仕組みは異なります。

• 連絡先：連絡先に Query Metadata を設定し、ユーザーとの会話時に AI が検索できるナレッジベース／ドキュメント／タグの範囲を制限します

• ロール：メンバーがプラットフォーム上で閲覧・管理できるリソースを制御します（ユーザーマニュアルのロール権限管理を参照してください）。社内での質疑応答では、メンバーがメッセージごとに参照するナレッジ範囲を選択できます

選択方法

• 社外向けサービス（公式 Web サイトのカスタマーサービス、会員センター、自社製品への埋め込み）：ユーザーに MaiAgent アカウントは不要であり、付与すべきでもありません → 連絡先を使用し、ID に応じて query_metadata またはカスタム属性を関連付けて区別します

• 社内利用（従業員向け社内 Q&A、チームによる AI アシスタントの運用）：メンバーがプラットフォームにログインします → ロールを使用して権限を一括付与します

• 両者は併存できます。同じ企業には通常、「管理画面を管理するメンバー」と「AI と対話する連絡先」の両方が存在します。それぞれ独立した仕組みを使用し、重複することはありません

Contact と Role の権限設定に関する推奨事項