For the complete documentation index, see llms.txt. This page is also available as Markdown.

ロール権限管理

ロールの概念

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

  • ロールに割り当てるメンバーは、組織内の任意のメンバーから選べます

  • 1 人のメンバーが複数のロールを同時に継承でき、柔軟な権限管理を実現します

  • 各ロールは独立した権限設定を持ち、さまざまなシーンのニーズに対応しやすくなっています

わかりやすく言うと:

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


ロールタイプの説明

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

オーナーロール (Owner Role)

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

わかりやすく言うと:

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

特徴:

  • すべてのリソースへの完全なアクセス権限を持ち、追加の割り当ては不要です

  • ロール、メンバー、権限を含む組織内のすべての設定を管理できます

  • 組織には複数のオーナーを設定できます

  • オーナーロールを他のメンバーに割り当てたり、メンバーから削除したりできます

デフォルトロール (Default Role)

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

わかりやすく言うと:

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

特徴:

  • すべての組織メンバーが、デフォルトロールの権限を自動的に取得します

  • 最も基本的なプラットフォームへのアクセス権限(問い合わせ機能など)を提供します

  • Excel による一括割り当てはできません

  • 管理者はデフォルトロールの権限範囲をカスタマイズできます

  • メンバーを手動で割り当てることはできません(システムがすべてのメンバーに自動的に割り当てます)

カスタムロール (Custom Role)

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

わかりやすく言うと:

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

特徴:

  • 管理者が能動的に割り当てる必要があります

  • 異なる職責に応じて、異なる権限の組み合わせを設定できます

  • 一括割り当てに対応しており、大量のメンバー管理に便利です

  • 割り当て後、メンバーはすぐに対応する権限を取得します

権限の計算方法:

例の説明:

  • メンバー A が「カスタマーサポート部」ロールに割り当てられる → 問い合わせ権限 + 対話権限を取得

  • メンバー A がさらに「テストチーム」ロールに割り当てられる → さらに AgentOps 権限が追加される

  • 最終的にメンバー A が持つ権限:デフォルト権限 + カスタマーサポート部権限 + テストチーム権限

EIP ログインを使用している場合、ロールは企業システムから自動的に同期できます。詳しくは サードパーティログイン(SSO) をご覧ください。


ロール権限の編集

該当する組織の下で、「ロール権限の編集」をクリックすると、そのロールのメンバーに権限を設定できます。

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

  • ロールの追加:組織にロール(例:マーケティング部門)を作成します。新しいメンバーが参加する際にロールを適用すれば、対応する権限を自動的に取得できます

  • ロールの編集:ロール名、説明、所属部門などの基本情報を変更します

    • ロール権限:ロールが使用できる機能モジュールと操作範囲を設定します

    • メンバーの割り当て:組織メンバーを指定したロールに追加し、権限設定を一元管理します

    • AI アシスタントの割り当て:ロールが操作できる AI アシスタントを割り当てます

    • ナレッジベースの割り当て:ロールがアクセスできるナレッジベースを割り当てます

    • 対話プラットフォームの割り当て:ロールが使用できる対話プラットフォームを割り当てます

  • ロールの削除:使用しなくなったロールを削除し、組織の権限構造を整然と保ちます

  • 一括機能:Excel で組織にメンバーを一括追加したり、メンバーにロールを一括割り当てしたりします(詳しくは メンバー管理:メンバーと権限の一括管理 をご覧ください)

ロール権限設定のイメージ図

ロール設定タブの説明

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

  • デフォルトロール:デフォルトロールはすべてのメンバーに自動的に割り当てられるため、「メンバーの割り当て」タブは無効になります


権限の階層

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

「階層型の権限構造」とは?

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

  • 主権限 = 親フォルダ(例:「AI 機能」)

  • 子権限 = 子フォルダ(例:「AI アシスタント」「ナレッジベース」「クローラー」)

実際の動作:

  • 主権限にチェックを入れると、その下のすべての子権限が自動的に含まれます

  • 一部の子権限のみにチェックを入れることもでき、より細かい制御を実現できます

権限構造の概要

主権限
子権限
説明

MaiGPT 権限

-

MaiGPT 機能を使用できるかどうかを制御します

AI 機能権限

AI アシスタント権限

「AI アシスタント」タブの閲覧と操作を制御します

ナレッジベース権限

「ナレッジベース」タブの閲覧と操作を制御します

クローラー権限

クローラー機能の使用を制御します

ツール権限

ツール管理機能の使用を制御します

AgentOps 権限

テストセット権限

テストセット機能の閲覧と操作を制御します

自動テスト権限

自動テスト機能の使用を制御します

カスタマーサポート対話権限

すべての対話権限

「すべての対話」タブの閲覧と操作を制御します

対話プラットフォーム権限

「対話プラットフォーム」タブの閲覧と操作を制御します

連絡先権限

連絡先管理機能の使用を制御します

問い合わせ権限

-

「社内問い合わせ」タブの閲覧と操作を制御します

開発者権限

API 呼び出し履歴権限

API 呼び出し履歴の閲覧を制御します

組織権限

組織概要権限

組織概要ページの閲覧を制御します

アクティビティログ権限

アクティビティログ機能の閲覧を制御します

権限階層の説明

  • 主権限にチェックを入れると、その主権限の下のすべての子権限が自動的に含まれます

  • 一部の子権限のみにチェックを入れることもでき、より細かい権限制御を実現できます

  • ユーザーの最終的な権限は、システムのデフォルトロールとカスタムロールの権限を合算した結果になります

権限設定の説明

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

