> 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/maiagent-user-guide-ja/org/overview.md).

# 組織とメンバーの管理

## 組織とメンバー管理とは？ <a href="#what-is-organization-member-management" id="what-is-organization-member-management"></a>

MaiAgent の組織とメンバー管理機能は、企業のために「デジタルオフィス」を構築するようなものです。この機能を通じて、会社の組織体制を作成し、従業員に役職を割り当て、誰が何をできるかを設定することで、チームの連携をより整然と進められます。

本システムは **RBAC**（Role-Based Access Control、ロールベースアクセス制御）をベースに設計されており、包括的な組織管理ソリューションを提供します。これにより、企業は効率的にチームを編成し、権限を割り当て、リソースの利用状況を監視できます。

{% hint style="info" %}
**RBAC とは？**

RBAC は「まず役職を設定し、その後にメンバーを役職へ追加する」という管理方式です。たとえば、先に「カスタマーサポート担当」というロールが何をできるかを定義しておき、そこに田中さんや佐藤さんを追加すると、彼らは自動的にカスタマーサポート担当のすべての権限を持つようになります。一人ひとり個別に設定する必要はありません。
{% endhint %}

***

## システム構成 <a href="#system-architecture" id="system-architecture"></a>

### 3 階層構造 <a href="#three-tier-structure" id="three-tier-structure"></a>

MaiAgent は明確な 3 階層構造を採用しています：**組織 → ロール → メンバー**

```
組織 (Organization)
└─ あなたの会社
   │
   ├─ ロール (Role)
   │  └─ 役職/部門 (例：カスタマーサポート部、マーケティング部)
   │     │
   │     └─ メンバー (Member)
   │        └─ 従業員 (例：田中さん、佐藤さん)
```

{% hint style="info" %}
**かんたんに理解すると：**

* **組織** = あなたの会社
* **ロール** = 会社内の部門や役職（例：カスタマーサポート部、マーケティング部）
* **メンバー** = 会社の従業員（例：田中さん、佐藤さん）
  {% endhint %}

### 動作の仕組み <a href="#how-it-works" id="how-it-works"></a>

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-5503ceba3aecfd5845b8e547dd7bd206c16f2c85%2Fimage%20(80).png?alt=media" alt=""><figcaption></figcaption></figure>

**設定手順：**

1. **組織を作成する**：システム内にあなたの会社を作成します
2. **ロールを作成する**：組織内に部門や役職を作成します（例：カスタマーサポート部、マーケティング部）
3. **権限を設定する**：各ロールが何をできるかを設定します（機能権限を決定）
4. **メンバーを割り当てる**：従業員を対応するロールに追加します
5. **自動的に有効化**：メンバーはそのロールのすべての権限を自動的に取得します

***

## コアコンセプトの説明 <a href="#core-concepts" id="core-concepts"></a>

### 組織 (Organization) <a href="#organization-concept" id="organization-concept"></a>

**組織**は最上位の管理単位であり、あなたの会社やチームを表します。各組織は独立したメンバー、ロール、権限、リソースを保有します。

{% hint style="info" %}
\*\*かんたんに理解すると：\*\*組織は「会社」のようなもので、各会社はそれぞれの従業員（メンバー）、部門（ロール）、データ（AI アシスタント、ナレッジベースなど）を持っています。
{% endhint %}

### ロール (Role) <a href="#role-concept" id="role-concept"></a>

**ロール**は組織内の機能単位であり、一連の権限とリソースを定義します。

**3 種類のロールタイプ：**

* **オーナーロール**：最高権限を持ち、すべての設定を管理できます
* **デフォルトロール**：すべてのメンバーが自動的に持つ基本権限です
* **カスタムロール**：ニーズに応じて作成する部門や役職のロールです

{% hint style="info" %}
\*\*かんたんに理解すると：\*\*ロールは会社の「部門」や「役職」（例：カスタマーサポート部、マーケティング部、マネージャー）のようなもので、各ロールには異なる職責と権限があります。
{% endhint %}

### メンバー (Member) <a href="#member-concept" id="member-concept"></a>

**メンバー**は組織内のユーザーであり、ロールを通じて権限を取得します。

**メンバータイプ：**

