> 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-batch-permissions.md).

# ロール権限の一括設定

同じ権限設定を複数のカスタムロールにまとめて適用します。適用前にロールごとに追加・削除される項目をプレビューでき、新しいロールを同時に作成することもできます。

組織に十数個の部署ロールがある場合、すべてのロールに同じ新しい Agent を追加したり、同じ機能を外したりするには、これまでロールの編集ページを 1 つずつ開いて変更する必要がありました。<mark style="color:blue;">権限の一括設定</mark> では、先に 1 つの権限設定を作成し、適用するロールを選択してまとめて書き込みます。適用ボタンを押す前に、ロールごとに適用後の「追加される項目数・削除される項目数」が一覧表示され、展開すると明細も確認できます。

## ご利用前の注意 <a href="#before-you-start" id="before-you-start"></a>

* **利用できる人**：組織概要の権限が必要です。つまり、<mark style="color:blue;">ロール権限の編集</mark> ページを開ける管理者が対象です。
* **全体の上書き**：選択したロールは、すべてのタブの設定がこの設定と完全に一致する状態になります。ロールにもともとあってもこの設定にない権限やリソースの割り当ては削除されます。「追加するだけ」ではありません。
* **適用できるロール**：カスタムロールのみです。オーナーとデフォルトロールは適用リストに含まれず、上書きされません。
* **一度に最大 50 ロール**：選択した既存ロールと新規ロールの合計で、最大 50 個までです。
* **すべて成功した場合のみ書き込み**：いずれかのロールの書き込みに失敗した場合、一括適用全体が反映されません。
* **対象のタブ**：<mark style="color:blue;">ロール権限</mark>、<mark style="color:blue;">MaiGPT 利用権限の割り当て</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> の 8 つのリソースタブです。ロールのメンバーと Credit クォータには影響しません。
* **公式組み込み Agent は影響を受けません**：ロックされた公式組み込み Agent とその会話プラットフォームは、一括設定では変更されません。

## 利用シーン <a href="#scenario" id="scenario"></a>

人事部が「社内規程Q\&A」Agent を公開し、組織の管理者が全社 12 の部署ロールで利用できるようにしたいと考えています。これらの部署ロールは、もともと同じ標準設定で作成されています。管理者はロール一覧で <mark style="color:blue;">権限の一括設定</mark> をクリックし、<mark style="color:blue;">既存のロール権限を使用</mark> を選んで「営業部」を起点にし、<mark style="color:blue;">AI アシスタントの割り当て</mark> タブでこの Agent を追加します。この Agent の会話プラットフォームも一緒に取り込まれます。<mark style="color:blue;">適用先のロール</mark> では 12 の部署ロールを選択します。ほとんどのロールは追加のみで、削除は「−0」ですが、「カスタマーサービス部」だけは「−2 削除」と表示されます。展開してみると、カスタマーサービス部には標準設定にないナレッジベースが後から 2 つ割り当てられており、全体を上書きするとそれらが削除されることが分かりました。管理者はカスタマーサービス部のチェックを外し、そのロールの編集ページで Agent を個別に追加して、残りの 11 ロールにはまとめて適用を完了しました。

## 操作手順 <a href="#steps" id="steps"></a>

{% stepper %}
{% step %}

### 1. 権限の一括設定を開く <a href="#open-batch-permissions" id="open-batch-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> をクリックします。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-288b2e260222c37bc1837a1447ef6314b72898bc%2Frole-batch-permissions-entry.png?alt=media" alt="ロール一覧の右上にある権限の一括設定ボタン"><figcaption><p>ロール一覧の右上にある権限の一括設定の入口</p></figcaption></figure>

ページ上部のステップバーには、<mark style="color:blue;">設定方法</mark>、<mark style="color:blue;">権限の設定</mark>、<mark style="color:blue;">適用先のロール</mark> の順に表示されます。
{% endstep %}

{% step %}

