> ## 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 限额

> 为联邦部署设置团队、组和用户的 ACU 限额。

<Info>
  本文档适用于 Devin 的联邦部署。[返回 Devin 文档](/zh/get-started/devin-intro)
</Info>

ACU 限额用于控制用户在团队账单周期内可消耗的 Agent Compute Unit (ACU) 数量。联邦管理员可以管理团队默认限额、每组限额以及用户级覆盖设置。

有关创建组和分配成员的信息，请参阅[组](/zh/federal/groups)。有关可与 ACU 限额一并管理的模型限制，请参阅[模型预配](/zh/federal/model-provisioning)。

***

<div id="the-three-acu-controls">
  ## 三项 ACU 控制
</div>

| 控制项           | 作用域       | 行为                               |
| ------------- | --------- | -------------------------------- |
| **团队 ACU 限额** | 团队中的每位用户  | 团队默认的用户级 ACU 限额。                 |
| **组 ACU 上限**  | 某个组中的每位成员 | 该组每位成员在每个账单周期内的 ACU 上限，并非组共享资源池。 |
| **用户 ACU 上限** | 单个用户      | 用户覆盖，优先于团队限额和组上限。                |

<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 上限的组，则其中最低的正上限作为计算中的组限额。最终限额仍需与团队限额比较。组上限是每位成员的限额，并非由组成员共同消耗的共享额度。

<div id="zero-and-unset-values">
  ## 零值和未设置值
</div>

| 控制状态             | 含义                          |
| ---------------- | --------------------------- |
| 团队限额设为 `0`       | 对适用该团队限额的用户，ACU 用量将被阻止。     |
| 用户覆盖设为 `0`       | 该用户的 ACU 用量将被阻止。            |
| Portal 组上限设为 `0` | 组上限将被清除；不会被视为 ACU 限额为零的组限额。 |
| 控制未设置            | 该控制不施加任何限制。其他适用的控制仍可生效。     |

Portal 的组 ACU 限额控制接受 `cycle_acu_limit: 0`，并会清除组上限。服务密钥 `UpdateGroup` 操作使用 `set_cycle_acu_limit` 和 `clear_cycle_acu_limit`：设置值必须是有限的正数，`0` 会被拒绝，而不会被视为用于阻止的组上限。设为 `0` 的用户上限仍表示明确禁止该用户使用。

按 ACU 计费的团队可以不配置数值限额。在这种情况下，除非存在正数的组上限或有效的用户覆盖，否则团队限额不会施加任何限制。

<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>

用户覆盖的优先级高于团队限额和组上限。要让用户恢复为按常规团队/组规则处理，请移除该覆盖。请勿设置负值：系统会拒绝新增的负值用户覆盖；如需还原，只需移除该覆盖。

较早的配置可能包含负的旧版值。这些值会被视为不存在有效的用户覆盖，因此会改用该用户的团队和组控制。

<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](/zh/federal/api/acu-consumption) 和 [User ACU Caps API](/zh/federal/api/acu-caps)。

<AccordionGroup>
  <Accordion title="组上限是否会形成共享的组预算？">
    不会。组上限会分别应用于组内每位成员。如果三名用户共享 100 ACU 的组上限，每位用户的上限都可以解析为 100 ACU；他们并非共享一个 100 ACU 的池。
  </Accordion>

  <Accordion title="当用户受到多项控制时，以哪个限制为准？">
    有效的用户覆盖具有最高优先级。如果没有用户覆盖，用户的有效限额取团队限额与其所属各组中最低的正数组上限两者中的较低值。
  </Accordion>

  <Accordion title="如何撤销用户覆盖？">
    删除用户覆盖。负值无法用于继承团队和组控制设置。
  </Accordion>

  <Accordion title="为什么 Analytics 可能与当前账单周期的用量不同？">
    Analytics 依据门户中选择的日期范围，而强制执行使用团队当前的账单周期。日期范围可能包含当前强制执行周期之外的用量。
  </Accordion>
</AccordionGroup>