右上の「ロールの追加」をクリックすると、新しいロールの名前を入力し、そのロールが保有できる権限にチェックを入れられます。

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

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

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

左側メニューページ
ロール権限設定ページ

権限の利用シーン

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

シーン 1:新人カスタマーサポート担当者

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

  • 理由:入社したばかりで、製品知識と会社の方針を素早く学ぶ必要があるためです

  • 回避できる問題:不慣れな状態のカスタマーサポート担当者が、誤って顧客の対話記録を削除したり、重要な AI アシスタントの設定を変更したりするのを防ぎます

シーン 2:ベテランカスタマーサポート

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

  • 理由:経験が豊富で、複雑なクレーム対応や新人指導をサポートする必要があるためです

  • 回避できる問題:それでも AI 機能権限は付与せず、カスタマーサポート担当者が誤って AI アシスタントの設定を変更し、すべての顧客が誤った回答を受け取る事態を防ぎます

シーン 3:AI アシスタント管理者

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

  • 理由:AI アシスタントの回答品質の管理と最適化を担当するためです

  • 回避できる問題:カスタマーサポート対話権限は付与せず、顧客のプライバシーデータに触れないようにします


メンバーの割り当て

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

  1. メンバー割り当てページに入ります

  2. +メンバーの割り当て」ボタンをクリックします

  1. 追加したいメンバーを選択し、中央の「追加 >」ボタンをクリックします

  2. 最後に右下の「確認」ボタンをクリックして設定を完了します

追加したいメンバーを選択
追加をクリック
追加が完了したら確認をクリック

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

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

更新後の権限ページ
権限なしの説明画面

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

複数のメンバーに一括でロールを割り当てる必要がありますか?メンバー管理:メンバーと権限の一括管理 をご参照ください。


AI アシスタントの割り当て

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

  1. AI アシスタントの割り当て」ページに入ります

  2. +AI アシスタントの割り当て」ボタンをクリックします

  1. 追加したい AI アシスタントを選択し、中央の「追加 >」ボタンをクリックします

  2. 最後に右下の「確認」ボタンをクリックして設定を完了します

追加したい AI アシスタントを選択
中央の AI アシスタント追加をクリック
追加が完了したら確認をクリック

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

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

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


ナレッジベースの割り当て

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

  1. ナレッジベースの割り当て」ページに入ります

  2. +ナレッジベースの割り当て」ボタンをクリックします

  1. 追加したいナレッジベースを選択し、中央の「追加 >」ボタンをクリックします

  2. 最後に右下の「確認」ボタンをクリックして設定を完了します

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

利用シーン:

  • 研究開発部門:技術文書のナレッジベースのみにアクセスできます

  • 営業部門:製品説明と見積もりのナレッジベースのみにアクセスできます

  • 人事部門:従業員ハンドブックのナレッジベースのみにアクセスできます

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


対話プラットフォームの割り当て

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

  1. 対話プラットフォームの割り当て」ページに入ります

  2. +対話プラットフォームの割り当て」ボタンをクリックします

  1. 追加したい対話プラットフォームを選択し、中央の「追加 >」ボタンをクリックします

  2. 最後に右下の「確認」ボタンをクリックして設定を完了します

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

利用シーン:

  • LINE カスタマーサポートチーム:LINE 対話プラットフォームのみにアクセスできます

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

  • VIP カスタマーサポートチーム:すべての対話プラットフォームにアクセスできます

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


デフォルトロール

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

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


権限の処理

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

権限の和集合の原則 (Union Principle)

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

わかりやすく言うと:

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

例の説明:

権限の適用順序

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

  1. デフォルトロール(自動割り当て)

    • 組織の作成時に自動生成されます

    • すべてのユーザーがデフォルトロール権限を自動的に適用されます

  2. カスタムロール(割り当て順)

    • 後から割り当てられたロールは、既存の権限と統合されます

    • 既存の権限を上書きせず、追加するのみです

ロールの和集合の例

シーンの説明:

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

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

デフォルトロール
カスタムロール

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

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

権限の削除

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

  • カスタムロールの削除:そのロール固有の権限を失いますが、他のロールの権限は保持されます

  • デフォルトロールは削除不可:すべてのユーザーは常にデフォルトロールに属します

  • 権限チェック:システムはユーザーの有効な権限を再計算します

例の説明:


トラブルシューティング

よくある問題:ユーザーが期待した機能を表示できない、または期待を超える機能を使用できる

  1. ユーザーが属するすべてのロール(デフォルトロールを含む)で、権限を過剰に開放していないか確認します

  2. ユーザーにブラウザのキャッシュをクリアし、再ログインしてもらいます

権限レビューの推奨事項

  • ユーザーのロール割り当てが妥当かどうかを定期的に見直します

  • 退職したメンバーのすべてのロール割り当てを削除します


よくある質問

Q:新しいメンバーにより多くの権限を持たせるには?

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

Q:なぜデフォルトロールは Excel で一括割り当てできないのですか?

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

Q:なぜオーナーロールには AI アシスタント、ナレッジベース、対話プラットフォームを割り当てられないのですか?

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

Q:権限の階層構造とはどういう意味ですか?

MaiAgent の権限は親子の階層構造を採用しています。たとえば「AI 機能権限」は主権限で、その下に「AI アシスタント権限」「ナレッジベース権限」「クローラー権限」「ツール権限」などの子権限が含まれます。主権限にチェックを入れるとすべての子権限が自動的に含まれますが、一部の子権限のみにチェックを入れてより細かい制御を実現することもできます。

最終更新

役に立ちましたか?