> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# グループ

> グループごとにチームのメンバーシップ、モデルの利用可否、ACU上限を管理します。

<Info>
  このドキュメントは、Devin の連邦政府向け導入環境を対象としています。[Devin Docs に戻る](/ja/get-started/devin-intro)
</Info>

グループを使用すると、連邦 Enterprise 管理者は分離された分析データを閲覧し、チーム内の特定のメンバーを対象に、モデルの利用可否や ACU上限などのポリシーを作成できます。グループはチーム単位で管理されます。別のチームが作成されることはなく、チーム内の他のリソースに対するメンバーのアクセス権も変更されません。

グループは、セルフホスト型のマルチテナント連邦政府向け導入環境で利用できます。サイト管理者はグループにアクセスできます。それ以外の場合、ポータルでチームの名簿を表示するには、ロールに **Teams Update** と、**Teams Read-Only** または **Analytics Read** のいずれかが必要です。**Teams Update** だけでは不十分な場合があり、Settings を開く権限も必要です。グループは、[Group Management API](/ja/federal/api/group-management) または [Python SDK](/ja/federal/api/python-sdk) を使用してプログラムから管理することもできます。

***

<div id="open-group-management">
  ## グループ管理を開く
</div>

[連邦ポータル](https://windsurf.fedstart.com/settings)で、**Settings → Groups** に移動します。Groups タブは、マルチテナントのデプロイメントで上記のアクセス要件を満たすロールが利用できます。

グループテーブルには、次の項目が含まれます。

| 列          | 説明                                              |
| ---------- | ----------------------------------------------- |
| **名前**     | グループ名です。                                        |
| **メンバー**   | グループに所属するチームメンバーの数です。                           |
| **ACU 上限** | グループ内のメンバーごとの ACU 上限です。この列は、ACU課金対象のチームに表示されます。 |
| **モデル**    | グループに設定されている Cascade と Command モデルの利用可否です。      |

グループの行を選択すると、詳細が表示されます。詳細ビューには、グループ名、メンバー数、設定済みの ACU 上限、モデルの利用可否、ユーザーが表示されます。

<div id="create-a-group">
  ## グループを作成する
</div>

**グループを作成**を選択して、ウィザードを開きます。ウィザードでは、次の手順を実行します。

1. **グループに名前を付ける** — `Engineering`などの名前を入力します。
2. **モデルを選択する** — メンバーが利用できるCascadeモデルとCommandモデルを選択します。
3. **ACU上限を設定する** — 請求サイクルごとに、メンバーごとの上限を設定します。この手順は、ACU課金対象のチームにのみ表示されます。
4. **ユーザーを追加する** — 必要に応じて、ここでチームメンバーを追加します。メンバーは後から追加または削除できます。

モデルを選択しない場合、メンバーのモデルアクセスについては**指定なし**となります。他のグループによる制限が上書きされることはありません。グループのモデルポリシーは、ユーザーが所属するグループの少なくとも1つで、あるサーフェスに対するモデル選択が指定されている場合にのみ適用されます。それ以外の場合、ユーザーにはチームで利用可能なモデルが提供されます。モデルの動作の詳細については、[モデルのプロビジョニング](/ja/federal/model-provisioning)を参照してください。

ACU課金対象のチームでは、チームにACU請求設定がある場合にのみ、グループ上限を設定できます。ポータルでは負の値や有限でない値は受け付けず、無効な値を入力すると**負でないACU上限を入力してください**と表示されます。

グループ自体の作成後に後続の手順が失敗した場合、ポータルに**警告付きでグループが作成されました**と表示されることがあります。グループは引き続き利用できますが、要求したモデル、ACU、またはメンバーシップの変更の一部が適用されていない可能性があります。**グループに移動**を選択して、変更を確認し完了してください。

<div id="name-and-edit-a-group">
  ## グループの名前変更と編集
</div>

グループ名は保存前に前後の空白が削除されます。名前の指定は必須で、チーム内で一意である必要があります。次の名前は予約済みのため、使用できません。

* `All Users`
* `All Indexes`

名前の確認では大文字と小文字が区別されないため、`all users` と `All Users` は同じ予約名として扱われます。

名前が空欄の場合、ポータルには**グループ名は必須です**と表示されます。大文字と小文字を区別しない重複がある場合は、**この名前のグループはすでに存在します**と表示されます。

グループのアクションメニューを開き、**グループを編集**を選択してグループ名または ACU上限を変更します。Models セクションで **モデルを編集**を選択すると、Cascade または Command の利用可否を変更できます。

<div id="manage-members">
  ## メンバーを管理する
</div>

グループ詳細画面で **Add user** を選択し、**Add users** ダイアログを開きます。グループに追加するチームメンバーを選択して **Save** を選択します。メンバーの横にある **Remove** を選択し、削除を確認することもできます。

グループに追加できるのは、そのグループのチームに所属するメンバーのみです。グループからユーザーを削除しても、チームからは削除されません。チームへのアクセスは維持され、そのグループを通じて割り当てられたコントロールのみが適用されなくなります。グループ管理はチーム単位で行われるため、グループに対してのみ付与された権限では、そのグループや他のグループを管理するアクセス権は得られません。

ユーザーがチームから削除されると、そのグループメンバーシップも削除されます。その後チームに再参加しても、以前のグループのモデルおよび ACU ポリシーが自動的に再適用されることはありません。

メンバーシップは追加式です。ユーザーは同時に複数のグループに所属できます。これは、コントロールの適用内容を決定する際に重要です。別のグループを追加すると、ユーザーが利用できるモデルアクセスが広がる場合があります。ACU では、有効なユーザーオーバーライドが優先されます。それ以外の場合、実効上限はチーム上限と正のグループ上限のうち低い方になります。

* 複数のグループで空でないモデル選択が設定されている場合、Cascade と Command ではそれぞれ和集合として扱われます。空の選択は影響しません。[モデルのプロビジョニング](/ja/federal/model-provisioning)を参照してください。
* 有効なユーザーオーバーライドが適用されない限り、実効 ACU 上限はチーム上限と正のグループ上限のうち低い方になります。[ACU 上限](/ja/federal/acu-limits)を参照してください。

<div id="delete-a-group">
  ## グループを削除する
</div>

グループのアクションメニューを開き、**グループを削除**を選択します。確認メッセージには、メンバーのチームアクセスは維持される一方、グループのモデル利用可否とACU上限は適用されなくなることが示されます。

グループを削除すると元に戻せません。メンバーシップとグループレベルの制御は削除されますが、メンバーのチームアカウントはそのまま残ります。

<AccordionGroup>
  <Accordion title="ユーザーは複数のグループに所属できますか？">
    はい。グループメンバーシップは追加式です。ユーザーが複数のグループに所属する場合、空でないモデル選択はCascadeとCommandごとに個別に統合されます。空の選択は影響しません。ACUについては、有効なユーザーオーバーライドが優先されます。それ以外の場合、実効上限はチーム上限と、正の値を持つグループ上限のうち最も低い値になります。
  </Accordion>

  <Accordion title="グループの変更が一部しか保存されない場合はどうなりますか？">
    モデル、ACU、メンバーシップの変更が完了する前に、グループが作成されることがあります。後続の操作が失敗した場合、ポータルには**警告付きでグループが作成されました**と表示され、適用されなかった変更が示されます。グループの詳細を確認し、未完了の変更を再試行してください。
  </Accordion>
</AccordionGroup>
