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

# ACU 上限

> 連邦政府向け導入環境で、チーム、グループ、ユーザーごとの ACU 上限を設定します。

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

ACU 上限は、チームの請求サイクル中にユーザーが消費できる Agent Compute Unit (ACU) の量を制御します。連邦政府向け管理者は、チームのデフォルト値、グループごとの上限、ユーザーオーバーライドを管理できます。

グループの作成とメンバーの割り当てについては、[グループ](/ja/federal/groups)を参照してください。ACU 上限と併せて管理できるモデルの制限については、[モデルのプロビジョニング](/ja/federal/model-provisioning)を参照してください。

***

<div id="the-three-acu-controls">
  ## 3つのACU管理項目
</div>

| 管理項目           | 適用範囲          | 動作                                                   |
| -------------- | ------------- | ---------------------------------------------------- |
| **チームのACU上限**  | チームの各ユーザー     | チームにおけるユーザーごとのデフォルトACU上限。                            |
| **グループのACU上限** | 1つのグループの各メンバー | 請求サイクルごとに適用される、そのグループのメンバーごとの上限。グループで共有するプールではありません。 |
| **ユーザーのACU上限** | 1人のユーザー       | チームの上限およびグループの上限より優先される、ユーザーオーバーライド。                 |

<div id="how-the-effective-limit-is-resolved">
  ### 有効な上限の決定方法
</div>

ユーザーに適用される有効な上限は、次のとおりです。

```text theme={null}
valid user override ?? min(team limit, lowest positive group cap)
```

言い換えると:

1. ユーザーに有効なユーザーオーバーライドがある場合は、その値が無条件で適用されます。
2. それ以外の場合は、チームの上限と、ユーザーが属するグループの正のグループのACU上限のうち最も低い値を比較します。
3. そのうち低い方の上限が適用されます。

ユーザーオーバーライドは、チームの上限やユーザーが属するグループのACU上限より高い場合でも優先されます。グループのACU上限が制限するのは、有効なユーザーオーバーライドがないユーザーだけです。

ユーザーが正のグループのACU上限を持つ複数のグループに属している場合、最も低い正の上限が計算上のグループ側の値になります。有効な上限は引き続きチームの上限と比較されます。グループのACU上限はメンバーごとの上限であり、グループメンバーが共同で消費する共有枠ではありません。

<div id="zero-and-unset-values">
  ## ゼロ値と未設定値
</div>

| コントロールの状態                     | 意味                                              |
| ----------------------------- | ----------------------------------------------- |
| Team の上限が `0` に設定されている        | Team の上限が適用されるユーザーの ACU 使用量はブロックされます。           |
| ユーザーオーバーライドが `0` に設定されている     | そのユーザーの ACU 使用量はブロックされます。                       |
| ポータルのグループのACU上限が `0` に設定されている | グループのACU上限はクリアされ、ACU がゼロのグループのACU上限とは見なされません。   |
| コントロールが未設定                    | そのコントロールは適用されません。他の該当するコントロールは引き続き適用される場合があります。 |

ポータルのグループ ACU 上限コントロールは `cycle_acu_limit: 0` を受け付け、グループのACU上限をクリアします。サービスキーの `UpdateGroup` 操作では、`set_cycle_acu_limit` と `clear_cycle_acu_limit` を使用します。設定値は有限の正数である必要があり、ゼロはグループのACU上限をブロックする値としてではなく、無効な値として拒否されます。`0` に設定されたユーザー上限は、ユーザーごとの明示的なブロックとして維持されます。

ACU課金対象の Team には、数値上限が設定されていない場合があります。その場合、正のグループのACU上限または有効なユーザーオーバーライドが適用されない限り、Team 上限は適用されません。

<div id="set-group-acu-caps">
  ## グループの ACU 上限を設定する
</div>

チームがすでに ACU 課金を利用している場合は、**Settings → Groups** からグループの ACU 上限を設定できます。グループの詳細画面には、設定済みのメンバーごとの値、またはグループがチーム設定を継承している場合は **チームのACU上限** が表示されます。

チームに ACU 課金設定がない場合、グループの上限は設定できません。ポータルまたは API で次の内容が報告されることがあります。

```text theme={null}
team is not on ACU billing
```

