> 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/group-member-filtering.md).

# ロールメンバーのフィルタリング

### 機能概要 <a href="#feature-intro" id="feature-intro"></a>

ロール別メンバー絞り込み機能を使うと、組織管理者はロールに応じてメンバー一覧をすばやく絞り込むことができ、大規模な組織でのメンバー管理効率を大幅に向上させられます。この機能により、特定のロールに属するメンバーをすばやく見つけ、一括操作や権限の調整を行えます。

{% hint style="info" %}
この機能は、複数のロールと多数のメンバーを抱える組織に特に適しており、メンバー管理のプロセスを効果的に簡素化します。
{% endhint %}

***

### 絞り込み機能の使い方 <a href="#using-filter" id="using-filter"></a>

#### 基本的な絞り込み <a href="#basic-filter" id="basic-filter"></a>

1. **メンバー管理ページを開く**
   * 左側メニューの「<mark style="color:blue;">組織設定</mark>」をクリックします
   * 「<mark style="color:blue;">組織概要</mark>」をクリックします
   * 「<mark style="color:blue;">メンバーを編集</mark>」をクリックします
2. **絞り込み条件を選択する**
   * メンバー一覧の上部にある「<mark style="color:blue;">ロールで絞り込む</mark>」プルダウンメニューを見つけます
   * 絞り込みたいロールを選択します
   * メンバー一覧がただちに更新され、そのロールに属するメンバーのみが表示されます

<figure><img src="/files/RcMKmkzwkmIhZ18I2uwY" alt="メンバー一覧とロール絞り込み"><figcaption><p>メンバー一覧ページ。「ロールを選択して絞り込む」プルダウンメニューから特定のロールに属するメンバーを絞り込めます</p></figcaption></figure>

#### 絞り込みオプション <a href="#filter-options" id="filter-options"></a>

<table><thead><tr><th width="200">絞り込みオプション</th><th>説明</th></tr></thead><tbody><tr><td><strong>すべてのメンバー</strong></td><td>組織内のすべてのメンバーを表示します（デフォルトのオプション）</td></tr><tr><td><strong>オーナーロール</strong></td><td>オーナーロールのメンバーのみを表示します</td></tr><tr><td><strong>デフォルトロール</strong></td><td>デフォルトロールのみを持つメンバー（他のロールが割り当てられていないメンバー）を表示します</td></tr><tr><td><strong>カスタムロール</strong></td><td>作成したカスタムロール名で絞り込みます<br>（例: マーケティング部、カスタマーサポートチーム、開発チームなど）</td></tr></tbody></table>

***

### 高度な操作 <a href="#advanced-operations" id="advanced-operations"></a>

#### 絞り込みと検索の組み合わせ <a href="#combine-filter-and-search" id="combine-filter-and-search"></a>

ロールでの絞り込みとキーワード検索を組み合わせることで、目的のメンバーをより正確に見つけられます。

1. まずロールで絞り込みます（例: 「カスタマーサポートチーム」）
2. 次に検索ボックスにメンバーの氏名またはEmailを入力します
3. システムが、絞り込み済みの結果の中からさらに検索を行います

**例**:

```
絞り込み条件: カスタマーサポートチーム
検索キーワード: 田中
→ 結果: カスタマーサポートチームのうち、氏名に「田中」を含むすべてのメンバー
```

***

### 活用シーン <a href="#use-cases" id="use-cases"></a>

#### シーン1: 新規プロジェクトチームの編成 <a href="#use-case-new-project-team" id="use-case-new-project-team"></a>

**ニーズ**: 会社が新規プロジェクトを立ち上げ、既存のメンバーから適切な人材を選んでプロジェクトチームを編成する必要がある

**操作の流れ**:

1. 新しいロール「プロジェクトAチーム」を作成します
2. 関連する部門を順に絞り込みます:
   * 「開発部」で絞り込み → エンジニア3名を見つける
   * 「デザイン部」で絞り込み → デザイナー2名を見つける
   * 「マーケティング部」で絞り込み → マーケティング担当者1名を見つける
3. 選定したメンバーを「プロジェクトAチーム」ロールに追加します
4. このロールに、プロジェクトで必要となるAIアシスタントとナレッジベースの権限を設定します

