> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/tech/ja/authorization-integration/role-vs-contact.md). # ロール（Role）と連絡先（Contact）の違い MaiAgent には2種類の「人」がいます。**メンバー（Member）**——MaiAgent プラットフォームにログインして管理画面を操作するアカウントで、権限は\*\*ロール（Role）\*\*によって決まります。**コンタクト（Contact）**——AIアシスタントと会話するエンドユーザーで、MaiAgent のアカウントは必要ありません。連携時に最もよくある混乱は、この2つを混同してしまうことです。本ページでは、その違いを一度に明確にご説明します。 ## 定義 ### コンタクト（Contact） 「AIアシスタントと会話するエンドユーザー」を表します。Webサイトの訪問者、会員システムのユーザー、LINE の友だちはすべてコンタクトです。コンタクトは MaiAgent にログインせず、会話時にシステムが自動的に作成するか、お客様のシステムから API を通じて作成し自社アカウントと紐づけます。会話履歴、パーソナライズ属性、ナレッジベース検索範囲、ツール認証情報はすべてコンタクトに紐づきます。 {% hint style="info" %} コンタクトのデータモデルと連携方法については、[コンタクト（Contact）の紹介と連携](/tech/ja/authorization-integration/contacts.md)をご参照ください。 {% endhint %}

名前が設定されていないコンタクトはデフォルトで匿名と表示されます

### ロール（Role） ロールは**メンバーの権限テンプレート**です。MaiAgent 管理画面にログインしたメンバーが操作できる機能や、アクセスできるリソース（AIアシスタント、ナレッジベース、受信トレイなど）を定義します。企業はあらかじめ「カスタマーサポート担当」「事務担当」「インターン」などのロールを定義しておき、メンバーが組織に参加する際にそのまま適用できるため、一人ずつ設定する必要がありません。

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

## 違いの比較

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

| 比較項目 | コンタクト（Contact） | ロール（Role） | | :-------------------: | :--------------------------------------------------------: | :--------------------------: | | 🎯 **対象** | 外部エンドユーザー（訪問者、会員、顧客） | 内部メンバー（従業員、管理者） | | 👤 **MaiAgent アカウント** | ❌ 不要 | ✅ 必要（メンバーがプラットフォームにログイン） | | 📋 **作成方法** | 会話時に自動作成、API で作成、管理画面で手動作成 | 管理画面であらかじめロールを定義し、メンバーに適用 | | 🎯 **制御対象** | 該当ユーザーの会話履歴、パーソナライズ属性、ナレッジベース検索範囲（query\_metadata）、ツール認証情報 | メンバーの管理画面における操作権限とリソースアクセス範囲 | | ⚙️ **管理の入口** | API 連携または管理画面の「コンタクト」 | 管理画面の「ロール権限管理」 | ## ナレッジベース範囲制御の役割分担 両者とも「どのナレッジベースを検索できるか」に影響しますが、仕組みが異なります。 * **コンタクト**：コンタクトに [Query Metadata](/tech/ja/authorization-integration/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan.md) を設定し、該当ユーザーが会話する際にAIが検索できるナレッジベース／ドキュメント／タグの範囲を制限します * **ロール**：メンバーがプラットフォーム内で**閲覧・管理できる**リソースを制御します（詳細はユーザーマニュアルの[ロール権限管理](https://docs.maiagent.ai/org/role-permission)をご覧ください）。メンバーは内部Q\&Aでメッセージごとに参照するナレッジベースの範囲を選択できます ## 選び方 * **外部向けサービス**（公式サイトのカスタマーサポート、会員センター、自社プロダクトへの埋め込み）：ユーザーは MaiAgent アカウントを持つ必要がなく、持つべきでもありません → **コンタクト**を使用し、身元に応じて query\_metadata やカスタム属性を設定して差別化します * **内部利用**（従業員の社内Q\&A、チームによるAIアシスタントの運用）：メンバーがプラットフォームにログインします → **ロール**で一括して権限を付与します * 両者は共存できます：同じ企業内に通常、「管理画面を操作するメンバー」と「AIと会話するコンタクト」の両方が存在し、それぞれ別の仕組みで管理され、互いに重複しません

コンタクトとロールの権限付与の使い分けガイド

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.maiagent.ai/tech/ja/authorization-integration/role-vs-contact.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.