ロール権限管理
ロールの概念
ロール(Role)は組織内の機能単位であり、メンバー構成を自由に設定できます。
ロールに割り当てるメンバーは、組織内の任意のメンバーから選べます
1 人のメンバーが複数のロールを同時に継承でき、柔軟な権限管理を実現します
各ロールは独立した権限設定を持ち、さまざまなシーンのニーズに対応しやすくなっています
ロールタイプの説明
MaiAgent プラットフォームのロールは 3 つのタイプに分かれています。
オーナーロール (Owner Role)
**定義:**組織の作成者が自動的に取得する最高権限のロールです。
特徴:
すべてのリソースへの完全なアクセス権限を持ち、追加の割り当ては不要です
ロール、メンバー、権限を含む組織内のすべての設定を管理できます
組織には複数のオーナーを設定できます
オーナーロールを他のメンバーに割り当てたり、メンバーから削除したりできます
オーナーロールは最高権限を持つため、慎重に指定してください。システム全体の管理を本当に必要とする担当者のみが担当することをおすすめします。
デフォルトロール (Default Role)
**定義:**すべての組織メンバーが自動的に保有する基礎ロールで、メンバーが他のロールを割り当てられる前から基本的な権限を利用できるようにします。
特徴:
すべての組織メンバーが、デフォルトロールの権限を自動的に取得します
最も基本的なプラットフォームへのアクセス権限(問い合わせ機能など)を提供します
Excel による一括割り当てはできません
管理者はデフォルトロールの権限範囲をカスタマイズできます
メンバーを手動で割り当てることはできません(システムがすべてのメンバーに自動的に割り当てます)
推奨設定:
デフォルトロールには「最低限」の権限のみを与え、新しいメンバーの誤操作を防いでください。その他の権限は「カスタムロール」で割り当てます。
カスタムロール (Custom Role)
**定義:**管理者が手動または一括で特定のメンバーに割り当てるロールです。
特徴:
管理者が能動的に割り当てる必要があります
異なる職責に応じて、異なる権限の組み合わせを設定できます
一括割り当てに対応しており、大量のメンバー管理に便利です
割り当て後、メンバーはすぐに対応する権限を取得します
権限の計算方法:
例の説明:
メンバー A が「カスタマーサポート部」ロールに割り当てられる → 問い合わせ権限 + 対話権限を取得
メンバー A がさらに「テストチーム」ロールに割り当てられる → さらに AgentOps 権限が追加される
最終的にメンバー A が持つ権限:デフォルト権限 + カスタマーサポート部権限 + テストチーム権限
ロール権限の編集
該当する組織の下で、「ロール権限の編集」をクリックすると、そのロールのメンバーに権限を設定できます。

ロール権限ページでは、以下の操作ができます。
ロールの追加:組織にロール(例:マーケティング部門)を作成します。新しいメンバーが参加する際にロールを適用すれば、対応する権限を自動的に取得できます
ロールの編集:ロール名、説明、所属部門などの基本情報を変更します
ロール権限:ロールが使用できる機能モジュールと操作範囲を設定します
メンバーの割り当て:組織メンバーを指定したロールに追加し、権限設定を一元管理します
AI アシスタントの割り当て:ロールが操作できる AI アシスタントを割り当てます
ナレッジベースの割り当て:ロールがアクセスできるナレッジベースを割り当てます
対話プラットフォームの割り当て:ロールが使用できる対話プラットフォームを割り当てます
ロールの削除:使用しなくなったロールを削除し、組織の権限構造を整然と保ちます
一括機能:Excel で組織にメンバーを一括追加したり、メンバーにロールを一括割り当てしたりします(詳しくは メンバー管理:メンバーと権限の一括管理 をご覧ください)

権限の階層
MaiAgent は階層型の権限構造を採用しており、権限は主権限と子権限に分かれています。
権限構造の概要
MaiGPT 権限
-
MaiGPT 機能を使用できるかどうかを制御します
AI 機能権限
AI アシスタント権限
「AI アシスタント」タブの閲覧と操作を制御します
ナレッジベース権限
「ナレッジベース」タブの閲覧と操作を制御します
クローラー権限
クローラー機能の使用を制御します
ツール権限
ツール管理機能の使用を制御します
AgentOps 権限
テストセット権限
テストセット機能の閲覧と操作を制御します
自動テスト権限
自動テスト機能の使用を制御します
カスタマーサポート対話権限
すべての対話権限
「すべての対話」タブの閲覧と操作を制御します
対話プラットフォーム権限
「対話プラットフォーム」タブの閲覧と操作を制御します
連絡先権限
連絡先管理機能の使用を制御します
Agent マーケットプレイス権限
-
「Agent マーケットプレイス」タブの閲覧と操作を制御します
AI Gateway 権限
-
左側メニューに AI Gateway を表示するかどうか、およびメンバーが関連ページにアクセスできるかどうかを制御します
会議記録権限
リアルタイム文字起こし権限
新しい会議を作成して録音を開始できるかどうかを制御します
会議一覧権限
会議一覧や詳細の閲覧、およびダウンロードができるかどうかを制御します
会議記録管理権限
-
閲覧できる会議記録の範囲を制御します。チェックを入れていない場合は自分が参加した会議のみ、チェックを入れた場合は組織内のすべての会議を閲覧できます(詳しくは 会議アクセス権限をご覧ください)
開発者権限
API 呼び出し履歴権限
API 呼び出し履歴の閲覧を制御します
組織権限
組織概要権限
組織概要ページの閲覧を制御します
アクティビティログ権限
アクティビティログ機能の閲覧を制御します
権限設定の説明
ロールを追加して権限を割り当てる
右上の「ロールの追加」をクリックすると、新しいロールの名前を入力し、そのロールが保有できる権限にチェックを入れられます。

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

