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

# ロール権限の管理

ロール権限管理：3 種類のロール、ロールの作成、機能権限の選択、AI アシスタント／ナレッジベース／会話プラットフォームなどのリソースの割り当て、およびメンバーに Agent が表示されない場合のチェックリストを説明します。

このページの内容：[ロールの概念](#role-concept)｜[ロールの種類](#role-types)｜[ロール権限の編集](#edit-role-permissions)｜[権限の階層](#permission-levels)｜[権限の利用例](#permission-use-cases)｜[メンバーの割り当て](#assign-members)｜[AI アシスタントの割り当て](#assign-chatbots)｜[チームの割り当て](#assign-teams)｜[ナレッジベースの割り当て](#assign-knowledge-bases)｜[会話プラットフォームの割り当て](#assign-inboxes)｜[データベース、ツール、Agent UI ツールの割り当て](#assign-databases-tools)｜[割り当てダイアログでの絞り込みと公式組み込みアシスタントの非表示](#assign-picker-filters)｜[割り当てダイアログでの全選択と削除](#assign-picker-select-remove)｜[デフォルトロール](#default-role-setting)｜[権限の処理](#permission-handling)｜[トラブルシューティング](#troubleshooting)｜[よくある質問](#faq)

## ロールの概念 <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 %}

**特徴：**

* 追加の割り当てなしで、すべてのリソースに完全にアクセスできます
* ロール、メンバー、権限など、組織内のすべての設定を管理できます
* 1 つの組織に複数のオーナーを設定できます
* 他のメンバーにオーナーロールを割り当てたり、メンバーから解除したりできます

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

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

\*\*定義：\*\*組織のすべてのメンバーに自動で付与される基本ロールです。他のロールが割り当てられる前でも、基本的な権限を利用できます。

{% hint style="info" %}
**わかりやすく説明すると：**

入社すると全員が自動で受け取る「社員証」のようなものです。新入社員は設定を待たずに基本機能を利用できます。
{% endhint %}

**特徴：**

* 組織のすべてのメンバーに、デフォルトロールの権限が自動で付与されます
* 質問応答機能など、プラットフォームの基本的なアクセス権限を提供します
* Excel による一括割り当てはできません
* 管理者がデフォルトロールの権限範囲をカスタマイズできます
* [ファイルライブラリ](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library.md)の権限は付与できません。ファイルライブラリはデフォルトではオーナーのみが操作できます。メンバーに利用を許可する場合は、カスタムロールを作成してファイルライブラリの権限を付与してください
* メンバーを手動で割り当てることはできません（システムがすべてのメンバーに自動で割り当てます）

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

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

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

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

{% hint style="info" %}
**わかりやすく説明すると：**

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

**特徴：**

* 管理者による明示的な割り当てが必要です
* 職責に応じて異なる権限の組み合わせを設定できます
* 一括割り当てに対応し、多数のメンバーを簡単に管理できます
* 割り当てると、メンバーに対応する権限がすぐに付与されます

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

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

**例：**

* メンバー A に「カスタマーサポート部」ロールを割り当てます → Agent マーケットプレイス権限 + 会話権限が付与されます
* メンバー A に「テストチーム」ロールも割り当てます → AgentOps 権限が追加されます
* メンバー A の最終的な権限：デフォルト権限 + カスタマーサポート部の権限 + テストチームの権限

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

***

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

ロール権限ページには、組織概要からアクセスできます。左側メニューの <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概要</mark> をクリックし、<mark style="color:blue;">管理操作</mark> セクションで <mark style="color:blue;">ロール権限を編集</mark> をクリックします。組織のすべてのロールが一覧表示されます。

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

* <mark style="color:blue;">ロールを追加</mark>：組織のロール（例：マーケティング部）を作成します。新しいメンバーにロールを適用すると、対応する権限が自動で付与されます
* <mark style="color:blue;">複製</mark>：既存のカスタムロールをテンプレートとして新しいロールを作成します。[ロールの複製](#duplicate-role)をご覧ください
* <mark style="color:blue;">編集</mark>：ロール設定ページを開きます。次のタブが順に表示されます
  * <mark style="color:blue;">ロール権限</mark>：ロールが利用できる機能モジュールと操作範囲を設定します
  * <mark style="color:blue;">メンバーを割り当て</mark>：組織のメンバーを指定のロールに追加し、権限設定をまとめて管理します
  * <mark style="color:blue;">MaiGPT 利用権限を割り当て</mark>：このロールが MaiGPT で利用できるモデル、機能、ツール、スキル、コネクタを設定します（詳しくは [MaiGPT ロール利用権限](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/maigpt-role-permissions.md)をご覧ください）
  * <mark style="color:blue;">AI アシスタントを割り当て</mark>：ロールが操作できる Agent を割り当てます
  * <mark style="color:blue;">チームを割り当て</mark>：ロールが利用、会話履歴の閲覧、編集、削除を行えるチームを設定します。[チームの割り当て](#assign-teams)をご覧ください
  * <mark style="color:blue;">ナレッジベースを割り当て</mark>：ロールがアクセスできるナレッジベースを割り当てます
  * <mark style="color:blue;">データベースを割り当て</mark>：ロールがアクセスできるデータベースを割り当てます。[データベースの割り当て](#assign-databases)をご覧ください
  * <mark style="color:blue;">ツールを割り当て</mark>：ロールが Agent に追加できるツールを割り当てます。[ツールの割り当て](#assign-tools)をご覧ください
  * <mark style="color:blue;">Agent UI ツールを割り当て</mark>：ロールが利用できる Agent UI ツールを割り当てます。[Agent UI ツールの割り当て](#assign-agent-ui-tools)をご覧ください
  * <mark style="color:blue;">スキルを割り当て</mark>：ロールが読み取れるスキルを割り当てます。各スキルの読み取り／編集／削除権限と、スキルの新規作成を許可するかどうかも設定できます（詳しくは[スキル管理：ロール別のスキル表示と権限の制御](https://docs.maiagent.ai/maiagent-user-guide/ja/build/skills/skills-management.md#skill-role-visibility)をご覧ください）
  * <mark style="color:blue;">会話プラットフォームを割り当て</mark>：ロールが利用できる会話プラットフォームを割り当てます
  * <mark style="color:blue;">Credit 上限</mark>：Credits 課金の組織のみで利用できます。ロール全体で共有する上限を設定します（詳しくは[ロールの上限](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits/member-credit-quota.md#role-quota)をご覧ください）
* <mark style="color:blue;">削除</mark>：使わなくなったロールを削除し、組織の権限構成を整理します。デフォルトロールは削除できません
* <mark style="color:blue;">権限を一括設定</mark>：同じ権限設定を複数のカスタムロールにまとめて適用します。適用前に、各ロールで追加・取り消しされる項目をプレビューできます（詳しくは[ロール権限の一括設定](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-batch-permissions.md)をご覧ください）
* <mark style="color:blue;">一括操作</mark>：Excel を使って組織へのメンバー追加やメンバーへのロール割り当てを一括で行います（詳しくは[メンバー管理：メンバーと権限の一括管理](https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview/member.md#batch-member-permission-management)をご覧ください）

{% hint style="info" %}
**ロール設定タブについて**

* **オーナーロール**：「MaiGPT 利用権限を割り当て」「AI アシスタントを割り当て」「チームを割り当て」「ナレッジベースを割り当て」「データベースを割り当て」「ツールを割り当て」「Agent UI ツールを割り当て」「スキルを割り当て」「会話プラットフォームを割り当て」などのリソース割り当てタブは無効になります。オーナーロールには、すべてのリソースへのアクセス権限が自動で付与されるためです
* **デフォルトロール**：「メンバーを割り当て」タブは無効になります。デフォルトロールはすべてのメンバーに自動で割り当てられるためです
  {% endhint %}

### ロールの複製 <a href="#duplicate-role" id="duplicate-role"></a>

既存のロールと似た設定のロールを作成する場合は、最初から権限を選び直す必要はありません。

1. ロール一覧で複製元のロールを探し、操作列の <mark style="color:blue;">複製</mark> アイコンをクリックします（このアイコンはカスタムロールにのみ表示されます。オーナーロールとデフォルトロールは複製できません）
2. <mark style="color:blue;">ロールを複製</mark> ダイアログで <mark style="color:blue;">複製元のロール</mark> を確認し、<mark style="color:blue;">新しいロール名</mark> を変更します（デフォルトは「複製元のロール名 - コピー」です）
3. <mark style="color:blue;">複製を確定</mark> をクリックすると、新しいロールが一覧に表示されます。<mark style="color:blue;">編集</mark> をクリックし、必要な設定を調整します

{% hint style="warning" %}
新しいロールには、複製元の権限とリソースの関連付けが引き継がれます。各リソースの読み取り／編集／削除設定もそのまま引き継がれます。メンバーと上限は引き継がれないため、必要に応じて新しいロールで別途設定してください。

同じ権限を複数の既存ロールに適用する場合は、[権限の一括設定](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-batch-permissions.md)を使用してください。
{% 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>

次の表は、現在公開されている機能の権限をまとめたものです（親権限 14 項目、子権限 41 項目）。子権限がない親権限は「—」で示しています。各行の「説明」は、その権限で制御するページや操作を示しています。リンク先で各機能の使い方を確認できます。

| 親権限                   | 子権限                | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| --------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **MaiGPT 権限**         | —                  | 左側メニューに [MaiGPT](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt.md) を表示し、利用できるかどうかを制御します                                                                                                                                                                                                                                                                                                                                                                    |
| **Agent マーケットプレイス権限** | 未有効化の公式 Agent の閲覧  | 親権限：左側メニューに <mark style="color:blue;">Agent マーケットプレイス</mark> を表示し、利用できるかどうかを制御します（[Agent との会話](https://docs.maiagent.ai/maiagent-user-guide/ja/work/explain.md)）。子権限：<mark style="color:blue;">Agent マーケットプレイス</mark> の <mark style="color:blue;">公式組み込み</mark> タブに、組織がまだ有効化していない公式 Agent を表示するかどうかを制御します。この権限がない場合は、有効化済みの Agent のみが表示されます（[未有効化の公式 Agent を閲覧できるユーザー](https://docs.maiagent.ai/maiagent-user-guide/ja/work/built-in-agents/use.md#inactive-visibility)） |
| **会議記録権限**            | リアルタイム文字起こし権限      | [会議記録](https://docs.maiagent.ai/maiagent-user-guide/ja/work/meeting-records.md)で新しい会議を作成し、録音を開始できます                                                                                                                                                                                                                                                                                                                                                                      |
|                       | 会議一覧権限             | 会議一覧と詳細の閲覧、およびダウンロードができます                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **会議記録管理権限**          | —                  | 組織で会議記録のプライバシーモードを有効にした場合、自分が作成した会議や追加された会議だけでなく、組織内のすべての会議を閲覧できます（詳しくは[会議のアクセス権限](https://docs.maiagent.ai/maiagent-user-guide/ja/work/meeting-records/access-control.md)をご覧ください）                                                                                                                                                                                                                                                                                       |
| **ファイルライブラリ権限**       | 個人スペース権限           | 左側メニューに[ファイルライブラリ](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library.md)が表示され、自分の <mark style="color:blue;">マイファイル</mark> を利用できます                                                                                                                                                                                                                                                                                                                        |
|                       | 組織スペース閲覧権限         | <mark style="color:blue;">組織共有ファイル</mark> の閲覧、検索、ダウンロードができます                                                                                                                                                                                                                                                                                                                                                                                                             |
|                       | 組織スペース編集権限         | 組織共有ファイルで、ファイルのアップロード、移動、名前変更、削除ができます                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|                       | 共有スペース作成権限         | [共有スペース](https://docs.maiagent.ai/maiagent-user-guide/ja/work/file-library/shared-spaces.md)の作成・削除、およびスペース名と許可するロールの変更ができます                                                                                                                                                                                                                                                                                                                                              |
|                       | 共有スペースへの招待を受ける権限   | ロールが共有スペースへのアクセスを許可された場合にのみ、メンバーにそのスペースが表示されます                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **AI 機能権限**           | AI アシスタント権限        | <mark style="color:blue;">AI 機能</mark> → <mark style="color:blue;">AI アシスタント</mark> ページ（[Agent](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent.md)）、および [Agent テンプレートライブラリ](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/agent-templates.md)のテンプレートの閲覧・適用が対象です（組織のプランに Agent Builder が含まれている必要もあります）                                                                                                                                         |
|                       | ナレッジベース権限          | <mark style="color:blue;">ナレッジベース</mark> ページが対象です（[ナレッジベース](https://docs.maiagent.ai/maiagent-user-guide/ja/build/knowledge-base.md)）                                                                                                                                                                                                                                                                                                                                    |
|                       | ツール権限              | MCP コネクタ管理を含む <mark style="color:blue;">ツール</mark> ページが対象です（[ツール](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools.md)）                                                                                                                                                                                                                                                                                                                                       |
|                       | クローラー権限            | <mark style="color:blue;">クローラー</mark> ページが対象です（[クローラー](https://docs.maiagent.ai/maiagent-user-guide/ja/build/knowledge-base/crawler.md)）                                                                                                                                                                                                                                                                                                                                |
|                       | データベース権限           | <mark style="color:blue;">データベース</mark> ページが対象です（[データベース](https://docs.maiagent.ai/maiagent-user-guide/ja/build/database.md)）                                                                                                                                                                                                                                                                                                                                            |
|                       | スキル権限              | <mark style="color:blue;">スキル</mark> ページが対象です（[スキル](https://docs.maiagent.ai/maiagent-user-guide/ja/build/skills.md)）                                                                                                                                                                                                                                                                                                                                                    |
|                       | スケジュール管理権限         | <mark style="color:blue;">Agent スケジュール</mark> ページで、スケジュールの閲覧、作成、編集、有効化／一時停止、即時実行、削除ができます（[Agent スケジュール](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/schedule.md)）                                                                                                                                                                                                                                                                                        |
|                       | Agent UI 権限        | <mark style="color:blue;">Agent UI</mark> ページが対象です（[Agent UI](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/agent-ui.md)）                                                                                                                                                                                                                                                                                                                                  |
|                       | チーム権限              | <mark style="color:blue;">チーム</mark> ページが対象です（[Agent Teams](https://docs.maiagent.ai/maiagent-user-guide/ja/build/teams.md)）                                                                                                                                                                                                                                                                                                                                             |
|                       | スケジュール閲覧権限         | <mark style="color:blue;">Agent スケジュール</mark> ページ、スケジュール詳細、上限、実行履歴を閲覧できますが、変更はできません。<mark style="color:blue;">スケジュール管理権限</mark> には、この権限も含まれています                                                                                                                                                                                                                                                                                                                          |
| **Hook 権限**           | —                  | <mark style="color:blue;">Hook</mark> ページで、Hook テンプレート、Hook、Agent への追加設定を操作できます（[Hook メッセージインターセプト](https://docs.maiagent.ai/maiagent-user-guide/ja/build/hook.md)）                                                                                                                                                                                                                                                                                                      |
| **AgentOps 権限**       | テストセット権限           | <mark style="color:blue;">AgentOps</mark> → <mark style="color:blue;">テストセット</mark> ページが対象です（[テストセット管理](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent-ops/test-datasets.md)）                                                                                                                                                                                                                                                                               |
|                       | 自動テスト権限            | <mark style="color:blue;">自動テスト</mark> ページが対象です（[自動評価と Agent 監視](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent-ops/evaluations.md)）                                                                                                                                                                                                                                                                                                                        |
|                       | AI アシスタント監視権限      | <mark style="color:blue;">AI アシスタント監視</mark> ページが対象です（[自動評価と Agent 監視](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent-ops/evaluations.md)）                                                                                                                                                                                                                                                                                                                  |
|                       | ツール実行履歴権限          | <mark style="color:blue;">ツール実行履歴</mark> ページが対象です（[ツール実行履歴](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent-ops/tool-execution-records.md)）                                                                                                                                                                                                                                                                                                                  |
| **カスタマーサポート会話権限**     | すべての会話権限           | <mark style="color:blue;">カスタマーサポート会話</mark> → <mark style="color:blue;">すべての会話</mark> ページが対象です（[すべての会話](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/daily-operations/reply.md)）                                                                                                                                                                                                                                                                               |
|                       | 他の担当者の会話を転送する権限    | 他の担当者が対応中の会話を転送できます。未選択の場合は、自分が対応中の会話のみ転送できます（[他の担当者の会話を転送する権限](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/transfer-others-permission.md)）                                                                                                                                                                                                                                                                                                                |
|                       | 会話プラットフォーム権限       | <mark style="color:blue;">会話プラットフォーム</mark> ページ（[会話プラットフォーム設定の概要](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings.md)）、および Agent の <mark style="color:blue;">会話プラットフォーム</mark> タブにある <mark style="color:blue;">プラットフォーム設定</mark> と <mark style="color:blue;">チャネルを接続</mark> が対象です（[会話プラットフォーム権限がない場合](#without-inbox-permission)をご覧ください）                                                                                   |
|                       | 連絡先権限              | <mark style="color:blue;">連絡先</mark> ページが対象です（[連絡先](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/daily-operations/contact.md)）                                                                                                                                                                                                                                                                                                                                  |
|                       | 会話プラットフォーム分析権限     | <mark style="color:blue;">会話プラットフォーム分析</mark> ページが対象です（[会話プラットフォーム分析](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/daily-operations/reply/inbox-analysis.md)）                                                                                                                                                                                                                                                                                                   |
| **通話センター権限**          | 通話コンソール            | <mark style="color:blue;">通話センター</mark> → <mark style="color:blue;">通話コンソール</mark> ページが対象です（[電話カスタマーサポート（通話センター）](https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/call-center.md)）                                                                                                                                                                                                                                                                  |
|                       | 通話履歴               | <mark style="color:blue;">通話履歴</mark> ページが対象です                                                                                                                                                                                                                                                                                                                                                                                                                           |
|                       | 着信設定               | <mark style="color:blue;">着信設定</mark> ページが対象です                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **AI Gateway 権限**     | —                  | 左側メニューに [AI Gateway](https://docs.maiagent.ai/maiagent-user-guide/ja/build/ai-gateway.md) を表示し、アクセスできるかどうかを制御します。この権限のないメンバーからの AI Gateway API リクエストも拒否されます                                                                                                                                                                                                                                                                                                              |
| **組織設定権限**            | 組織概要権限             | <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概要</mark> ページが対象です。ページ内の <mark style="color:blue;">管理操作</mark>（メンバー編集、ロール権限編集、ID 同期、OAuth アプリケーションなどへの入口）も含みます（[組織概要](https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview/organization-overview.md)）                                                                                                                                                                                        |
|                       | アクティビティログ権限        | <mark style="color:blue;">アクティビティログ</mark> ページが対象です（[アクティビティログ](https://docs.maiagent.ai/maiagent-user-guide/ja/org/activity-log.md)）                                                                                                                                                                                                                                                                                                                                    |
|                       | 使用量統計権限            | <mark style="color:blue;">使用量統計</mark> ページが対象です（[使用量統計](https://docs.maiagent.ai/maiagent-user-guide/ja/others/usage-statistics.md)）。選択後、<mark style="color:blue;">使用量統計の範囲</mark> を <mark style="color:blue;">組織全体</mark>（デフォルト）または <mark style="color:blue;">許可されたアシスタントのみ</mark> に設定できます（[許可された Agent の使用量のみを表示](https://docs.maiagent.ai/maiagent-user-guide/ja/others/usage-statistics.md#scope-to-authorized-agents)をご覧ください）                                       |
|                       | Credit 管理権限        | <mark style="color:blue;">Credits</mark> ページが対象です（[Credits 課金制度](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits.md#management-panel)）                                                                                                                                                                                                                                                                                                                    |
|                       | 請求管理権限             | Credit 設定と支払い情報を含む <mark style="color:blue;">請求管理</mark> ページが対象です                                                                                                                                                                                                                                                                                                                                                                                                        |
|                       | モデル利用権限            | <mark style="color:blue;">モデル利用権限</mark> ページが対象です（[モデル利用権限](https://docs.maiagent.ai/maiagent-user-guide/ja/org/model-access.md)）                                                                                                                                                                                                                                                                                                                                        |
|                       | ID 同期権限            | <mark style="color:blue;">ID 同期</mark> の設定を操作できます（[ID 同期（LDAP／SCIM）](https://docs.maiagent.ai/maiagent-user-guide/ja/org/identity-sync.md)）                                                                                                                                                                                                                                                                                                                              |
|                       | API Key 管理権限       | <mark style="color:blue;">API Key 管理</mark> ページが対象です（[API Key 管理](https://docs.maiagent.ai/maiagent-user-guide/ja/org/developer/api-keys.md)）                                                                                                                                                                                                                                                                                                                            |
|                       | OAuth アプリケーション管理権限 | <mark style="color:blue;">OAuth アプリケーション</mark> の作成、編集、削除、client secret の再生成ができます。一覧の閲覧には、この権限は不要です（[OAuth アプリケーション](https://docs.maiagent.ai/maiagent-user-guide/ja/org/developer/oauth-applications.md)）                                                                                                                                                                                                                                                               |
|                       | 組み込み Agent 管理権限    | <mark style="color:blue;">組み込み Agent 管理</mark> ページで、公式組み込み Agent を有効化／無効化できます（[公式組み込み Agent 管理](https://docs.maiagent.ai/maiagent-user-guide/ja/org/management.md)）                                                                                                                                                                                                                                                                                                      |
| **開発者権限**             | API 呼び出しログ権限       | <mark style="color:blue;">開発者</mark> → <mark style="color:blue;">API 呼び出しログ</mark> ページが対象です（[API 呼び出しログ](https://docs.maiagent.ai/maiagent-user-guide/ja/org/developer/api-logs.md)）                                                                                                                                                                                                                                                                                     |
| **MaiGPT コネクタ管理権限**   | —                  | MCP Registry から組織の MaiGPT コネクタを追加し、有効化／無効化できます（[コネクタの管理（管理者）](https://docs.maiagent.ai/maiagent-user-guide/ja/work/maigpt/connectors/connectors-admin.md)）。メンバーがコネクタを利用する場合は、MaiGPT 権限のみが必要です                                                                                                                                                                                                                                                                            |

{% hint style="info" %}
**権限階層について**

* 親権限を選択すると、その配下のすべての子権限が自動で含まれます
* 一部の子権限だけを選択して、より細かく権限を制御することもできます
* ユーザーの最終的な権限は、システムのデフォルトロールとカスタムロールの権限を合算したものです
* <mark style="color:blue;">未有効化の公式 Agent の閲覧</mark> は親権限から継承されません。<mark style="color:blue;">Agent マーケットプレイス権限</mark> を選択すると、このチェックボックスもデフォルトで選択されますが、選択を解除した後は、このチェックボックス自体の設定が適用されます。メンバーに未有効化の公式 Agent を表示しない場合は、デフォルトロールとそのメンバーが所属するすべてのロールで選択を解除してください。[未有効化の公式 Agent を閲覧できるユーザー](https://docs.maiagent.ai/maiagent-user-guide/ja/work/built-in-agents/use.md#inactive-visibility)をご覧ください
* この表にない権限が画面に表示される場合は、まだ正式に公開されていない機能の権限です
* 一般的な機能権限は「どの機能ページを表示するか」を決定します。一方、<mark style="color:blue;">他の担当者の会話を転送する権限</mark> は、会話内での操作を制御します。設定方法は[他の担当者の会話を転送する権限](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/transfer-others-permission.md)をご覧ください。メンバーが実際に操作できる Agent、ナレッジベース、会話プラットフォームは、別途[メンバーとリソースの割り当て](#assign-members)と[ロールのリソースアクセス権限](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/group-resource-access.md)で決まります
  {% endhint %}

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-216a34d862464be493f54dcdd28e66c38768a1f1%2Frole-permission-view-inactive-official-agents.png?alt=media" alt="ロール権限ページの Agent マーケットプレイス権限と、その子権限「未有効化の公式 Agent の閲覧」。組織がまだ有効化していない公式 Agent を Agent マーケットプレイスの公式組み込みタブに表示するかどうかを制御します"><figcaption><p>Agent マーケットプレイス権限の配下にある「未有効化の公式 Agent の閲覧」</p></figcaption></figure>

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

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

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

2. 名前と権限を編集します

編集ページでロールの名前を変更し、付与する権限を選び直します。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-470041daafa472fd4ed71bcaf1937aed0f200480%2Fimage%20(222).png?alt=media" alt="ロール権限ページで、ロール名の設定と各機能権限の選択ができます"><figcaption></figcaption></figure>

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

### 特定のロールに AI Gateway の利用を許可する <a href="#enable-ai-gateway-for-role" id="enable-ai-gateway-for-role"></a>

社内でモデル管理担当者だけが AI Gateway を閲覧する必要がある場合は、その担当者が所属するロールだけに権限を付与できます。

1. <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概要</mark> を開き、<mark style="color:blue;">管理操作</mark> で <mark style="color:blue;">ロール権限を編集</mark> をクリックします。
2. ロールを追加する場合は、<mark style="color:blue;">ロールを追加</mark> をクリックしてロール名を入力します。既存ロールの <mark style="color:blue;">ロール権限</mark> を直接編集することもできます。
3. <mark style="color:blue;">AI Gateway 権限（AI Gateway Permission）</mark> を選択し、<mark style="color:blue;">確認</mark> をクリックします。英語の画面では、ボタンに <mark style="color:blue;">OK</mark> と表示されます。
4. モデル管理担当者をこのロールに割り当てます。メンバーが管理画面に入り直すと、左側メニューに AI Gateway が表示されます。この権限のないメンバーにはメニューが表示されず、関連ページへ直接アクセスすることもできません。AI Gateway API リクエストも拒否されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-87a186a534fe69fc7247cfb7c71bdd9067dff353%2Fai-gateway-role-permission.png?alt=media" alt="ロール権限ダイアログで AI Gateway 権限を選択した状態"><figcaption><p>AI Gateway 権限を選択すると、このロールのメンバーが AI Gateway を表示してアクセスできます</p></figcaption></figure>

{% hint style="info" %}
メンバーの最終的な権限は、デフォルトロールとすべてのカスタムロールの権限を合算したものです。メンバーに引き続き AI Gateway が表示される場合は、そのメンバーが所属する他のロールも確認してください。
{% endhint %}

***

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

企業が MaiAgent を使ってカスタマーサポートシステムを構築する場合を例に説明します。

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

「**Agent マーケットプレイス権限**」のみを付与します。

* **理由**：入社直後のため、製品知識や社内ポリシーを素早く学ぶ必要があります
* **防ぎたい問題**：操作に慣れていない担当者が、顧客との会話履歴を誤って削除したり、重要な Agent 設定を変更したりすることを防ぎます

### ケース 2：経験豊富なカスタマーサポート担当者 <a href="#use-case-senior-agent" id="use-case-senior-agent"></a>

「Agent マーケットプレイス権限」+「カスタマーサポート会話権限（すべての会話）」を付与します。

* **理由**：豊富な経験を活かし、複雑な苦情への対応や新人の指導を行う必要があります
* **防ぎたい問題**：AI 機能権限は引き続き付与せず、担当者が Agent 設定を誤って変更し、すべての顧客に誤った回答が届くことを防ぎます

### ケース 3：Agent 管理者 <a href="#use-case-ai-admin" id="use-case-ai-admin"></a>

「AI 機能権限」+「AgentOps 権限」を付与します。

* **理由**：Agent の回答品質の管理と改善を担当します
* **防ぎたい問題**：カスタマーサポート会話権限を付与せず、顧客の個人情報へのアクセスを防ぎます

***

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

作成したロールを組織のメンバーに割り当てられます。

1. ロール一覧で対象ロールの <mark style="color:blue;">編集</mark> をクリックし、「<mark style="color:blue;">メンバーを割り当て</mark>」タブに切り替えます
2. 「<mark style="color:blue;">メンバーを割り当て</mark>」ボタンをクリックします
3. ダイアログの左側で追加するメンバーを選択し、中央の「<mark style="color:blue;">追加 ></mark>」ボタンをクリックして右側に移動します
4. 最後に右下の「<mark style="color:blue;">確認</mark>」ボタンをクリックして設定を完了します

追加したメンバーがメンバー一覧に表示されます。

追加後、メンバーが <mark style="color:blue;">AI アシスタント</mark> 権限のみを持つ場合、左側のメニューには Agent 機能のメニューだけが表示されます。カスタマーサポートの会話や組織設定など、その他の機能は左側の一覧に表示されません。権限のない機能に URL を直接入力してアクセスすると、権限がないことを説明する画面が表示されます。これにより、そのメンバーは Agent 機能のみを利用でき、その他の変更はできません。

{% hint style="info" %}
複数のメンバーにまとめてロールを割り当てる場合は、[メンバー管理：メンバーと権限の一括管理](https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview/member.md#batch-member-permission-management)をご覧ください。
{% endhint %}

***

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

ロールが使用できる Agent を制限し、ロールの権限に応じてナレッジベースのデータを分けて利用できます。

1. 「<mark style="color:blue;">AI アシスタントの割り当て</mark>」ページを開きます
2. 「<mark style="color:blue;">AI アシスタントの割り当て</mark>」ボタンをクリックします
3. ウィンドウ左側の「選択可能な AI アシスタント」で追加する Agent を選択し、中央の「<mark style="color:blue;">AI アシスタントを追加 ></mark>」ボタンをクリックして、右側の「選択済みの AI アシスタント」に移動します
4. 最後に右下の「<mark style="color:blue;">確認</mark>」ボタンをクリックして設定を完了します

追加すると、選択した Agent が一覧に表示されます。各行で読み取り、編集、削除を個別に選択できます。このロールのユーザーは、割り当てられた Agent のみを表示・使用できます。

Agent の割り当てを解除する場合は、同じウィンドウで右側の割り当て済み Agent を左側に戻して削除できます。その Agent の会話プラットフォームも、このロールからあわせて割り当てが解除されます。[割り当てウィンドウでの全選択と削除](#assign-picker-select-remove)をご覧ください。

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

***

## チームの割り当て <a href="#assign-teams" id="assign-teams"></a>

管理者はロールを使って [Agent Teams](https://docs.maiagent.ai/maiagent-user-guide/ja/build/teams.md) の権限をまとめて設定できます。メンバーには業務に必要なチームのみを使用できるようにし、担当業務に応じて記録の閲覧や設定の変更を許可できます。

例えば、カスタマーサポートの責任者が、担当者にはサポートチームを使用させ、保守担当者だけにキャンバスの変更を許可したい場合です。まず、サポート用ロールにチームを割り当て、<mark style="color:blue;">使用</mark> を有効にしておきます。次に、同じチームを保守用ロールにも割り当て、<mark style="color:blue;">編集</mark> を選択します。これにより、2 つのロールで同じチームを共有しながら、会話と保守をそれぞれ担当できます。

{% stepper %}
{% step %}
ロール一覧で対象のロールを編集し、<mark style="color:blue;">チームの割り当て</mark> に切り替えて、同名のボタンをクリックします。
{% endstep %}

{% step %}
左側でチームを選択し、<mark style="color:blue;">チームを追加 ></mark> をクリックして右側に移動してから、<mark style="color:blue;">確認</mark> をクリックします。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-fddb445fbc27630d5fae88e377c8fc4b38b4443c%2Fteam-role-assignment-prod.png?alt=media" alt="選択済みチームの絞り込みと選択状態：架空のサンプルサポートチーム、全 1 件のうち 1 件を選択"><figcaption><p>右側の選択済みチーム一覧の絞り込みと選択状態</p></figcaption></figure>
{% endstep %}

{% step %}
新しく割り当てたチームは、デフォルトでは <mark style="color:blue;">使用</mark> のみが有効です。一覧に戻り、必要に応じてその他の権限を選択します。選択するとそのまま保存されるため、別途保存ボタンを押す必要はありません。

| 権限      | メンバーができること                                        |
| ------- | ------------------------------------------------- |
| 使用      | チームの会話プラットフォームを使用できます。チーム機能の権限もある場合は、チームページを開けます。 |
| 会話履歴の閲覧 | チームの会話と実行記録を閲覧できます。この権限がなくても、自分が開始した会話は閲覧できます。    |
| 編集      | チームのキャンバス、メンバーノード、エントリー設定を変更できます。                 |
| 削除      | チーム全体を削除できます。キャンバス上のノードや接続の削除は編集に含まれます。           |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-928d3aa4d3e6b0fd28329870f546cadf270228b7%2Fteam-role-permissions-prod.png?alt=media" alt="チームの割り当て一覧：サンプルサポートチームの使用、会話履歴の閲覧、編集、削除がすべて選択されています"><figcaption><p>同じチームの 4 種類の権限を、ロールごとに個別に付与できます</p></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
「会話履歴の閲覧」「編集」「削除」のいずれかを選択すると、「使用」も有効になります。「使用」を解除すると、残りの 3 項目も無効になります。メンバーが複数のロールに属する場合、チームの権限は各ロールの和集合になります。オーナーへの個別の割り当ては不要です。
{% endhint %}

ロールのメンバーにチームの作成を許可する場合は、<mark style="color:blue;">チームの新規作成を許可</mark> を選択します。メンバーには、チーム機能の権限と Agent Builder に対応したプランも必要です。新しいチームの権限は、作成者が属するカスタムロールに付与されるため、同じロールの他のメンバーもそのチームのすべての権限を取得します。カスタムロールがない場合は、管理者が別途割り当ててください。

新しく作成したロールでは、<mark style="color:blue;">チームの新規作成を許可</mark> はデフォルトでオフです。新しい組織のデフォルトロールも同様です。既存のロールは元の設定が維持され、変更されません。ロールをコピーすると、新しいロールはコピー元の選択状態を引き継ぎます。メンバーが属するロールのうち 1 つでもこの項目が選択されていれば、チームを作成できます。チームの作成を制限する場合は、デフォルトロールとそのメンバーの他のロールでも選択されていないことを確認してください。

例えば、管理者が「マーケティング企画」ロールを作成し、メンバーにチームの使用を許可しつつ、自分でチームを作成することはまだ許可しない場合です。ロールの作成後に <mark style="color:blue;">チームの割り当て</mark> に切り替えると、<mark style="color:blue;">チームの新規作成を許可</mark> はすでにオフになっているため、解除する操作は不要です。後で許可したくなった時点で、ここに戻って選択できます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-ce8e3c9d693ac72eee3620ce2412c9117d28c7c4%2Frole-permission-new-role-team-create-off.png?alt=media" alt="作成直後のロールのチームの割り当てタブ：チームの新規作成を許可はオフで、下部にはこのロールにチームがまだ割り当てられていないことが表示されています"><figcaption><p>新しく作成したロールでは、チームの新規作成を許可はデフォルトでオフです</p></figcaption></figure>

チームのエントリーアシスタントと会話プラットフォームには、チームの権限が一括で適用されます。「AI アシスタントの割り当て」や「会話プラットフォームの割り当て」で個別に設定する必要はありません。後者では、通常のプラットフォームの後にチームのプラットフォームが読み取り専用の行として表示され、<mark style="color:blue;">チームによる権限付与：チーム名</mark> と示されます。<mark style="color:blue;">チャネルタイプ</mark> 列には、通常のプラットフォームと同様に Web、内部、API などのタイプが表示されます。変更する場合は、<mark style="color:blue;">チームの割り当てに移動</mark> をクリックします。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-64ecdcda615d594e4f7350392dafdb75ce13dc62%2Frole-permission-team-inbox-access-types.png?alt=media" alt="会話プラットフォームの割り当てタブ：架空のサンプルサポートチームの 3 つの会話プラットフォームに、チームによる権限付与と表示され、チャネルタイプはそれぞれ Web、内部、API です"><figcaption><p>チームのプラットフォームの読み取り専用行には、実際のタイプに応じて Web、内部、API が表示されます</p></figcaption></figure>

***

## ナレッジベースの割り当て <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="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-a44e2516b06f0770bbb7b088f247663c32fa0556%2F%E6%88%AA%E5%9C%96%202025-12-10%20%E4%B8%8B%E5%8D%883.28.14.png?alt=media" alt="ナレッジベースの割り当てウィンドウ。左側は選択可能なナレッジベース、右側は選択済みのナレッジベースです"><figcaption></figcaption></figure>

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

追加すると、選択したナレッジベースが一覧に表示されます。複数ページのナレッジベースをまとめて選択する方法や、ウィンドウ内で割り当て済みのナレッジベースを削除する方法は、[割り当てウィンドウでの全選択と削除](#assign-picker-select-remove)をご覧ください。

**利用例：**

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

{% 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="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-ceca88e9a787a75b3815c78ad5a4b1bd656451d4%2F%E6%88%AA%E5%9C%96%202025-12-10%20%E4%B8%8B%E5%8D%883.28.49.png?alt=media" alt="会話プラットフォームの割り当てウィンドウ。AI アシスタントとチャネルタイプで絞り込み、選択済みのプラットフォームを確認できます"><figcaption></figcaption></figure>

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

追加すると、選択した会話プラットフォームが一覧に表示されます。左側の <mark style="color:blue;">全選択</mark> はすべてのページの項目を選択します。割り当て済みの会話プラットフォームをまとめて入れ替える場合も、同じウィンドウで削除してから新しいものを追加できます。[割り当てウィンドウでの全選択と削除](#assign-picker-select-remove)をご覧ください。

**利用例：**

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

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

***

## データベース、ツール、Agent UI ツールの割り当て <a href="#assign-databases-tools" id="assign-databases-tools"></a>

この 3 つのタブは同じレイアウトで、割り当てるリソースの種類だけが異なります。各タブには上から順に次の項目があります。

* **検索バー**：名前または ID を入力して割り当て済みの項目を絞り込みます。右側の <mark style="color:blue;">○○の割り当て</mark> ボタンで割り当てウィンドウを開きます。AI アシスタントの割り当てと同じように、左側で選択して右側に追加し、<mark style="color:blue;">確認</mark> をクリックします
* **○○の新規作成を許可** チェックボックス：選択すると、このロールのメンバーは対応するページで新しいデータベース／ツール／Agent UI ツールを作成できます。選択を解除すると、割り当てられた項目のみを使用できます。これは「作成権限」であり、下に並ぶ各リソースへのアクセス権限とは別のものです。詳しくは[組織とメンバー管理：ロールに含まれるもの](https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview.md#what-a-role-holds)をご覧ください
* **割り当て済み一覧**：各行で <mark style="color:blue;">読み取り</mark>、<mark style="color:blue;">編集</mark>、<mark style="color:blue;">削除</mark> を個別に選択でき、選択後すぐに反映されます。ヘッダーのチェックボックスで、現在のページの全行を一括で切り替えられます。右端の削除アイコンは、このロールからリソースの割り当てを解除するもので、リソース自体は削除しません

読み取り／編集／削除の 3 つの切り替えの意味は、[ロールのリソースアクセス権限](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/group-resource-access.md)と[ロールのリソース可視性制御](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/group-resource-visibility.md)をご覧ください。

### データベースの割り当て <a href="#assign-databases" id="assign-databases"></a>

このロールに表示する[データベース](https://docs.maiagent.ai/maiagent-user-guide/ja/build/database.md)と、新しいデータベースを作成できるかどうか（<mark style="color:blue;">データベースの新規作成を許可</mark>）を設定します。同じ設定をデータベース側から行うこともできます。データベースのグループ権限にロールを追加すると、両側に同じ関連付けが表示されます。[Agent の関連付けとグループ権限：グループ権限の管理](https://docs.maiagent.ai/maiagent-user-guide/ja/build/database/link-chatbots-groups.md#group-permission-management)をご覧ください。

### ツールの割り当て <a href="#assign-tools" id="assign-tools"></a>

このロールが[ツール](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools.md)ページで表示して Agent に追加できるツールと、新しいツールを作成できるかどうか（<mark style="color:blue;">ツールの新規作成を許可</mark>）を設定します。ツールページを表示するには、メンバーに <mark style="color:blue;">AI 機能権限</mark> 内の <mark style="color:blue;">ツール権限</mark> も必要です。どちらか一方でも欠けると、メンバーはツールを使用できません。

### Agent UI ツールの割り当て <a href="#assign-agent-ui-tools" id="assign-agent-ui-tools"></a>

このロールが使用できる [Agent UI](https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/agent-ui.md) ツールと、新しい Agent UI ツールを作成できるかどうか（<mark style="color:blue;">Agent UI ツールの新規作成を許可</mark>）を設定します。一覧には <mark style="color:blue;">ツールタイプ</mark> 列が追加されており、各ツールの種類を確認できます。Agent UI ページを表示するには、メンバーに <mark style="color:blue;">AI 機能権限</mark> 内の <mark style="color:blue;">Agent UI 権限</mark> も必要です。

{% hint style="info" %}
オーナーロールはすべてのデータベース、ツール、Agent UI ツールへのアクセス権限を自動的に持ちます。オーナーロールでは、この 3 つのタブは無効になります。
{% endhint %}

***

## 割り当てウィンドウでの絞り込みと公式組み込みアシスタントの非表示 <a href="#assign-picker-filters" id="assign-picker-filters"></a>

組織で公式組み込み Agent を有効にすると、各 Agent に Web、内部、API の 3 つの会話プラットフォームが自動的に用意されます。これらは、独自に作成した Agent や会話プラットフォームと同じ候補一覧に表示されます。<mark style="color:blue;">AI アシスタントの割り当て</mark> と <mark style="color:blue;">会話プラットフォームの割り当て</mark> の両ウィンドウの上部には <mark style="color:blue;">絞り込み</mark> バーがあり、左側の候補一覧を絞り込んでから選択できます。

**利用例：**

組織の管理者が「カスタマーサポート部」ロールに「顧客フィードバック分析」Agent のすべての会話プラットフォームを割り当てたいものの、候補一覧には数百のプラットフォームがあり、その多くが公式組み込み Agent によって自動的に用意されたものだとします。管理者は <mark style="color:blue;">会話プラットフォームの割り当て</mark> ウィンドウで <mark style="color:blue;">公式組み込みアシスタントを非表示</mark> を選択し、<mark style="color:blue;">すべての AI アシスタント</mark> ドロップダウンから「顧客フィードバック分析」を選びます。左側には、その Agent の Web、内部、API の 3 つのプラットフォームだけが残ります。<mark style="color:blue;">全選択</mark>、<mark style="color:blue;">会話プラットフォームを追加 ></mark>、<mark style="color:blue;">確認</mark> の順にクリックすれば、ページごとにプラットフォーム名を照合する必要はありません。

### 会話プラットフォームの割り当て：Agent とチャネルタイプによる絞り込み <a href="#filter-inbox-picker" id="filter-inbox-picker"></a>

<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概要</mark> → <mark style="color:blue;">管理操作</mark> → <mark style="color:blue;">ロール権限の編集</mark> → ロールの編集 → <mark style="color:blue;">会話プラットフォームの割り当て</mark> タブに進み、<mark style="color:blue;">会話プラットフォームの割り当て</mark> ボタンをクリックしてウィンドウを開きます。上部の <mark style="color:blue;">絞り込み</mark> バーには 3 つの条件があります。

| 絞り込み条件                                            | 動作                                                                                                                                  |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">すべての AI アシスタント</mark>   | Agent を選択すると、その Agent に関連付けられた会話プラットフォームだけが左側に表示されます。ドロップダウンでは名前を入力して検索できます                                                         |
| <mark style="color:blue;">すべてのチャネルタイプ</mark>      | 指定したチャネルタイプ（Web、LINE、Messenger など）の会話プラットフォームのみを表示します                                                                               |
| <mark style="color:blue;">公式組み込みアシスタントを非表示</mark> | 選択すると、公式組み込み Agent の会話プラットフォームがすべて左側から非表示になります。<mark style="color:blue;">すべての AI アシスタント</mark> ドロップダウンにも、組織が独自に作成した Agent のみが表示されます |

* 3 つの条件と、左側の <mark style="color:blue;">選択可能な会話プラットフォームを検索</mark> は同時に適用されます。いずれかの条件を変更すると、一覧は 1 ページ目に戻ります。
* 絞り込みは左側の <mark style="color:blue;">選択可能な会話プラットフォーム</mark> にのみ適用されます。右側の <mark style="color:blue;">選択済みの会話プラットフォーム</mark> は絞り込みの影響を受けず、すべて表示されます。
* 先に <mark style="color:blue;">すべての AI アシスタント</mark> で公式組み込み Agent を選び、その後 <mark style="color:blue;">公式組み込みアシスタントを非表示</mark> を選択すると、選択済みの Agent は自動的にクリアされ、独自に作成したすべての Agent の会話プラットフォームが一覧に表示されます。
* 絞り込み後に該当する項目がない場合は、「絞り込み条件に一致する項目はありません」と表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-0dc12a30f1924d28832a51cb4042a53f9db3814b%2Frole-permission-assign-inbox-filter.png?alt=media" alt="会話プラットフォームの割り当てウィンドウ：絞り込みバーで Agent を選択し、公式組み込みアシスタントを非表示を選択すると、左側にはその Agent の 3 つの会話プラットフォームだけが残ります"><figcaption><p>Agent を選択して公式組み込みアシスタントを非表示にすると、左側にはその Agent の Web、内部、API プラットフォームのみが表示されます</p></figcaption></figure>

### <mark style="color:blue;">AI アシスタントの割り当て</mark>：<mark style="color:blue;">公式組み込みアシスタントを非表示</mark> <a href="#filter-chatbot-picker" id="filter-chatbot-picker"></a>

<mark style="color:blue;">AI アシスタントの割り当て</mark> ウィンドウの候補は Agent 自体なので、絞り込みバーには <mark style="color:blue;">公式組み込みアシスタントを非表示</mark> チェックボックスのみがあります。

* **オフの場合**：公式組み込み Agent が独自に作成した Agent と一緒に表示されます。見分けやすいよう、右側に <mark style="color:blue;">公式組み込み</mark> ラベルが表示されます。
* **オンの場合**：左側の <mark style="color:blue;">選択可能な AI アシスタント</mark> には組織が独自に作成した Agent のみが表示され、総件数も更新されます。

<div><figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-7df42f539b5867b12ae6aac2d1b7d7e0417f71bc%2Frole-permission-assign-chatbot-builtin-tag.png?alt=media" alt="AI アシスタントの割り当てウィンドウ：メッセージ推敲を検索し、公式組み込みアシスタントを非表示はオフになっています"><figcaption><p>「公式組み込みアシスタントを非表示」がオフの場合の候補一覧です。図では、組織が独自に作成したアシスタントが 1 件見つかっています</p></figcaption></figure> <figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-0062b0ac45b31c1b109b64dada6c5b19100bd1c3%2Frole-permission-assign-chatbot-hide-builtin.png?alt=media" alt="AI アシスタントの割り当てウィンドウ：公式組み込みアシスタントを非表示をオンにしても、組織が独自に作成したメッセージ推敲アシスタントは検索結果に表示されています"><figcaption><p>オンにした後も、組織が独自に作成したアシスタントは候補一覧に残ります</p></figcaption></figure></div>

{% hint style="info" %}
**公式組み込みアシスタントを非表示にする際のルール**

* デフォルトではオフです。ウィンドウを閉じるかロールを切り替えると、両ウィンドウの絞り込み条件はリセットされます。
* 非表示にするのは、候補一覧の公式組み込み Agent だけです。ロールに割り当て済みの項目を削除したり、権限を変更したりすることはありません。
* 公式組み込み Agent の使用権限は、ロール権限ページでは設定しません。公式組み込み Agent の「公開対象」で設定してください。詳しくは[公式組み込み Agent の管理：公開対象の設定](https://docs.maiagent.ai/maiagent-user-guide/ja/org/management.md#group-permissions)をご覧ください。
  {% endhint %}

***

## 割り当てウィンドウでの全選択と削除 <a href="#assign-picker-select-remove" id="assign-picker-select-remove"></a>

ロール編集ページにある 9 つの割り当てウィンドウ、<mark style="color:blue;">メンバーの割り当て</mark>、<mark style="color:blue;">AI アシスタントの割り当て</mark>、<mark style="color:blue;">チームの割り当て</mark>、<mark style="color:blue;">ナレッジベースの割り当て</mark>、<mark style="color:blue;">データベースの割り当て</mark>、<mark style="color:blue;">ツールの割り当て</mark>、<mark style="color:blue;">Agent UI ツールの割り当て</mark>、<mark style="color:blue;">スキルの割り当て</mark>、<mark style="color:blue;">会話プラットフォームの割り当て</mark> は、いずれも左右 2 列の構成です。左側は選択可能な項目、右側はこのロールに割り当て済みの項目です。同じウィンドウ内でまとめて追加・削除でき、<mark style="color:blue;">確認</mark> をクリックして初めて反映されます。

**利用例：**

組織の管理者が「サポート第 2 チーム」ロールの担当する 30 個の会話プラットフォームを、新しく公開した Agent の会話プラットフォームにすべて入れ替える場合です。ロール編集ページで <mark style="color:blue;">会話プラットフォームの割り当て</mark> を開き、まず右側の <mark style="color:blue;">全選択</mark> を選択して <mark style="color:blue;">< 会話プラットフォームを削除</mark> をクリックします。既存の 30 個のプラットフォームは左側に戻り、<mark style="color:blue;">削除予定</mark> と表示されます。次に、上部の <mark style="color:blue;">すべての AI アシスタント</mark> ドロップダウンで新しい Agent を選び、左側の <mark style="color:blue;">全選択</mark> を選択して、複数ページにわたるプラットフォームを一度に選択し、<mark style="color:blue;">会話プラットフォームを追加 ></mark> をクリックします。ウィンドウ下部に「30 件を追加、30 件を削除予定」と表示されます。<mark style="color:blue;">確認</mark> をクリックし、確認ダイアログで削除対象の一覧を確認して <mark style="color:blue;">削除を確定</mark> をクリックすれば、一覧に戻って 1 行ずつ削除する必要はありません。

### 全選択の対象はすべてのページです <a href="#select-all-pages" id="select-all-pages"></a>

左側の一覧はページ分けされています。ヘッダーの <mark style="color:blue;">全選択</mark> を選択すると、他のページも含めて、**現在の検索語と絞り込み条件に一致するすべての項目**が選択されます。ヘッダーの右側には「N 件を選択済み」と表示されます。

* このロールにすでに割り当てられた項目は、左側でグレー表示になり、<mark style="color:blue;">割り当て済み</mark> と表示されます。選択できず、全選択の対象にも含まれません。今回追加したばかりで、まだ <mark style="color:blue;">確認</mark> をクリックしていない項目には、この表示は付きません。<mark style="color:blue;">メンバーの割り当て</mark> ウィンドウでは、この表示はありません。
* 左側に戻され、<mark style="color:blue;">削除予定</mark> と表示されている項目も選択対象に含まれます。再度追加して右側に戻すと、削除を取り消せます。
* 右側の <mark style="color:blue;">全選択</mark> は、右側の一覧のすべての項目を選択します。検索語を入力している場合は、一致する項目のみを選択します。
* <mark style="color:blue;">メンバーの割り当て</mark> ウィンドウでは、全選択は <mark style="color:blue;">すべてのメンバーを選択</mark> と表示され、ボタンは <mark style="color:blue;">追加 ></mark> と <mark style="color:blue;">< 削除</mark> です。使い方は同じです。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-3dd75823811aad2bb66ad0af08cdb9ac9a7a1d76%2Frole-permission-assign-assigned-tag.png?alt=media" alt="チームの割り当てウィンドウ：左側の架空のサンプルサポートチームはグレー表示で割り当て済みと示され、右側の選択済みチームにも同じチームが表示されています"><figcaption><p>ロールに割り当て済みの項目は、左側に「割り当て済み」と表示されます</p></figcaption></figure>

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-f72cbf7dd3e459f54b2487a8788f1a295c858100%2Frole-permission-assign-select-all.png?alt=media" alt="会話プラットフォームの割り当てウィンドウ：左側は全 85 件、9 ページで、全選択を選択すると 85 件を選択済みと表示されます"><figcaption><p>左側の全選択は、現在表示しているページだけでなく、すべてのページを対象にします</p></figcaption></figure>

### ウィンドウ内で割り当て済みの項目を削除する <a href="#remove-in-picker" id="remove-in-picker"></a>

1. 割り当てウィンドウを開きます。右側に、このロールに現在割り当てられている項目が表示されます。
2. 右側で削除する項目を選択し、中央の <mark style="color:blue;">< 削除</mark> ボタン（例：<mark style="color:blue;">< 会話プラットフォームを削除</mark>）をクリックします。項目は左側に戻り、<mark style="color:blue;">削除予定</mark> と表示されます。取り消す場合は、選択して右側に戻します。
3. 今回新しく追加した項目は、右側で <mark style="color:blue;">新規</mark> と表示されます。ウィンドウ下部の <mark style="color:blue;">確認</mark> の左に、「N 件を追加、N 件を削除予定」と表示されます。
4. <mark style="color:blue;">確認</mark> をクリックします。削除対象がある場合は、先に「このロールから N 個の○○を削除しますか？」という確認ダイアログが開き、削除する項目が 1 件ずつ表示されます。会話プラットフォームの場合は、チャネルタイプと所属する AI アシスタントも表示されます。<mark style="color:blue;">削除を確定</mark> をクリックすると実行されます。追加のみの場合は確認ダイアログは表示されず、そのまま保存されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-05aa96882d9dc8ea7ea1d5718a8c708266cd8c9a%2Frole-permission-assign-pending-remove.png?alt=media" alt="会話プラットフォームの割り当てウィンドウ：左側の 3 つの会話プラットフォームは削除予定、右側の 3 つは新規と表示され、下部には 3 件を追加、3 件を削除予定と表示されています"><figcaption><p>左側に戻した項目は「削除予定」と表示され、下部に今回の変更件数が表示されます</p></figcaption></figure>

{% hint style="info" %}

* 削除は、このロールとリソースの関連付けを解除するだけで、リソース自体は削除されません。後で再び割り当てることはできますが、読み取り、編集、削除などの権限設定はデフォルトに戻ります。
* <mark style="color:blue;">キャンセル</mark> をクリックするかウィンドウを閉じると、今回の追加と削除はすべて反映されません。
  {% endhint %}

### AI アシスタントを削除すると、会話プラットフォームも解除されます <a href="#remove-chatbot-inboxes" id="remove-chatbot-inboxes"></a>

AI アシスタントを割り当てると、そのアシスタントの会話プラットフォームもロールに割り当てられます。AI アシスタントを削除すると、これらの会話プラットフォームもロールから解除され、<mark style="color:blue;">会話プラットフォームの割り当て</mark> で調整した設定も含まれます。確認ダイアログでは、各アシスタントの下に、あわせて解除される会話プラットフォームが表示されます。削除後に <mark style="color:blue;">会話プラットフォームの割り当て</mark> タブに切り替えると、一覧が自動的に更新されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-76ccbae6cf2efb9d985594e60e4dac5fe652983a%2Frole-permission-assign-chatbot-remove-confirm.png?alt=media" alt="確認ダイアログ：このロールから 1 個の AI アシスタントを削除する際、その会話プラットフォームも解除されることが説明され、アシスタントに属する 3 つの会話プラットフォームが表示されています"><figcaption><p>AI アシスタントを削除する前に、確認ダイアログであわせて解除される会話プラットフォームを確認できます</p></figcaption></figure>

***

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

デフォルトロールは、組織の作成時にすべてのユーザーの基本ロールとして自動的に生成されます。ユーザーのロール設定を適用する際、特別な割り当てがない場合は、デフォルトロールのすべての権限設定が自動的に適用されます。

> デフォルトロールの権限が他のロールの設定を上書きしないよう、デフォルトロールは最小限の権限レベルに設定することをお勧めします

***

## 権限の処理 <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 つのロールの権限だけでなく、すべてのロールの権限の和集合が付与されます。
{% endhint %}

**例：**

```
メンバー B は次のロールを持っています：
├─ カスタマーサポートロール：Agent マーケットプレイス権限 + すべての会話の権限
└─ マーケティングロール：AI 機能の権限（AI アシスタント）+ すべての会話の権限

→ メンバー B の有効な権限：Agent マーケットプレイス権限 + すべての会話の権限 + AI アシスタント権限
   （重複する権限は加算されず、1 回だけ数えられます）
```

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

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

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

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

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

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

**メンバーの権限を減らすには、次のいずれかを行います：**

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

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

**状況：**

* デフォルトロールには 3 つの Agent が関連付けられています
* カスタムロールには 2 つの Agent だけが関連付けられています

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

{% hint style="info" %}
そのため、他のロールの権限制御に影響しないよう、デフォルトロールの権限を最小限に設定することをお勧めします。
{% endhint %}

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

ユーザーをロールから削除すると、次のようになります。

* **カスタムロールの削除**：そのロール固有の権限を失い、他のロールの権限は維持されます
* **デフォルトロールは削除できません**：すべてのユーザーは常にデフォルトロールに所属します
* **権限の確認**：システムがユーザーの有効な権限を再計算します

**例：**

```
メンバー A の元の権限：Agent マーケットプレイス + AI 機能 + カスタマーサポートの会話
                ↓
「AI 機能開発」ロールを削除します
                ↓
メンバー A の有効な権限：Agent マーケットプレイス + カスタマーサポートの会話
```

***

## 権限がないメンバーに表示される内容 <a href="#what-members-see-without-permission" id="what-members-see-without-permission"></a>

ロールに機能の権限がない場合、左側のメニューや一部の一覧のアイコンにその機能は表示されません。メンバーがリンク、ブックマーク、または他のページのリンクからそのページを開くと、権限がないことを示す説明が表示され、組織の管理者に申請するよう案内されます。

### 権限がない機能への入口を非表示にする <a href="#hidden-entries" id="hidden-entries"></a>

左側のメニューにロールの権限がある機能だけを表示するほか、一部の一覧の操作列にある、他の機能ページへ移動するアイコンも権限に応じて表示されます。たとえば、<mark style="color:blue;">会話プラットフォーム</mark> 一覧の分析アイコン（マウスポインターを合わせると「会話プラットフォーム分析」と表示されます）は、ロールに <mark style="color:blue;">会話プラットフォーム分析権限</mark> がない場合は表示されず、操作列には編集と削除だけが残ります。クリックして初めてアクセスできないと気付くことがなくなります。他のページのリンクは引き続き表示される場合があり、クリックすると以下の権限がないことを示す画面が表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-6f522065555c8d28133dd8c0e4f33b3f7f1bede9%2Finbox-analysis-icon-by-permission.png?alt=media" alt="会話プラットフォーム一覧の操作列の比較：上は会話プラットフォーム分析権限があるロールで、各行に編集、分析、削除の 3 つのアイコンがあります。下は権限がないロールで、各行に編集と削除だけがあります"><figcaption><p>同じ会話プラットフォームでも、会話プラットフォーム分析権限がないロールには分析アイコンが表示されません</p></figcaption></figure>

### 会話プラットフォーム権限がない場合 <a href="#without-inbox-permission" id="without-inbox-permission"></a>

会話プラットフォームの設定ページには、<mark style="color:blue;">カスタマーサポートの会話の権限</mark> 配下の <mark style="color:blue;">会話プラットフォーム権限</mark> が必要です。ロールでこの項目を選択していない場合、Agent を編集できても、会話プラットフォーム設定への入口は権限に応じて調整されるため、クリックしてから 403 が表示されることはありません。

| 場所                                                                                                                                           | 会話プラットフォーム権限がない場合                                                                                                                                                                                                                                                                                                                                           |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">AI 機能</mark> → <mark style="color:blue;">AI アシスタント</mark> → Agent の <mark style="color:blue;">会話プラットフォーム</mark> タブ | <mark style="color:blue;">プラットフォーム設定</mark> と <mark style="color:blue;">チャネル接続</mark> ボタンが無効になります。マウスポインターを合わせると「会話プラットフォーム設定を開くには『カスタマーサポートの会話 → 会話プラットフォーム』権限が必要です。管理者にお問い合わせください」と表示されます。<mark style="color:blue;">会話へ移動</mark>、<mark style="color:blue;">埋め込みコード</mark> は引き続き利用できます                                                                     |
| 左側のメニューの <mark style="color:blue;">カスタマーサポートの会話</mark>                                                                                       | <mark style="color:blue;">会話プラットフォーム</mark> が表示されません。ロールに <mark style="color:blue;">会話プラットフォーム分析権限</mark> があれば、会話プラットフォーム分析ページはリンクから直接開けます                                                                                                                                                                                                                  |
| 左側のメニューの <mark style="color:blue;">カスタマーサポートの会話</mark> グループ                                                                                  | カスタマーサポートの会話配下で <mark style="color:blue;">会話プラットフォーム分析権限</mark> だけを選択している場合、<mark style="color:blue;">カスタマーサポートの会話</mark> グループ全体が非表示になり、開いても空のグループは残りません                                                                                                                                                                                                    |
| 他のページにある会話プラットフォーム設定への入口                                                                                                                     | チームを開いた後、左側の <mark style="color:blue;">会話プラットフォーム</mark> 一覧の各行の歯車アイコンと、会話タグメニューの <mark style="color:blue;">タグ管理</mark> リンクは表示されません。<mark style="color:blue;">Credits</mark> → <mark style="color:blue;">クォータ割り当て</mark> → <mark style="color:blue;">会話プラットフォームのクォータ</mark> テーブルのプラットフォーム名、および AgentOps 評価記録の会話プラットフォーム ID は文字だけが表示され、クリックして設定ページを開くことはできません |

会話プラットフォーム権限を持つメンバーには、上記の画面の変更はありません。<mark style="color:blue;">チャネル接続</mark> を利用するには、さらにその Agent を編集できることと、ロールで <mark style="color:blue;">会話プラットフォームの追加を許可</mark> が有効になっていることが必要です。3 つの条件をすべて満たす必要があります。

{% hint style="info" %}
**利用例：Agent の調整のみを行い、会話プラットフォーム設定を扱わない AI アシスタント管理者**

組織の管理者は「AI アシスタント管理者」に Agent の設定を調整させつつ、LINE や Web サイトなどの会話プラットフォーム設定はカスタマーサポート責任者だけに任せたいと考えています。ロール権限で <mark style="color:blue;">AI 機能の権限</mark> 配下の <mark style="color:blue;">AI アシスタント権限</mark> を選択し、カスタマーサポートの会話の <mark style="color:blue;">会話プラットフォーム権限</mark> は選択せず、<mark style="color:blue;">保存</mark> をクリックします。このロールのメンバーが Agent の <mark style="color:blue;">会話プラットフォーム</mark> タブを開くと、<mark style="color:blue;">会話へ移動</mark> と <mark style="color:blue;">埋め込みコード</mark> は利用できます。<mark style="color:blue;">プラットフォーム設定</mark> と <mark style="color:blue;">チャネル接続</mark> は無効で、マウスポインターを合わせると管理者への権限申請が必要だと分かります。左側のメニューにも、開く権限がない <mark style="color:blue;">会話プラットフォーム</mark> は表示されません。
{% endhint %}

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-c1aef39f472dffd51a784596621bac65605d7135%2Frole-permission-no-inbox-permission.png?alt=media" alt="ロール権限のカスタマーサポートの会話の権限セクション：会話プラットフォーム分析権限だけが選択され、会話プラットフォーム権限、すべての会話の権限、他のユーザーへの会話転送権限、連絡先権限はいずれも未選択です"><figcaption><p>カスタマーサポートの会話で会話プラットフォーム分析権限だけを選択し、会話プラットフォーム権限を選択していないロールです</p></figcaption></figure>

### 権限がないページを直接開いた場合 <a href="#no-permission-page" id="no-permission-page"></a>

メンバーが同僚から共有されたリンク、ブックマーク、または URL の直接入力で、存在するものの所属ロールに権限がないページを開くと、**403** と「申し訳ありません。このページを表示する権限がありません。組織の管理者に対応するロール権限を申請してください」というメッセージが表示されます。URL はメンバーが開いたもののままなので、そのまま管理者に転送できます。<mark style="color:blue;">ホームに戻る</mark> をクリックすると、ホームページに戻れます。

ログイン前にこのようなリンクをクリックした場合も、ログイン後には同じ画面が表示され、ホームページに直接戻されることはありません。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-fecec1a9ae5e77b7bc19c912296f114534fe2aeb%2Frole-permission-page-denied-403.png?alt=media" alt="403 画面に「申し訳ありません。このページを表示する権限がありません。組織の管理者に対応するロール権限を申請してください」と表示され、その下にホームに戻るボタンがあります"><figcaption><p>ロールに権限がないページでは、403 と申請方法の説明が表示されます</p></figcaption></figure>

以下の 2 つの場合は引き続き **404**（「申し訳ありません。アクセスしたページは存在しません」）が表示され、ロール権限の調整では解決できません。

* URL が間違っている、またはページが存在しません
* 組織でその機能がまだ有効になっていません

### 権限を申請する <a href="#request-permission" id="request-permission"></a>

1. メンバーは 403 が表示されたページの URL を組織の管理者に送り、利用したい機能を伝えます
2. 管理者は [権限構造の概要](#permission-structure-overview) でそのページに必要な権限を確認し、[ロール権限の編集](#edit-role-permissions) に従ってメンバーの所属ロールで選択して保存します。または、すでに権限を持つロールにメンバーを [割り当てます](#assign-members)
3. メンバーはページを再読み込みするとアクセスでき、再ログインは不要です

{% hint style="info" %}
**利用例：カスタマーサポート担当者が会話プラットフォーム分析の閲覧を申請する場合**

カスタマーサポート担当の美咲さんが所属する「カスタマーサポート担当者」ロールには、<mark style="color:blue;">会話プラットフォーム権限</mark> しかありません。<mark style="color:blue;">会話プラットフォーム</mark> 一覧には分析アイコンが表示されません。上司から会話プラットフォームの分析ページのリンクを受け取り、開くと 403「このページを表示する権限がありません」が表示されます。美咲さんがリンクを組織の管理者に転送すると、管理者は「カスタマーサポート担当者」ロールの <mark style="color:blue;">カスタマーサポートの会話の権限</mark> 配下にある <mark style="color:blue;">会話プラットフォーム分析権限</mark> を選択して保存します。美咲さんがページを再読み込みすると、その会話プラットフォームの分析内容を閲覧できます。
{% endhint %}

***

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

### よくある問題：ユーザーに想定した機能が表示されない、または想定以上の機能を利用できる <a href="#faq-user-cannot-see-expected-features" id="faq-user-cannot-see-expected-features"></a>

1. ユーザーが所属するすべてのロールを確認し、デフォルトロールを含めて権限を過剰に付与していないか確認します。メンバー一覧の [有効な権限を表示](https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview/member.md#effective-permissions) から、各権限がどのロールに由来するかを直接確認することもできます
2. ブラウザーのキャッシュを削除し、再ログインするようユーザーに依頼します
3. 特定の Agent、または Agent マーケットプレイスの Agent が表示されない場合は、[権限を設定してもメンバーに Agent が表示されない場合](#faq-member-cannot-see-agent) のチェックリストを順番に確認します
4. ログイン後にページ全体に「アクセス権限がありません」と表示される場合、所属ロールで機能が 1 つも有効になっていません。機能権限があるロールに追加するか、そのロールで少なくとも 1 つの機能を有効にしてから、そのページの <mark style="color:blue;">権限を再確認</mark> をクリックするよう依頼します。詳しくは [プラットフォームへのログイン方法：ログイン後に「アクセス権限がありません」ページが表示される場合](https://docs.maiagent.ai/maiagent-user-guide/ja/start/login.md#faq-no-access) を参照してください
5. 特定のページを開いた際に 403「申し訳ありません。このページを表示する権限がありません」と表示される場合、そのページは存在しますが、ロールに対応する権限がありません。対処方法は [権限がないメンバーに表示される内容](#what-members-see-without-permission) を参照してください

### 権限監査の推奨事項 <a href="#permission-audit-recommendations" id="permission-audit-recommendations"></a>

* ユーザーへのロール割り当てが適切か、定期的に確認してください
* 退職したメンバーのロール割り当てをすべて削除してください

***

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

### Q：権限を設定してもメンバーに Agent が表示されない場合はどうすればよいですか？ <a href="#faq-member-cannot-see-agent" id="faq-member-cannot-see-agent"></a>

まず、メンバーがどこで見つけられないのかを確認してください。表示場所によって、決定する設定が異なります。

| メンバーが見つけられない場所                                                                                | 表示を決定する設定                                                                                                                                         |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| 左側のメニューに <mark style="color:blue;">Agent マーケットプレイス</mark> がありません                              | ロールの <mark style="color:blue;">Agent マーケットプレイス権限</mark>                                                                                           |
| <mark style="color:blue;">Agent マーケットプレイス</mark> の <mark style="color:blue;">組織で作成</mark> タブ  | <mark style="color:blue;">会話プラットフォームの割り当て</mark> での、この Agent の「内部」会話プラットフォームと <mark style="color:blue;">読み取り</mark>                               |
| <mark style="color:blue;">Agent マーケットプレイス</mark> の <mark style="color:blue;">公式組み込み</mark> タブ | 公式組み込み Agent の公開対象（ロール権限ページでは設定しません）                                                                                                              |
| Agent Builder の Agent 一覧                                                                      | <mark style="color:blue;">AI アシスタント権限</mark> と、<mark style="color:blue;">AI アシスタントの割り当て</mark> でのこの Agent の <mark style="color:blue;">読み取り</mark> |

次の順序で、項目を 1 つずつ確認してください。

1. **オーナーではなく、メンバーのアカウントで確認します**：オーナーロールはすべてのリソースに自動的にアクセスできます。オーナーに表示されるからといって、メンバーにも表示されるとは限りません。
2. **メンバーに&#x20;**<mark style="color:blue;">**Agent マーケットプレイス権限**</mark>**&#x20;があります**：組織の作成時、デフォルトロールではこの権限が選択されています。選択が解除され、他のロールでも選択されていない場合、左側のメニューに <mark style="color:blue;">Agent マーケットプレイス</mark> は表示されません。
3. **この Agent の「内部」会話プラットフォームが割り当てられ、**<mark style="color:blue;">**読み取り**</mark>**&#x20;が選択されています**：<mark style="color:blue;">組織で作成</mark> タブには、メンバーが読み取れる「内部」会話プラットフォームが表示されます。Agent だけを割り当て、会話プラットフォームを割り当てていない場合、マーケットプレイスにこの Agent は表示されません。<mark style="color:blue;">会話プラットフォームの割り当て</mark> ウィンドウで <mark style="color:blue;">すべての AI アシスタント</mark> を使ってこの Agent に絞り込むと、Web、内部、API の 3 つのプラットフォームを見つけられます（[Agent とチャネルタイプによる絞り込み](#filter-inbox-picker) を参照してください）。<mark style="color:blue;">読み取り</mark> の効果については、[ロールのリソース表示制御](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/group-resource-visibility.md#read-permission-visibility) を参照してください。
   * Agent の作成時に選択したロール、およびロールの <mark style="color:blue;">AI アシスタントの割り当て</mark> で Agent を追加した場合は、その Agent の会話プラットフォームも同じロールに割り当てられます。
   * Agent 設定ページの <mark style="color:blue;">権限設定</mark> でロールを追加した場合、Agent 自体だけが割り当てられ、会話プラットフォームは割り当てられません。<mark style="color:blue;">会話プラットフォームの割り当て</mark> で追加してください。
4. **同じロールに、この Agent と&#x20;**<mark style="color:blue;">**Agent マーケットプレイス権限**</mark>**&#x20;の両方があります**：会話プラットフォームだけを割り当てた場合、メンバーは Agent を表示して会話を始められますが、会話の名前変更、削除、ピン留めなどの操作は拒否されます。これらの操作では、メンバーが所属するロールのうち、<mark style="color:blue;">Agent マーケットプレイス権限</mark>（または <mark style="color:blue;">カスタマーサポートの会話の権限</mark> 配下の権限）が選択され、かつこの Agent が割り当てられているロールがあるかを確認します。権限がロール A、Agent がロール B にある場合は認められません。
5. **デフォルトロールへの割り当てを確認します**：デフォルトロールはすべてのメンバーに自動的に適用されるため、デフォルトロールに割り当てられた Agent と会話プラットフォームは全メンバーに表示されます。Agent の作成時、<mark style="color:blue;">権限設定</mark> ではデフォルトロール以外のすべてのロールが初期選択されます。<mark style="color:blue;">すべてのロール</mark> を選択すると、デフォルトロールにも割り当てられます。
6. **Agent Teams ではチームの入口 Agent を割り当てます**：チームを作成すると、チームと同じ名前の入口 Agent が作成されますが、どのロールにも割り当てられません。ロールの <mark style="color:blue;">AI アシスタントの割り当て</mark> でこの入口 Agent を追加してください（会話プラットフォームもあわせて割り当てられます）。これにより、メンバーの <mark style="color:blue;">組織で作成</mark> タブにチームが表示され、チームの会話の名前変更や削除もできるようになります。
7. **この Agent の「内部」会話プラットフォームが有効です**：プラットフォームの [機能設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/function-settings.md#basic-functions) で <mark style="color:blue;">有効にする</mark> がオフの場合、マーケットプレイスに表示されません。
8. **メンバーにページの再読み込みを依頼します**：権限や割り当ての変更は、メンバーがページを再読み込みするか、開き直すと適用されます。

{% hint style="info" %} <mark style="color:blue;">組織で作成</mark> タブの詳しい表示条件は、[公式組み込み Agent とは：組織で作成タブにはどの Agent が表示されますか](https://docs.maiagent.ai/maiagent-user-guide/ja/work/built-in-agents.md#self-built-tab-conditions) を参照してください。公式組み込み Agent の利用権限は公開対象の設定で管理します。[公開対象の設定](https://docs.maiagent.ai/maiagent-user-guide/ja/org/management.md#group-permissions) を参照してください。
{% endhint %}

### Q：新しいメンバーにさらに多くの権限を付与するにはどうすればよいですか？ <a href="#faq-grant-more-permissions" id="faq-grant-more-permissions"></a>

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

* **個別のメンバー**：メンバー一覧で対象のメンバーをクリックし、手動でロールを追加します
* **一括割り当て**：[メンバー管理：メンバーと権限の一括管理](https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview/member.md#batch-member-permission-management) 機能を使い、Excel で複数のメンバーに一度にロールを割り当てます
* **EIP の自動同期**：EIP ログインを利用している場合は、EIP 側でロールを設定すると、ログイン時に自動同期されます（[外部サービスによるログイン（SSO）](https://docs.maiagent.ai/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：オーナーロールに Agent、ナレッジベース、会話プラットフォームを割り当てられないのはなぜですか？ <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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-permission.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
