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

# ロールと権限

ロールは、MaiAgent で「誰が何を見られるか、誰が何をできるか」を制御する単位です。このページ群では、設定から設計まで、ロールの使い方を順に説明します。

ロールによって、メンバーが見られる機能、新規作成できるかどうか、見られる Agent やナレッジベースが決まります。やりたいことに応じてページを選んでください。

<table><thead><tr><th width="260">やりたいこと</th><th>参照するページ</th></tr></thead><tbody><tr><td>ロールの種類を知る、ロールを作成する、機能権限を選択する</td><td><a href="https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-permission.md">ロール権限管理</a></td></tr><tr><td>同じ権限設定を複数のロールにまとめて適用する、メンバーの権限がどのロールに由来するかを確認する</td><td><a href="https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-batch-permissions.md">ロール権限の一括設定</a>、<a href="https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview/member.md#effective-permissions">メンバーの有効な権限を確認する</a></td></tr><tr><td>あるロールが見られる・使える Agent とナレッジベースを制御する</td><td><a href="https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/group-resource-access.md">ロールのリソースアクセス権限</a></td></tr><tr><td>メンバー一覧をロールで絞り込む</td><td><a href="https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/group-member-filtering.md">ロールによるメンバー絞り込み</a></td></tr><tr><td>ロールと連絡先の違いが分からない</td><td><a href="https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/contact-role-comparison.md">ロールと連絡先の違い</a></td></tr><tr><td>社員が Agent を自作し、共有は申請と段階的な公開を経る運用にしたい</td><td><a href="https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-design-guide.md">ロール権限設計ガイド</a></td></tr><tr><td>カスタマーサポートが、他の同僚が対応中の会話を転送することを制限する</td><td><a href="https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/transfer-others-permission.md">他者の会話を転送する権限</a></td></tr></tbody></table>

{% hint style="info" %}
**かんたんな理解：**

設計ガイドは「ロールをどう分けるか」を説明し、その他のページは「ボタンの場所と設定方法」を説明します。初めて組織のロールを設計する場合は、先に設計ガイドを読み、その後で各ページに沿って設定してください。
{% endhint %}

## 権限の一括設定とメンバーの有効な権限 <a href="#role-permission-governance" id="role-permission-governance"></a>

ロールが多くなると、1 つずつ修正するのは漏れが起きやすく、メンバーの権限がどのロールから付与されているかを一目で把握するのも難しくなります。ロール一覧とメンバー一覧にそれぞれ入口があり、どちらも組織概要権限（<mark style="color:blue;">ロール権限の編集</mark> とメンバー管理ページにアクセスできる管理者）が必要です。

* **権限の一括設定**：ロール一覧で <mark style="color:blue;">権限を一括設定</mark> をクリックし、まず 1 つの権限設定を作成します（空白から始めることも、既存ロールの設定を取り込むこともできます）。続いて適用先のカスタムロールを選択します。同時にロールを追加することもできます。適用前に、各ロールで追加・取り消しされる項目が 1 件ずつ一覧表示され、確認後にまとめて書き込まれます。操作方法は [ロール権限の一括設定](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-batch-permissions.md) をご覧ください。
* **有効な権限の確認**：メンバー一覧で、メンバーの操作列にある盾アイコンをクリックすると、そのメンバーのすべてのロールを統合した実際の機能権限、MaiGPT の利用範囲とリソース、および各項目がどのロールから付与されているかを確認できます。操作方法は [メンバー管理：メンバーの有効な権限を確認する](https://docs.maiagent.ai/maiagent-user-guide/ja/org/overview/member.md#effective-permissions) をご覧ください。

<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>


---

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