> 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/role-permission.md).

# ロール権限管理

### ロールの概念 <a href="#role-concept" id="role-concept"></a>

**ロール**(Role)は組織内の機能単位であり、メンバー構成を自由に設定できます。

* ロールに割り当てるメンバーは、組織内の任意のメンバーから選べます
* 1 人のメンバーが複数のロールを同時に継承でき、柔軟な権限管理を実現します
* 各ロールは独立した権限設定を持ち、さまざまなシーンのニーズに対応しやすくなっています

{% hint style="info" %}
**わかりやすく言うと：**

ロールは会社の「部門」や「職位」のようなものです。たとえばカスタマーサポート部、マーケティング部、管理職などです。まず各部門が何をできるかを定義し、その後で従業員を該当する部門に追加します。
{% endhint %}

***

### ロールタイプの説明 <a href="#role-types" id="role-types"></a>

MaiAgent プラットフォームのロールは 3 つのタイプに分かれています。

#### オーナーロール (Owner Role) <a href="#owner-role" id="owner-role"></a>

\*\*定義：\*\*組織の作成者が自動的に取得する最高権限のロールです。

{% hint style="info" %}
**わかりやすく言うと：**

会社の「社長」や「システム管理者」のようなもので、すべての事柄を管理し、すべてのデータを閲覧でき、いかなる制限もありません。
{% endhint %}

**特徴：**

* すべてのリソースへの完全なアクセス権限を持ち、追加の割り当ては不要です
* ロール、メンバー、権限を含む組織内のすべての設定を管理できます
* 組織には複数のオーナーを設定できます
* オーナーロールを他のメンバーに割り当てたり、メンバーから削除したりできます

{% hint style="warning" %}
オーナーロールは最高権限を持つため、慎重に指定してください。システム全体の管理を本当に必要とする担当者のみが担当することをおすすめします。
{% endhint %}

#### デフォルトロール (Default Role) <a href="#default-role" id="default-role"></a>

\*\*定義：\*\*すべての組織メンバーが自動的に保有する基礎ロールで、メンバーが他のロールを割り当てられる前から基本的な権限を利用できるようにします。

{% hint style="info" %}
**わかりやすく言うと：**

会社の「社員証」のようなもので、入社すれば誰もが自動的に保有します。新入社員が設定を待たずに基本機能を利用できることを保証します。
{% endhint %}

**特徴：**

* すべての組織メンバーが、デフォルトロールの権限を自動的に取得します
* 最も基本的なプラットフォームへのアクセス権限（問い合わせ機能など）を提供します
* Excel による一括割り当てはできません
* 管理者はデフォルトロールの権限範囲をカスタマイズできます
* メンバーを手動で割り当てることはできません（システムがすべてのメンバーに自動的に割り当てます）

{% hint style="warning" %}
**推奨設定：**

デフォルトロールには「最低限」の権限のみを与え、新しいメンバーの誤操作を防いでください。その他の権限は「カスタムロール」で割り当てます。
{% endhint %}

#### カスタムロール (Custom Role) <a href="#custom-role" id="custom-role"></a>

\*\*定義：\*\*管理者が手動または一括で特定のメンバーに割り当てるロールです。

{% hint style="info" %}
**わかりやすく言うと：**

会社の各「部門」や「職位」（カスタマーサポート部、マーケティング部、管理職など）のようなもので、業務上のニーズに応じて異なる権限を付与します。
{% endhint %}

**特徴：**

* 管理者が能動的に割り当てる必要があります
* 異なる職責に応じて、異なる権限の組み合わせを設定できます
* 一括割り当てに対応しており、大量のメンバー管理に便利です
* 割り当て後、メンバーはすぐに対応する権限を取得します

**権限の計算方法：**

```
メンバーの最終権限 = デフォルトロール権限 + すべてのカスタムロール権限
```

**例の説明：**