#### シーン2: 定期的な権限レビュー <a href="#use-case-periodic-permission-review" id="use-case-periodic-permission-review"></a>

**ニーズ**: 四半期ごとに各部門メンバーの権限を見直し、最小権限の原則に沿っているか確認する

**操作の流れ**:

1. 各部門のロールを1つずつ絞り込みます
2. 各メンバーの権限設定を確認します:
   * 不要な権限はないか?
   * 必要な権限が不足していないか?
3. 調整が必要なメンバーを記録します
4. 権限の調整を行います

#### シーン3: 退職者の権限回収 <a href="#use-case-offboarding-revoke" id="use-case-offboarding-revoke"></a>

**ニーズ**: 従業員が退職するため、すべての権限をすばやく回収する必要がある

**操作の流れ**:

1. その従業員の氏名を検索します
2. その従業員が所属しているすべてのロールを確認します
3. 各ロールのメンバー一覧を1つずつ開きます
4. 絞り込みを使ってその従業員をすばやく特定します
5. その従業員をすべてのロールから削除します
6. その従業員にデフォルトロール（最小権限）のみが残っていることを確認します

***

### 絞り込みのパフォーマンス最適化 <a href="#filter-performance-optimization" id="filter-performance-optimization"></a>

#### 大規模組織向けの推奨事項 <a href="#large-org-recommendations" id="large-org-recommendations"></a>

組織に100名以上のメンバーがいる場合は、次のことをおすすめします。

1. **明確なロール命名**
   * わかりやすい命名規則を使う（例: 部門-職能-プロジェクト）
   * 例: 「営業部-カスタマーサービス-VIPプロジェクト」
2. **適切なロール数**
   * 細分化しすぎたロールの作成を避ける
   * 各組織のロール数は20個以内に抑えることを推奨します
3. **定期的な整理**
   * 使われなくなったロールを削除する
   * 退職済みの従業員を削除する
   * 機能が似ているロールを統合する
4. **一括機能の活用**
   * Excelによる一括管理を利用する（参考: [メンバーと権限の一括管理](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/ja/org/bulk-role-permission.md)）

***

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

#### Q: 1人のメンバーが複数のロールに属している場合、どの絞り込み結果に表示されますか? <a href="#faq-member-in-multiple-roles" id="faq-member-in-multiple-roles"></a>

**A**: そのメンバーは、所属しているすべてのロールの絞り込み結果に表示されます。たとえば、田中さんが「マーケティング部」と「プロジェクトA」の両方に属している場合、この2つのロールで絞り込んだとき、どちらでも田中さんが表示されます。

#### Q: 絞り込み条件は保存できますか? <a href="#faq-save-filter" id="faq-save-filter"></a>

**A**: 現在のところ、絞り込み条件の保存には対応していません。ただし、ブラウザが直近の絞り込み選択を記憶しているため、次回ページを開いたときに自動的に適用されます。

#### Q: なぜ一部のロールの絞り込みオプションが表示されないのですか? <a href="#faq-cannot-see-role-filter" id="faq-cannot-see-role-filter"></a>

**A**: 考えられる原因は次のとおりです。

* そのロールの管理権限を持っていない
* そのロールがすでに削除されている
* 組織のオーナーではない（一部のロールはオーナーのみ表示可能）

#### Q: 絞り込みの速度が遅い場合はどうすればよいですか? <a href="#faq-slow-filter" id="faq-slow-filter"></a>

**A**: 考えられる原因と対処方法は次のとおりです。

* **メンバーが多すぎる**（500名超）: より正確な検索条件を使うことをおすすめします
* **ブラウザのキャッシュが多すぎる**: ブラウザのキャッシュを消去してから再度お試しください
* **ネットワークの遅延**: ネットワーク接続の状態を確認してください

***

### 関連機能 <a href="#related-features" id="related-features"></a>

{% hint style="info" %}
**関連機能**

* [組織とメンバーの管理](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/ja/org/rbac.md)
* [ロール権限管理](/maiagent-user-guide/maiagent-user-guide-ja/org/role-permission.md)
* [メンバーと権限の一括管理](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/ja/org/bulk-role-permission.md)
* [ロール別リソースアクセス権限](/maiagent-user-guide/maiagent-user-guide-ja/org/group-resource-access.md)
  {% endhint %}


---

# 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/group-member-filtering.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.