ポータルでは、有限の非負のグループ上限値を設定できます。`0` を指定すると上限が解除されます。サービスキーのグループ管理 API では、有限の正の `set_cycle_acu_limit` が必要です。オーバーライドを解除するには、`clear_cycle_acu_limit` を使用します。

<div id="set-user-overrides">
  ## ユーザーごとのオーバーライドを設定する
</div>

ユーザーオーバーライドは、チームの上限およびグループのACU上限よりも優先されます。ユーザーを通常のチーム/グループによる解決に戻すには、オーバーライドを削除します。負の値は設定しないでください。新たな変更で負のユーザーオーバーライドを設定しようとすると拒否され、復元するにはオーバーライドを削除する必要があります。

古い構成には、負のレガシー値が含まれている場合があります。これらの値は有効なユーザーオーバーライドがないものとして扱われるため、代わりにユーザーのチームおよびグループのコントロールが適用されます。

<div id="enforcement-and-reset-behavior">
  ## 適用とリセットの動作
</div>

有効な上限は、ACU課金対象の作業を開始する前に確認されます。ユーザーの現在のサイクルにおける使用量が有効な上限に達しているか超えている場合、リクエストは拒否され、ユーザーには次の内容が表示されます。

```text theme={null}
monthly acu limit reached
```

上限はチームの請求サイクルに合わせてリセットされます。適用には、現在のサイクル開始日と終了日を含む、チームに設定されている現在の請求サイクル期間が使用されます。

チームのACU課金設定を無効化または削除すると、次のようになります。

* チームの ACU 設定とユーザーオーバーライドがクリアされます。
* グループの ACU 上限がクリアされます。
* グループのモデル制御は維持されます。

ACU課金を無効にした後も、グループの ACU 上限は適用されなくなりますが、グループのモデル制限は引き続き利用できます。

<div id="viewing-acu-consumption-by-group">
  ## グループ別のACU消費量を確認する
</div>

ポータルで**Analytics → Team Usage**を開きます。グループセレクターでグループを選択し、日付範囲セレクターでレポート期間を選択します。Analytics URLに`groupId`クエリパラメータを指定して、グループにスコープされたビューを開くこともできます。

ACU課金対象のチームでは、ページに以下が表示されます。

* **使用済みACU**のサマリー統計。
* ユーザー別テーブルの**使用済みACU**列。
* ユーザー名、メールアドレス、アクティブ日数、生成されたタブ、Cascadeメッセージ、一意のCascadeセッション、使用したIDE。

Analyticsと適用では、時間の扱いが異なります。

* Analyticsでは、請求サイクルに関係なく、選択した日付範囲内で消費されたACUをレポートします。
* 適用では、チームの現在の請求サイクル期間に対して使用量を確認します。

ACU消費量とACU上限は、プログラムからクエリおよび管理することもできます。詳細は[ACU Consumption API](/ja/federal/api/acu-consumption)および[User ACU Caps API](/ja/federal/api/acu-caps)を参照してください。

<AccordionGroup>
  <Accordion title="グループのACU上限によってグループ共有の予算が作成されますか？">
    いいえ。グループのACU上限は、グループの各メンバーに個別に適用されます。3人のユーザーに100 ACUのグループのACU上限が設定されている場合、各ユーザーにはそれぞれ100 ACUの上限が適用されます。100 ACUのプールを1つ共有するわけではありません。
  </Accordion>

  <Accordion title="ユーザーに複数のControlsがある場合、どの上限が優先されますか？">
    有効なユーザーオーバーライドがある場合、それが優先されます。ない場合、ユーザーの有効な上限は、チーム上限と、所属するグループのうち最も低い正のグループのACU上限のいずれか低い方になります。
  </Accordion>

  <Accordion title="ユーザーオーバーライドを復元するにはどうすればよいですか？">
    ユーザーオーバーライドを削除します。負の値を指定しても、チームおよびグループのControlsは継承されません。
  </Accordion>

  <Accordion title="Analyticsが現在のサイクルの使用量と異なることがあるのはなぜですか？">
    Analyticsはポータルで選択した日付範囲に従いますが、適用ではチームの現在の請求サイクルを使用します。日付範囲には、現在の適用サイクル外の使用量が含まれる場合があります。
  </Accordion>
</AccordionGroup>