ロールの定義に応じて、組織メンバーが左側メニューの関連する機能タブを閲覧または使用できるかどうかを決められます。チェックボックスで各権限を有効/無効にし、右下の「保存」ボタンをクリックして設定を適用します。
指定したロールで AI Gateway を使用できるようにする
社内でモデル管理者だけが AI Gateway を閲覧する必要がある場合は、その管理者が所属するロールにのみ権限を付与できます。
組織設定に移動し、ロール権限を開きます。
ロールを追加する場合は、ロールの追加をクリックしてロール名を入力します。既存のロールのロール権限を直接編集することもできます。
AI Gateway 権限(AI Gateway Permission)にチェックを入れ、確認をクリックします。英語版の画面では、ボタンにOKと表示されます。
モデル管理者をこのロールに割り当てます。メンバーが管理画面に再度アクセスすると、左側メニューに AI Gateway が表示されます。この権限を持たないメンバーにはメニューが表示されず、関連ページにも直接アクセスできません。また、AI Gateway API リクエストもシステムによって拒否されます。



権限の利用シーン
企業が MaiAgent でカスタマーサポートシステムを構築する場合を想定します。
シーン 1:新人カスタマーサポート担当者
「問い合わせ権限」のみを付与します。
理由:入社したばかりで、製品知識と会社の方針を素早く学ぶ必要があるためです
回避できる問題:不慣れな状態のカスタマーサポート担当者が、誤って顧客の対話記録を削除したり、重要な AI アシスタントの設定を変更したりするのを防ぎます
シーン 2:ベテランカスタマーサポート
「問い合わせ権限」+「カスタマーサポート対話権限(すべての対話)」
理由:経験が豊富で、複雑なクレーム対応や新人指導をサポートする必要があるためです
回避できる問題:それでも AI 機能権限は付与せず、カスタマーサポート担当者が誤って AI アシスタントの設定を変更し、すべての顧客が誤った回答を受け取る事態を防ぎます
シーン 3:AI アシスタント管理者
「AI 機能権限」+「AgentOps 権限」
理由:AI アシスタントの回答品質の管理と最適化を担当するためです
回避できる問題:カスタマーサポート対話権限は付与せず、顧客のプライバシーデータに触れないようにします
メンバーの割り当て
作成したロールを、組織内のメンバーに割り当てることができます。
メンバー割り当てページに入ります
「+メンバーの割り当て」ボタンをクリックします

追加したいメンバーを選択し、中央の「追加 >」ボタンをクリックします
最後に右下の「確認」ボタンをクリックして設定を完了します



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

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


このようにすることで、そのメンバーは AI アシスタント機能のみを使用でき、その他の変更はできなくなります。
AI アシスタントの割り当て
ロールが使用できる AI アシスタントを制限し、ナレッジベースのデータをロール権限に応じて確実に分けて使用できます。
「AI アシスタントの割り当て」ページに入ります
「+AI アシスタントの割り当て」ボタンをクリックします

追加したい AI アシスタントを選択し、中央の「追加 >」ボタンをクリックします
最後に右下の「確認」ボタンをクリックして設定を完了します



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

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

ナレッジベースの割り当て
ロールがアクセスできるナレッジベースを制限し、機密データに特定のロールのみがアクセスできるようにします。
「ナレッジベースの割り当て」ページに入ります
「+ナレッジベースの割り当て」ボタンをクリックします

追加したいナレッジベースを選択し、中央の「追加 >」ボタンをクリックします
最後に右下の「確認」ボタンをクリックして設定を完了します
追加後、先ほど選択したナレッジベースがリストに表示されます。
利用シーン:
研究開発部門:技術文書のナレッジベースのみにアクセスできます
営業部門:製品説明と見積もりのナレッジベースのみにアクセスできます
人事部門:従業員ハンドブックのナレッジベースのみにアクセスできます
対話プラットフォームの割り当て
ロールが使用できる対話プラットフォームを制限し、チームごとに異なるカスタマーサポートチャネルを担当させることができます。
「対話プラットフォームの割り当て」ページに入ります
「+対話プラットフォームの割り当て」ボタンをクリックします