### 2. 設定方法を選択する <a href="#choose-method" id="choose-method"></a>

| 設定方法                                         | 説明                                                                                                  |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">新しい権限ルール</mark>    | 空の状態から始めます。どのタブにも設定がない状態です。<mark style="color:blue;">ロール権限</mark> は、機能権限を 1 つ以上チェックしないと次のステップに進めません |
| <mark style="color:blue;">既存のロール権限を使用</mark> | 下の表からロールを 1 つ選び、そのロールの現在のすべてのタブの設定を起点として使用します。そのロール自体は変更されません                                       |

既存のロールを使用する場合、表には組織のすべてのロール（オーナーとデフォルトロールを含む）が表示され、ロール名または ID で検索できます。選択すると、下に「… の設定を起点として使用しました」と表示されるので、<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-23daa1cb3a8bf431c0b5dce79913154ddb069a79%2Frole-batch-permissions-copy-source.png?alt=media" alt="設定方法で既存のロール権限を使用を選択すると、表に組織のロールが表示され、選択後は下に使用中のロールが表示されます"><figcaption><p>既存のロール権限を使用：ロールを 1 つ選んで起点にします</p></figcaption></figure>

{% hint style="warning" %}
オーナーロールを起点にすると、すべての機能権限と、組織で現在割り当て可能なすべてのリソースが取り込まれます。適用前に、対象のロールが本当にそれほど大きな権限を必要としているか確認してください。
{% endhint %}
{% endstep %}

{% step %}

### 3. 権限を設定する <a href="#edit-settings" id="edit-settings"></a>