<table><thead><tr><th>メンバータイプ</th><th width="215">説明</th><th>権限の範囲</th></tr></thead><tbody><tr><td>オーナー</td><td>組織の作成者、またはオーナーに指定されたメンバー</td><td>すべてのリソースに対する完全なアクセス権限を保有<br>組織設定とロール権限を管理可能</td></tr><tr><td>一般メンバー</td><td>ロール内のメンバー</td><td>所属するロールの権限とリソース（Q&#x26;A、対話権限など）を保有</td></tr></tbody></table>

{% hint style="info" %}
**かんたんに理解すると：**

* **オーナー** = 会社の社長またはシステム管理者であり、すべてのことを管理できます
* **一般メンバー** = 会社の従業員であり、所属する部門（ロール）に応じて異なる権限を持ちます
  {% endhint %}

### 権限 (Permission) <a href="#permission-concept" id="permission-concept"></a>

**権限**は、メンバーがどの機能を利用できるかを制御します。

MaiAgent は**階層型の権限構造**を採用しています：

{% hint style="info" %}
**「階層型の権限構造」とは？**

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

* **主権限** = 親フォルダー（例：「AI 機能」）
* **子権限** = 子フォルダー（例：「AI アシスタント」「ナレッジベース」「クローラー」）

**実際の動作：**

* 主権限にチェックを入れると、その下のすべての子権限が自動的に含まれます
* 一部の子権限のみにチェックを入れて、より細かい制御を行うこともできます
  {% endhint %}

### リソース (Resource) <a href="#resource-concept" id="resource-concept"></a>

**リソース**は組織内の実体的な項目であり、特定のロールに割り当てて利用できます。

**リソースタイプ：**

* **AI アシスタント**：指定したロールが操作できる AI アシスタント
* **ナレッジベース**：指定したロールがアクセスできるナレッジベース
* **対話プラットフォーム**：指定したロールが利用できる対話プラットフォーム

***

## 設定フローガイド <a href="#setup-guide" id="setup-guide"></a>

{% hint style="success" %}
**推奨する設定の順序**

混乱を避けるため、以下の順序で設定を進めることをおすすめします：

1. ✅ **組織を作成する**：まずあなたの会社の組織を作成します
2. ✅ **ロールを作成する**：組織内に必要な部門や役職を作成します
3. ✅ **権限を設定する**：各ロールに機能権限を設定します
4. ✅ **リソースを割り当てる**：各ロールに利用できる AI アシスタント、ナレッジベースを指定します
5. ✅ **メンバーを追加する**：従業員を組織に追加します
6. ✅ **ロールを割り当てる**：メンバーを対応するロールに指定します
   {% endhint %}

***

## 関連ページ <a href="#related-pages" id="related-pages"></a>

続いて、ご自身のニーズに応じて、以下の詳細な説明をご参照ください：

* [組織管理](/maiagent-user-guide/maiagent-user-guide-ja/org/organization.md)：組織の作成、切り替え、管理の方法
* [ロール権限管理](/maiagent-user-guide/maiagent-user-guide-ja/org/role-permission.md)：ロールの作成、権限の設定、リソースの割り当ての方法
* [メンバー管理](/maiagent-user-guide/maiagent-user-guide-ja/org/member.md)：メンバーの追加、削除、ロールの割り当ての方法

***

## 設計上のメリット <a href="#design-advantages" id="design-advantages"></a>

{% hint style="info" %}
あなたの組織に所属するメンバーのみが、その組織下のすべての AI アシスタント関連機能を閲覧・管理できます。
{% endhint %}

このような設計により、以下が実現できます：

* **構造が明確**：組織 → ロール → メンバーの 3 階層構造で一目瞭然です
* **柔軟な権限**：ロールのニーズに応じて、それぞれ異なる権限の組み合わせを個別に設定できます
* **集中管理**：組織オーナーがすべての設定を一元的に管理します
* **メンバーの柔軟性**：一人のメンバーが同時に複数のロールに所属し、異なるプロジェクトやチームに参加できます
* **リアルタイムな把握**：組織の運営状況に関するリアルタイムな情報を提供します
* **リソースの管理**：リソース利用の効果的な管理を確保します


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/org/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