* メンバー A が「カスタマーサポート部」ロールに割り当てられる → 問い合わせ権限 + 対話権限を取得
* メンバー A がさらに「テストチーム」ロールに割り当てられる → さらに AgentOps 権限が追加される
* 最終的にメンバー A が持つ権限：デフォルト権限 + カスタマーサポート部権限 + テストチーム権限

{% hint style="info" %}
EIP ログインを使用している場合、ロールは企業システムから自動的に同期できます。詳しくは [サードパーティログイン（SSO）](/maiagent-user-guide/maiagent-user-guide-ja/org/sso.md) をご覧ください。
{% endhint %}

***

### ロール権限の編集 <a href="#edit-role-permissions" id="edit-role-permissions"></a>

該当する組織の下で、「<mark style="color:blue;">ロール権限の編集</mark>」をクリックすると、そのロールのメンバーに権限を設定できます。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-7a975283a62bb8d6a763f021934cf66ac249c164%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.34.17.png?alt=media" alt=""><figcaption></figcaption></figure>

ロール権限ページでは、以下の操作ができます。

* <mark style="color:blue;">ロールの追加</mark>：組織にロール（例：マーケティング部門）を作成します。新しいメンバーが参加する際にロールを適用すれば、対応する権限を自動的に取得できます
* <mark style="color:blue;">ロールの編集</mark>：ロール名、説明、所属部門などの基本情報を変更します
  * <mark style="color:blue;">ロール権限</mark>：ロールが使用できる機能モジュールと操作範囲を設定します
  * <mark style="color:blue;">メンバーの割り当て</mark>：組織メンバーを指定したロールに追加し、権限設定を一元管理します
  * <mark style="color:blue;">AI アシスタントの割り当て</mark>：ロールが操作できる AI アシスタントを割り当てます
  * <mark style="color:blue;">ナレッジベースの割り当て</mark>：ロールがアクセスできるナレッジベースを割り当てます
  * <mark style="color:blue;">対話プラットフォームの割り当て</mark>：ロールが使用できる対話プラットフォームを割り当てます