追加したい対話プラットフォームを選択し、中央の「追加 >」ボタンをクリックします
最後に右下の「確認」ボタンをクリックして設定を完了します
追加後、先ほど選択した対話プラットフォームがリストに表示されます。
利用シーン:
LINE カスタマーサポートチーム:LINE 対話プラットフォームのみにアクセスできます
ウェブサイトカスタマーサポートチーム:Web Chat 対話プラットフォームのみにアクセスできます
VIP カスタマーサポートチーム:すべての対話プラットフォームにアクセスできます
デフォルトロール

デフォルトロールは組織の作成時に自動生成され、すべてのユーザーの基礎ロールとなります。ユーザーロールの内容を適用する際に特別な指定がなければ、システムはデフォルトロール内のすべての権限設定を自動的に適用します。
デフォルトロールの権限設定は最も低い権限レベルにすることをおすすめします。これにより、他のロールの設定がデフォルトロールに上書きされるのを防げます。
権限の処理
ユーザーが複数のロールに同時に割り当てられている場合、MaiAgent は以下の権限処理ロジックを採用します。
権限の和集合の原則 (Union Principle)
**「最大権限」戦略を採用:**ユーザーはすべてのロールの権限の和集合を取得します。つまり、最も広範な操作権限を保有します。
例の説明:

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

デフォルトロール(自動割り当て)
組織の作成時に自動生成されます
すべてのユーザーがデフォルトロール権限を自動的に適用されます
カスタムロール(割り当て順)
後から割り当てられたロールは、既存の権限と統合されます
既存の権限を上書きせず、追加するのみです
重要なポイント:
後から割り当てられたロールは、既存の権限を「上書きしません」
「追加」されるのみです
新しいロールを割り当てることで権限を「減らす」ことはできません
誰かの権限を減らしたい場合は、以下のいずれかが必要です:
そのロールから該当するメンバーを削除する、または
ロール自体の権限設定を変更する
ロールの和集合の例
シーンの説明:
デフォルトロールが 3 つの AI アシスタントに関連付けられている
カスタムロールが 2 つの AI アシスタントのみに関連付けられている


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

権限の削除
ユーザーがロールから削除されたとき:
カスタムロールの削除:そのロール固有の権限を失いますが、他のロールの権限は保持されます
デフォルトロールは削除不可:すべてのユーザーは常にデフォルトロールに属します
権限チェック:システムはユーザーの有効な権限を再計算します
例の説明:
トラブルシューティング
よくある問題:ユーザーが期待した機能を表示できない、または期待を超える機能を使用できる
ユーザーが属するすべてのロール(デフォルトロールを含む)で、権限を過剰に開放していないか確認します
ユーザーにブラウザのキャッシュをクリアし、再ログインしてもらいます
権限レビューの推奨事項
ユーザーのロール割り当てが妥当かどうかを定期的に見直します
退職したメンバーのすべてのロール割り当てを削除します
よくある質問
Q:新しいメンバーにより多くの権限を持たせるには?
管理者は以下の方法でメンバーに追加のロールを割り当てられます。
単一メンバー:メンバーリストでそのメンバーをクリックし、手動でロールを追加します
一括割り当て:メンバー管理:メンバーと権限の一括管理 機能を使用し、Excel で一度に複数人にロールを割り当てます
EIP 自動同期:EIP ログインを使用している場合、EIP 側でロールを設定すれば、ログイン時に自動的に同期されます(サードパーティログイン(SSO))
Q:なぜデフォルトロールは Excel で一括割り当てできないのですか?
デフォルトロールはすべてのメンバーが自動的に保有する基礎ロールであり、システムが各メンバーに自動的に割り当てます。そのため、Excel による割り当ては不要であり、許可もされていません。
Q:なぜオーナーロールには AI アシスタント、ナレッジベース、対話プラットフォームを割り当てられないのですか?
オーナーロールはすべてのリソースへの完全なアクセス権限を持つため、追加の割り当ては不要です。システムが自動的にオーナーロールに組織内のすべてのリソースへのアクセスを許可します。
Q:権限の階層構造とはどういう意味ですか?
MaiAgent の権限は親子の階層構造を採用しています。たとえば「AI 機能権限」は主権限で、その下に「AI アシスタント権限」「ナレッジベース権限」「クローラー権限」「ツール権限」などの子権限が含まれます。主権限にチェックを入れるとすべての子権限が自動的に含まれますが、一部の子権限のみにチェックを入れてより細かい制御を実現することもできます。
最終更新
役に立ちましたか?