このステップのタブと操作は、ロールの編集ページと同じです。詳しくは [ロール権限の管理](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-permission.md#edit-role-permissions) をご覧ください。違いは、ここで編集するのは下書きであり、<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;">AI アシスタントの割り当て</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-2461cabd095cf788caf18881d12508e9e1d9963d%2Frole-batch-permissions-compared-mark.png?alt=media" alt="2 番目のステップの 10 個のタブ。権限をチェックすると、右側に起点との比較：追加と表示されます"><figcaption><p>変更した項目には起点との差分が表示されます</p></figcaption></figure>

設定が完了したら、<mark style="color:blue;">次へ</mark> をクリックします。
{% endstep %}

{% step %}

### 4. 適用するロールを選択し、差分をプレビューする <a href="#choose-targets" id="choose-targets"></a>

表にはすべてのカスタムロールが表示されます。ロール名で検索し、適用するロールをチェックします。<mark style="color:blue;">適用後の差分</mark> 列には、各ロールの適用後の変化が表示されます。

| 表示          | 意味                                       |
| ----------- | ---------------------------------------- |
| ＋N 追加、−N 削除 | このロールに適用後、増える項目数と失われる項目数                 |
| この設定と同じ     | このロールの現在の設定はすでにこの設定と一致しており、適用しても変化はありません |
| 起点ロール · …   | 設定方法で起点として選んだロール自身                       |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-0d36978c5ebaa05da1015252ee6ffac6741e8417%2Frole-batch-permissions-targets.png?alt=media" alt="3 番目のステップでロールをチェックすると、各行に追加・削除される項目数が表示され、下部に全体の上書きを知らせる注意が表示されます"><figcaption><p>チェックしたロールには、適用後に追加・削除される項目数が表示され、展開すると明細を確認できます</p></figcaption></figure>

行の <mark style="color:blue;">展開</mark> をクリックすると、明細を確認できます。

* <mark style="color:blue;">N 件を追加します</mark>、<mark style="color:blue;">N 件を削除します</mark> として、タブごとに各項目が一覧表示されます。会話プラットフォームにはチャネルの種類が表示されるため、同じ Agent の異なるプラットフォームを見分けられます。
* 削除される項目がある場合、そのロールに何人のメンバーがいるかが表示されます。ほかのロールから削除される項目が付与されていないメンバーは、適用後にその権限を失います。
* 今回の適用によって、ある機能エリアの入口が有効または無効になる場合は、別途「このエリアの入口も有効／無効になります（件数には含まれません）」と表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-fe67acb259067ea21aa9a310597d136cd2c8c142%2Frole-batch-permissions-expand.png?alt=media" alt="ロールを展開すると、タブごとに追加される項目と削除される項目が一覧表示されます"><figcaption><p>展開した明細には、タブごとに追加される項目と削除される項目が表示されます</p></figcaption></figure>

**ロールを同時に追加する**：表の上にある <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-5ce52e32b86c147956f8c1cfa57dd8ab1408413f%2Frole-batch-permissions-new-role.png?alt=media" alt="表の最上部に新しいロールの行が追加され、名前を入力すると適用時にロールが作成されます"><figcaption><p>ロールを追加すると、表に新しいロールの行が追加されます</p></figcaption></figure>
{% endstep %}

{% step %}

### 5. 適用する <a href="#apply" id="apply"></a>

下部の「全体の上書き」の注意を確認したら、<mark style="color:blue;">N 個のロールに適用</mark> をクリックします。成功すると「N 個のロールに適用しました」と表示され、ロール一覧に戻ります。

* 適用中は、チェックの変更、前のステップへの移動、ページからの離脱ができません。変更が途中までしか適用されない事態を防ぐためです。
* 差分を確認した後に、いずれかのロールが他のユーザーによって変更された場合、画面に「差分を確認した後にロールが変更されたため、再計算しました」と表示され、プレビューが更新されます。差分を再度確認してから適用してください。
  {% endstep %}
  {% endstepper %}

{% hint style="warning" %}
適用後の変更は自動では元に戻りません。元に戻すには、もう一度一括設定を行うか、各ロールの編集ページで 1 つずつ調整してください。適用前にページを離れようとすると、「適用していない設定は失われます」と表示されます。
{% endhint %}

## 適用後の確認方法 <a href="#verify" id="verify"></a>

適用後にメンバーが実際にどの権限を持っているか、各項目がどのロールから付与されているかを確認するには、メンバー一覧で該当メンバーの <mark style="color:blue;">有効な権限を確認</mark> をクリックしてください。詳しくは [メンバー管理：メンバーの有効な権限を確認する](https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview/member.md#effective-permissions) をご覧ください。

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

### Q：適用リストにオーナーとデフォルトロールが表示されないのはなぜですか？ <a href="#faq-owner-default-not-listed" id="faq-owner-default-not-listed"></a>

オーナーロールは常にすべての権限を持ち、デフォルトロールはすべてのメンバーに自動的に適用されます。どちらも全体の上書きには適さないため、適用リストには含まれません。<mark style="color:blue;">設定方法</mark> で起点として使用することは可能です。デフォルトロールを調整したい場合は、そのロールの編集ページで変更してください。

### Q：「ロールの複製」とは何が違いますか？ <a href="#faq-vs-duplicate-role" id="faq-vs-duplicate-role"></a>

[ロールの複製](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-permission.md#duplicate-role) は、複製元のロールの権限とリソースの割り当てを引き継いだ新しいロールを作成します。メンバーは引き継ぎません。権限の一括設定もメンバーを引き継ぎませんが、複数の既存ロールにまとめて適用できます。

### Q：一度に 50 を超えるロールを変更したい場合はどうすればよいですか？ <a href="#faq-over-limit" id="faq-over-limit"></a>

上限を超えると、下部に「一度に適用できるロールは最大 50 個です」と表示され、適用ボタンをクリックできなくなります。複数回に分けて適用してください。各回で同じ起点ロールから同じ設定を使用できます。一覧が 50 個を超える場合は、まずロール名のキーワードで絞り込み、表のヘッダーのチェックボックスで全選択してください。キーワードを変更しても、先にチェックしたロールは保持されます。


---

# 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-batch-permissions.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.