* <mark style="color:blue;">ロールの削除</mark>：使用しなくなったロールを削除し、組織の権限構造を整然と保ちます
* <mark style="color:blue;">一括機能</mark>：Excel で組織にメンバーを一括追加したり、メンバーにロールを一括割り当てしたりします（詳しくは [メンバー管理：メンバーと権限の一括管理](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/org/pages/pWmy4qKrm035yWZYzsSA#進階操作批次成員與權限管理) をご覧ください）

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-9547cec3921fd6b0d51b50f21d4a7bf09531c0c2%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20124330.png?alt=media" alt=""><figcaption><p>ロール権限設定のイメージ図</p></figcaption></figure>

{% hint style="info" %}
**ロール設定タブの説明**

* **オーナーロール**：オーナーロールはすべてのリソースへのアクセス権限を自動的に保有するため、「AI アシスタントの割り当て」「ナレッジベースの割り当て」「対話プラットフォームの割り当て」タブは無効になります
* **デフォルトロール**：デフォルトロールはすべてのメンバーに自動的に割り当てられるため、「メンバーの割り当て」タブは無効になります
  {% endhint %}

***

### 権限の階層 <a href="#permission-levels" id="permission-levels"></a>

MaiAgent は**階層型の権限構造**を採用しており、権限は**主権限**と**子権限**に分かれています。

{% hint style="info" %}
**「階層型の権限構造」とは？**

フォルダの構造のようなものです。

* **主権限** = 親フォルダ（例：「AI 機能」）
* **子権限** = 子フォルダ（例：「AI アシスタント」「ナレッジベース」「クローラー」）

**実際の動作：**

* 主権限にチェックを入れると、その下のすべての子権限が自動的に含まれます
* 一部の子権限のみにチェックを入れることもでき、より細かい制御を実現できます
  {% endhint %}

#### 権限構造の概要 <a href="#permission-structure-overview" id="permission-structure-overview"></a>

<table><thead><tr><th width="180">主権限</th><th width="200">子権限</th><th>説明</th></tr></thead><tbody><tr><td><strong>MaiGPT 権限</strong></td><td>-</td><td>MaiGPT 機能を使用できるかどうかを制御します</td></tr><tr><td><strong>AI 機能権限</strong></td><td>AI アシスタント権限</td><td>「AI アシスタント」タブの閲覧と操作を制御します</td></tr><tr><td>ナレッジベース権限</td><td>「ナレッジベース」タブの閲覧と操作を制御します</td><td></td></tr><tr><td>クローラー権限</td><td>クローラー機能の使用を制御します</td><td></td></tr><tr><td>ツール権限</td><td>ツール管理機能の使用を制御します</td><td></td></tr><tr><td><strong>AgentOps 権限</strong></td><td>テストセット権限</td><td>テストセット機能の閲覧と操作を制御します</td></tr><tr><td>自動テスト権限</td><td>自動テスト機能の使用を制御します</td><td></td></tr><tr><td><strong>カスタマーサポート対話権限</strong></td><td>すべての対話権限</td><td>「すべての対話」タブの閲覧と操作を制御します</td></tr><tr><td>対話プラットフォーム権限</td><td>「対話プラットフォーム」タブの閲覧と操作を制御します</td><td></td></tr><tr><td>連絡先権限</td><td>連絡先管理機能の使用を制御します</td><td></td></tr><tr><td><strong>問い合わせ権限</strong></td><td>-</td><td>「社内問い合わせ」タブの閲覧と操作を制御します</td></tr><tr><td><strong>開発者権限</strong></td><td>API 呼び出し履歴権限</td><td>API 呼び出し履歴の閲覧を制御します</td></tr><tr><td><strong>組織権限</strong></td><td>組織概要権限</td><td>組織概要ページの閲覧を制御します</td></tr><tr><td>アクティビティログ権限</td><td>アクティビティログ機能の閲覧を制御します</td><td></td></tr></tbody></table>

{% hint style="info" %}
**権限階層の説明**

* 主権限にチェックを入れると、その主権限の下のすべての子権限が自動的に含まれます
* 一部の子権限のみにチェックを入れることもでき、より細かい権限制御を実現できます
* ユーザーの最終的な権限は、システムのデフォルトロールとカスタムロールの権限を合算した結果になります
  {% endhint %}

#### 権限設定の説明 <a href="#permission-settings" id="permission-settings"></a>

1. ロールを追加して権限を割り当てる

右上の「<mark style="color:blue;">ロールの追加</mark>」をクリックすると、新しいロールの名前を入力し、そのロールが保有できる権限にチェックを入れられます。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-dad561e86191c3565a4403894f91fe41119d2a0e%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.35.29.png?alt=media" alt=""><figcaption></figcaption></figure>

2. 名前と権限を編集する

編集ページに入り、ロールの名前を編集して、そのロールが保有できる権限を改めてチェックします。

<figure><img src="/files/yIrKr7EjZ50BG5ZPNTRi" alt=""><figcaption></figcaption></figure>

ロールの定義に応じて、組織メンバーが左側メニューの関連する機能タブを閲覧または使用できるかどうかを決められます。チェックボックスで各権限を有効／無効にし、右下の「<mark style="color:blue;">保存</mark>」ボタンをクリックして設定を適用します。

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0783b87df996b84d88fde0fcbf55926789f81eb5%2Fimage.png?alt=media" alt=""><figcaption><p>左側メニューページ</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-bf24dfee27f455c732ba32d0f28059823e729872%2Fimage.png?alt=media" alt=""><figcaption><p>ロール権限設定ページ</p></figcaption></figure></div>

***

### 権限の利用シーン <a href="#permission-use-cases" id="permission-use-cases"></a>

企業が MaiAgent でカスタマーサポートシステムを構築する場合を想定します。

#### シーン 1：新人カスタマーサポート担当者 <a href="#use-case-new-agent" id="use-case-new-agent"></a>

「**問い合わせ権限**」のみを付与します。

* **理由**：入社したばかりで、製品知識と会社の方針を素早く学ぶ必要があるためです
* **回避できる問題**：不慣れな状態のカスタマーサポート担当者が、誤って顧客の対話記録を削除したり、重要な AI アシスタントの設定を変更したりするのを防ぎます

#### シーン 2：ベテランカスタマーサポート <a href="#use-case-senior-agent" id="use-case-senior-agent"></a>

「問い合わせ権限」+「カスタマーサポート対話権限（すべての対話）」

* **理由**：経験が豊富で、複雑なクレーム対応や新人指導をサポートする必要があるためです
* **回避できる問題**：それでも AI 機能権限は付与せず、カスタマーサポート担当者が誤って AI アシスタントの設定を変更し、すべての顧客が誤った回答を受け取る事態を防ぎます

#### シーン 3：AI アシスタント管理者 <a href="#use-case-ai-admin" id="use-case-ai-admin"></a>

「AI 機能権限」+「AgentOps 権限」

* **理由**：AI アシスタントの回答品質の管理と最適化を担当するためです
* **回避できる問題**：カスタマーサポート対話権限は付与せず、顧客のプライバシーデータに触れないようにします

***

### メンバーの割り当て <a href="#assign-members" id="assign-members"></a>

作成したロールを、組織内のメンバーに割り当てることができます。

1. メンバー割り当てページに入ります
2. 「<mark style="color:blue;">+メンバーの割り当て</mark>」ボタンをクリックします

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-b3104a6291189bc44c585c77c3cc8c94797960ff%2F%E6%96%B0%E5%A2%9E%E7%B5%84%E7%B9%94%E6%88%90%E5%93%A1%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

3. 追加したいメンバーを選択し、中央の「<mark style="color:blue;">追加 ></mark>」ボタンをクリックします
4. 最後に右下の「<mark style="color:blue;">確認</mark>」ボタンをクリックして設定を完了します

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-36547435fc643a09591d13cfa3d9efbe12e28b78%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20142922.png?alt=media" alt=""><figcaption><p>追加したいメンバーを選択</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-08c284c6fca180484427fc56972522a9ed230c69%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20143151.png?alt=media" alt=""><figcaption><p>追加をクリック</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-b8d25203866b826023d42962551ebf6149bc4f3e%2Fimage.png?alt=media" alt=""><figcaption><p>追加が完了したら確認をクリック</p></figcaption></figure></div>

先ほど追加したメンバーがメンバーリストに表示されます。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-8eedab66df00e193bba1dc59a334947650fe0127%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

追加後、メンバーは AI アシスタント権限のみを持つため、左側メニューには AI アシスタント機能のメニューのみが表示され、カスタマーサポート対話や組織設定などのその他の機能は左側リストに表示されません。メンバーがアクセス権限のない機能に入ると、権限なしの説明画面が表示されます。

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-aeeba7c85790addbde803ff76419df613991d6a8%2Fimage.png?alt=media" alt=""><figcaption><p>更新後の権限ページ</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-b932395e30752c688534003935d5f76603a04eaf%2Fimage.png?alt=media" alt=""><figcaption><p>権限なしの説明画面</p></figcaption></figure></div>

このようにすることで、そのメンバーは AI アシスタント機能のみを使用でき、その他の変更はできなくなります。

{% hint style="info" %}
複数のメンバーに一括でロールを割り当てる必要がありますか？[メンバー管理：メンバーと権限の一括管理](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/org/pages/pWmy4qKrm035yWZYzsSA#進階操作批次成員與權限管理) をご参照ください。
{% endhint %}

***

### AI アシスタントの割り当て <a href="#assign-chatbots" id="assign-chatbots"></a>

ロールが使用できる AI アシスタントを制限し、ナレッジベースのデータをロール権限に応じて確実に分けて使用できます。

1. 「<mark style="color:blue;">AI アシスタントの割り当て</mark>」ページに入ります
2. 「<mark style="color:blue;">+AI アシスタントの割り当て</mark>」ボタンをクリックします

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-9ff2a8eba77bdcdf9c2cda579ef4f524c1096c4e%2F%E6%96%B0%E5%A2%9E%E7%B5%84%E7%B9%94%E6%88%90%E5%93%A1%20(3).png?alt=media" alt=""><figcaption></figcaption></figure>

3. 追加したい AI アシスタントを選択し、中央の「<mark style="color:blue;">追加 ></mark>」ボタンをクリックします
4. 最後に右下の「<mark style="color:blue;">確認</mark>」ボタンをクリックして設定を完了します

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-e74fbf807830171ad39b2f04e86197a19dc9c54a%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20145640.png?alt=media" alt=""><figcaption><p>追加したい AI アシスタントを選択</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-e26142170b1eab88b4369102e908b8f60589daed%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20145705.png?alt=media" alt=""><figcaption><p>中央の AI アシスタント追加をクリック</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-dabf9685dcea42a7f524261060e7d40e0c1b1556%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20145716.png?alt=media" alt=""><figcaption><p>追加が完了したら確認をクリック</p></figcaption></figure></div>

追加後、先ほど選択した AI アシスタントがリストに表示されます。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-424c73c0f017d69b29da22fa0d87f2f565cc0bc0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

完了後、そのロールのユーザーは割り当てられた AI アシスタントのみを閲覧・使用できます。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0c6c85f1d10a3c86b839f709492fc5083bdf97d3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
オーナーロールはすべての AI アシスタントへのアクセス権限を自動的に保有するため、手動で割り当てる必要はありません。
{% endhint %}

***

### ナレッジベースの割り当て <a href="#assign-knowledge-bases" id="assign-knowledge-bases"></a>

ロールがアクセスできるナレッジベースを制限し、機密データに特定のロールのみがアクセスできるようにします。

1. 「<mark style="color:blue;">ナレッジベースの割り当て</mark>」ページに入ります
2. 「<mark style="color:blue;">+ナレッジベースの割り当て</mark>」ボタンをクリックします

<figure><img src="/files/KZug0Ikv7u4OP3mt8EN4" alt=""><figcaption></figcaption></figure>

3. 追加したいナレッジベースを選択し、中央の「<mark style="color:blue;">追加 ></mark>」ボタンをクリックします
4. 最後に右下の「<mark style="color:blue;">確認</mark>」ボタンをクリックして設定を完了します

追加後、先ほど選択したナレッジベースがリストに表示されます。

**利用シーン：**

* **研究開発部門**：技術文書のナレッジベースのみにアクセスできます
* **営業部門**：製品説明と見積もりのナレッジベースのみにアクセスできます
* **人事部門**：従業員ハンドブックのナレッジベースのみにアクセスできます

{% hint style="info" %}
オーナーロールはすべてのナレッジベースへのアクセス権限を自動的に保有するため、手動で割り当てる必要はありません。
{% endhint %}

***

### 対話プラットフォームの割り当て <a href="#assign-inboxes" id="assign-inboxes"></a>

ロールが使用できる対話プラットフォームを制限し、チームごとに異なるカスタマーサポートチャネルを担当させることができます。

1. 「<mark style="color:blue;">対話プラットフォームの割り当て</mark>」ページに入ります
2. 「<mark style="color:blue;">+対話プラットフォームの割り当て</mark>」ボタンをクリックします

<figure><img src="/files/KoyT1SW6bJHRS7BV5pBD" alt=""><figcaption></figcaption></figure>

3. 追加したい対話プラットフォームを選択し、中央の「<mark style="color:blue;">追加 ></mark>」ボタンをクリックします
4. 最後に右下の「<mark style="color:blue;">確認</mark>」ボタンをクリックして設定を完了します

追加後、先ほど選択した対話プラットフォームがリストに表示されます。

**利用シーン：**

* **LINE カスタマーサポートチーム**：LINE 対話プラットフォームのみにアクセスできます
* **ウェブサイトカスタマーサポートチーム**：Web Chat 対話プラットフォームのみにアクセスできます
* **VIP カスタマーサポートチーム**：すべての対話プラットフォームにアクセスできます

{% hint style="info" %}
オーナーロールはすべての対話プラットフォームへのアクセス権限を自動的に保有するため、手動で割り当てる必要はありません。
{% endhint %}

***

### デフォルトロール <a href="#default-role-setting" id="default-role-setting"></a>

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-50690b7ae204091c72ebc773e4f37365032afbe9%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

デフォルトロールは組織の作成時に自動生成され、すべてのユーザーの基礎ロールとなります。ユーザーロールの内容を適用する際に特別な指定がなければ、システムはデフォルトロール内のすべての権限設定を自動的に適用します。

> デフォルトロールの権限設定は最も低い権限レベルにすることをおすすめします。これにより、他のロールの設定がデフォルトロールに上書きされるのを防げます。

***

### 権限の処理 <a href="#permission-handling" id="permission-handling"></a>

ユーザーが複数のロールに同時に割り当てられている場合、MaiAgent は以下の権限処理ロジックを採用します。

#### 権限の和集合の原則 (Union Principle) <a href="#permission-union-principle" id="permission-union-principle"></a>

\*\*「最大権限」戦略を採用：\*\*ユーザーはすべてのロールの権限の和集合を取得します。つまり、最も広範な操作権限を保有します。

{% hint style="info" %}
**わかりやすく言うと：**

1 人のメンバーが複数のロールに同時に属している場合、いずれか 1 つのロールの権限のみではなく、すべてのロール権限の和集合を取得します。
{% endhint %}

**例の説明：**

```
メンバー B は以下のロールを同時に持っています：
├─ カスタマーサポートロール：問い合わせ権限 + すべての対話権限
└─ マーケティングロール：AI 機能権限（AI アシスタント） + すべての対話権限

→ メンバー B の有効な権限：問い合わせ権限 + すべての対話権限 + AI アシスタント権限
   （重複する権限は重ねて加算されず、1 回のみ計算されます）
```

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0acf4935e240d8735ff6ef35be56b48b883d476c%2Fplayma%20(11).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 権限の適用順序 <a href="#permission-apply-order" id="permission-apply-order"></a>

システムは以下の順序で権限を計算します。

```
ステップ 1：「デフォルトロール」権限を適用
        ↓ （自動、すべてのメンバーが保有）
ステップ 2：「カスタムロール A」権限を適用
        ↓ （管理者が割り当て）
ステップ 3：「カスタムロール B」権限を適用
        ↓ （管理者が割り当て）
最終権限 = ステップ 1 + ステップ 2 + ステップ 3
```

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-edd15e090b569de26e3b7557531619ada7b6afb1%2Fplayma%20(5).png?alt=media" alt=""><figcaption></figcaption></figure>

1. **デフォルトロール**（自動割り当て）
   * 組織の作成時に自動生成されます
   * すべてのユーザーがデフォルトロール権限を自動的に適用されます
2. **カスタムロール**（割り当て順）
   * 後から割り当てられたロールは、既存の権限と統合されます
   * 既存の権限を上書きせず、追加するのみです

{% hint style="warning" %}
**重要なポイント：**

* 後から割り当てられたロールは、既存の権限を「上書きしません」
* 「追加」されるのみです
* 新しいロールを割り当てることで権限を「減らす」ことはできません

**誰かの権限を減らしたい場合は、以下のいずれかが必要です：**

1. そのロールから該当するメンバーを削除する、または
2. ロール自体の権限設定を変更する
   {% endhint %}

#### ロールの和集合の例 <a href="#role-union-example" id="role-union-example"></a>

**シーンの説明：**

* デフォルトロールが 3 つの AI アシスタントに関連付けられている
* カスタムロールが 2 つの AI アシスタントのみに関連付けられている

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-f47ba5e92e8929b76d33612db1965dd2e12acc02%2Fimage.png?alt=media" alt=""><figcaption><p>デフォルトロール</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-61026ebb12a7688dcb50445a3a8d66bed58b6817%2Fimage.png?alt=media" alt=""><figcaption><p>カスタムロール</p></figcaption></figure></div>

\*\*結果：\*\*そのユーザーがカスタムロールに割り当てられていても、デフォルトロールに関連付けられた設定が和集合として含まれ、最終的に 3 つの AI アシスタントを使用できます。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-5541e4d6b9d2a5c2b182f708cd5cfb9c4fc39fef%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
これが、デフォルトロールの権限を最小限に設定することをおすすめする理由です。他のロールの権限制御に影響を与えないようにするためです。
{% endhint %}

#### 権限の削除 <a href="#permission-removal" id="permission-removal"></a>

ユーザーがロールから削除されたとき：

* **カスタムロールの削除**：そのロール固有の権限を失いますが、他のロールの権限は保持されます
* **デフォルトロールは削除不可**：すべてのユーザーは常にデフォルトロールに属します
* **権限チェック**：システムはユーザーの有効な権限を再計算します

**例の説明：**

```
メンバー A の元の権限：問い合わせ + AI 機能 + カスタマーサポート対話
                ↓
「AI 機能開発」ロールを削除
                ↓
メンバー A の有効な権限：問い合わせ + カスタマーサポート対話
```

***

### トラブルシューティング <a href="#troubleshooting" id="troubleshooting"></a>

#### よくある問題：ユーザーが期待した機能を表示できない、または期待を超える機能を使用できる <a href="#faq-user-cannot-see-expected-features" id="faq-user-cannot-see-expected-features"></a>

1. ユーザーが属するすべてのロール（デフォルトロールを含む）で、権限を過剰に開放していないか確認します
2. ユーザーにブラウザのキャッシュをクリアし、再ログインしてもらいます

#### 権限レビューの推奨事項 <a href="#permission-audit-recommendations" id="permission-audit-recommendations"></a>

* ユーザーのロール割り当てが妥当かどうかを定期的に見直します
* 退職したメンバーのすべてのロール割り当てを削除します

***

### よくある質問 <a href="#faq" id="faq"></a>

#### Q：新しいメンバーにより多くの権限を持たせるには？ <a href="#faq-grant-more-permissions" id="faq-grant-more-permissions"></a>

管理者は以下の方法でメンバーに追加のロールを割り当てられます。

* **単一メンバー**：メンバーリストでそのメンバーをクリックし、手動でロールを追加します
* **一括割り当て**：[メンバー管理：メンバーと権限の一括管理](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/org/pages/pWmy4qKrm035yWZYzsSA#進階操作批次成員與權限管理) 機能を使用し、Excel で一度に複数人にロールを割り当てます
* **EIP 自動同期**：EIP ログインを使用している場合、EIP 側でロールを設定すれば、ログイン時に自動的に同期されます（[サードパーティログイン（SSO）](/maiagent-user-guide/maiagent-user-guide-ja/org/sso.md)）

#### Q：なぜデフォルトロールは Excel で一括割り当てできないのですか？ <a href="#faq-default-role-excel-batch" id="faq-default-role-excel-batch"></a>

デフォルトロールはすべてのメンバーが自動的に保有する基礎ロールであり、システムが各メンバーに自動的に割り当てます。そのため、Excel による割り当ては不要であり、許可もされていません。

#### Q：なぜオーナーロールには AI アシスタント、ナレッジベース、対話プラットフォームを割り当てられないのですか？ <a href="#faq-owner-role-cannot-assign-resources" id="faq-owner-role-cannot-assign-resources"></a>

オーナーロールはすべてのリソースへの完全なアクセス権限を持つため、追加の割り当ては不要です。システムが自動的にオーナーロールに組織内のすべてのリソースへのアクセスを許可します。

#### Q：権限の階層構造とはどういう意味ですか？ <a href="#faq-permission-hierarchy-meaning" id="faq-permission-hierarchy-meaning"></a>

MaiAgent の権限は親子の階層構造を採用しています。たとえば「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/maiagent-user-guide/maiagent-user-guide-ja/org/role-permission.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.