> 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/maiagent-user-guide/maiagent-user-guide-ja/org/contact-role-comparison.md).

# ロールと連絡先の違い

## 会話画面での表示 <a href="#in-conversation-display" id="in-conversation-display"></a>

### 連絡先 <a href="#contact-display" id="contact-display"></a>

MaiAgent がユーザー情報を同期して保存する仕組みでは、連絡先 ID を作成し、ユーザーの会話情報を識別します。

ユーザーはログインや MaiAgent アカウントの保有がなくても作成できます。

{% hint style="info" %}
連絡先について詳しくは、[🌐連絡先](/maiagent-user-guide/maiagent-user-guide-ja/org/contact.md)をご参照ください。
{% endhint %}

<figure><img src="/files/TbMFJXDlRUclxNKzB4Vg" alt=""><figcaption><p>連絡先の名前が未設定の場合：ユーザーはデフォルトで匿名と表示されます</p></figcaption></figure>

### 役割 <a href="#role-display" id="role-display"></a>

ユーザーに役割を付与するには、そのユーザーが MaiAgent アカウントを保有し、組織内に参加している必要があります。企業内では、カスタマーサポート担当者、事務担当者、インターンなど、役割をあらかじめ定義できます。組織内ではあらかじめ役割が利用できる権限や参照するデータベースを設定でき、組織メンバーは必要に応じて役割を選択し、設定をそのまま適用できます。

<figure><img src="/files/DjNFlxDBKxxdisJvZyg8" alt=""><figcaption><p>Role ユーザー基本情報の表示</p></figcaption></figure>

{% hint style="info" %}
役割について詳しくは、🌐[役割権限管理](/maiagent-user-guide/maiagent-user-guide-ja/org/role-permission.md)をご参照ください。
{% endhint %}

## 権限方式の比較 <a href="#permission-comparison" id="permission-comparison"></a>

<figure><img src="/files/b4AelNTXelk2sk76ZTyn" 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/JJUv2GOrQoHOQsS2FbVb" alt=""><figcaption><p>連絡先と役割の付与に関する利用推奨</p></figcaption></figure>


---

# 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/maiagent-user-guide/maiagent-user-guide-ja/org/contact-role-comparison.md?ask=<question>&goal=<endgoal>
```

`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.