> 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/maigpt-role-permissions.md).

# MaiGPT のロール別利用権限

ロールごとに利用可能な MaiGPT のモデル、ツール、スキル、コネクタ、組み込み機能を設定します。

組織管理者は、MaiGPT で利用できるモデル、ツール、スキル、コネクタ、組み込み機能をロールごとに制限できます。メンバーが複数のロールを持つ場合、各ロールに付与された権限が統合されます。いずれか 1 つのロールで許可されていれば、その機能を利用できます。

{% hint style="info" %}
オーナーはロールの利用範囲による制限を受けません。以下の設定は、デフォルトロールとカスタムロールの両方に適用されます。
{% endhint %}

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

情報システム責任者は、カスタマーサポートのロールで会社が承認したモデルのみを利用できるようにしたいと考えています。そのロールの MaiGPT 利用権限を開き、「利用可能なモデル」の「すべて」を解除して、承認済みのモデルにチェックを入れます。カードにはすぐに「一部」と選択数が表示され、更新成功のメッセージが表示されます。ツール、スキル、コネクタはそれぞれの「すべて」設定を維持し、モデルの範囲を変更しても一緒に制限されません。

## ロールの MaiGPT 利用範囲を設定する <a href="#configure-scope" id="configure-scope"></a>

{% stepper %}
{% step %}

### 1. ロール権限を開く <a href="#open-role-permissions" id="open-role-permissions"></a>

<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概要</mark>に移動し、「管理」セクションで<mark style="color:blue;">ロール権限を編集</mark>を選択します。
{% endstep %}

{% step %}

### 2. ロールを選択する <a href="#choose-role" id="choose-role"></a>

ロール一覧からデフォルトロールまたはカスタムロールを見つけ、右側の<mark style="color:blue;">編集</mark>を選択して、<mark style="color:blue;">MaiGPT 利用権限を割り当て</mark>タブを開きます。
{% endstep %}

{% step %}

### 3. 利用可能な範囲を設定する <a href="#set-available-scope" id="set-available-scope"></a>

「利用可能な範囲」で、<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-84b3e5ddfa1ba53be75b55c1591eec205e7af5cf%2Fmaigpt-role-scope-overview.png?alt=media" alt="利用可能な範囲の 4 つのカード。それぞれに独立した「すべて」チェックボックスがあります"><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-90f50a8d54f35895d2596939d50120557c4b9d2e%2Fmaigpt-role-model-none.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-e3cb74069c81259c668c473925737d43ab08c228%2Fmaigpt-role-model-partial.png?alt=media" alt="利用可能なモデルを 1 つ選択すると、カードには「一部 1/48」と表示されます"><figcaption><p>カードには「一部」と選択数が表示されます。総数は組織で利用可能なモデルに応じて変わります</p></figcaption></figure>

{% hint style="warning" %}
「利用可能なモデル」が「なし」の場合、このロールでは選択できるモデルがなく、MaiGPT で会話できないという警告が表示されますが、その設定を維持することもできます。このロールのメンバーが MaiGPT で会話する必要があるか確認してください。
{% endhint %}
{% endstep %}

{% step %}

### 4. 組み込み機能を設定する <a href="#set-built-in-features" id="set-built-in-features"></a>

「機能」セクションで、以下の機能を有効または無効にします。

* <mark style="color:blue;">Code Interpreter</mark>：コードを実行し、グラフ、スプレッドシート、ドキュメントを生成します。
* <mark style="color:blue;">ナレッジベース RAG</mark>：組織のナレッジベースを使用して回答し、出典を示します。
* <mark style="color:blue;">Deep Research</mark>：質問を分解し、複数回にわたって Web 上の情報を検索します。独自の Web 検索を使用するため、公式検索ツールが有効かどうかには影響されません。
* <mark style="color:blue;">Browser Tool</mark>：ブラウザを操作し、ページを開き、Web ページの要素を操作して画面をキャプチャします。

変更は自動的に保存されるため、別途「保存」をクリックする必要はありません。更新成功のメッセージが表示されたら、ページを離れてもかまいません。保存に失敗した場合は、更新できなかった項目が画面に表示され、最後に保存に成功した状態へ戻ります。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-a98fb627bb61dc4e93ebffb9b022cc16b413af85%2Fmaigpt-role-features.png?alt=media" alt="MaiGPT 利用権限の割り当てページにある 4 つの機能スイッチ"><figcaption><p>ロール設定で MaiGPT の組み込み機能を管理します</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## メンバーに表示される内容 <a href="#member-experience" id="member-experience"></a>

ロール設定が反映されると、MaiGPT にはメンバーが利用できるモデル、ツール、スキル、機能への入口だけが表示されます。以前は利用できたナレッジベース検索や Code Interpreter がロールで無効にされた場合、右側のパネルに、その機能がこのロールにはまだ許可されていないことが表示されます。

組織では有効になっているものの、メンバーのロールにはまだ許可されていないコネクタの場合、メンバーには認証ボタンが表示されず、代わりに利用申請を送信できます。メンバーが以前に認証を完了している場合でも、接続を解除して、使用しなくなった認証情報を削除できます。

{% hint style="warning" %}
権限を変更した後、開始済みの対話で許可されなくなったモデルを使用している場合、システムはロールで利用可能なモデルへの切り替えを試みます。対話を続ける前にモデル名を確認するよう、メンバーに案内してください。
{% endhint %}

## 関連ガイド <a href="#related-guides" id="related-guides"></a>

* [ロール権限管理](/maiagent-user-guide/ja/org/roles/role-permission.md)
* [MaiGPT コネクタ](/maiagent-user-guide/ja/work/maigpt/connectors.md)


---

# 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/maigpt-role-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.
