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

# Límites de ACU

> Establece límites de ACU para equipos, grupos y usuarios en despliegues federales.

<Info>
  Esta documentación corresponde a los despliegues federales de Devin. [Volver a la documentación de Devin](/es/get-started/devin-intro)
</Info>

Los límites de ACU controlan cuántas Unidades de Cómputo del Agente (ACU) puede consumir un usuario durante el ciclo de facturación del equipo. Los administradores federales pueden gestionar un límite predeterminado para el equipo, un límite por grupo y una anulación por usuario.

Para obtener información sobre cómo crear grupos y asignar miembros, consulta [Grupos](/es/federal/groups). Para conocer las restricciones de modelos que se pueden gestionar junto con los límites de ACU, consulta [Aprovisionamiento de modelos](/es/federal/model-provisioning).

***

<div id="the-three-acu-controls">
  ## Los tres controles de ACU
</div>

| Control                       | Ámbito                   | Comportamiento                                                                                         |
| ----------------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------ |
| **Límite de ACU del equipo**  | Cada usuario del equipo  | El límite de ACU predeterminado por usuario del equipo.                                                |
| **Límite de ACU del grupo**   | Cada miembro de un grupo | Un límite por miembro para ese grupo en cada ciclo de facturación. No es un pool compartido del grupo. |
| **Límite de ACU del usuario** | Un usuario               | Una anulación por usuario que prevalece sobre el límite del equipo y los límites de los grupos.        |

<div id="how-the-effective-limit-is-resolved">
  ### Cómo se determina el límite efectivo
</div>

El límite efectivo de un usuario es:

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

En otras palabras:

1. Si el usuario tiene una anulación por usuario válida, ese valor prevalece.
2. De lo contrario, se comparan el límite del equipo y el límite positivo de ACU más bajo entre los grupos del usuario.
3. Se aplica el menor de ambos límites.

Una anulación por usuario prevalece incluso cuando es superior al límite del equipo o a los límites de grupo del usuario. Los límites de grupo solo restringen a los usuarios que no tienen una anulación por usuario válida.

Si el usuario pertenece a varios grupos con límites positivos de ACU, el límite positivo más bajo constituye el componente de grupo del cálculo. El límite efectivo se sigue comparando con el límite del equipo. Los límites de grupo son límites por miembro, no una cantidad compartida que los miembros del grupo consumen conjuntamente.

<div id="zero-and-unset-values">
  ## Valores cero y no configurados
</div>

| Estado del control                            | Significado                                                                                  |
| --------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Límite del equipo establecido en `0`          | Se bloquea el uso de ACU para los usuarios sujetos al límite del equipo.                     |
| Anulación por usuario establecida en `0`      | Se bloquea el uso de ACU para ese usuario.                                                   |
| Límite de grupo del portal establecido en `0` | Se elimina el límite del grupo; no se considera un límite de grupo de cero ACU.              |
| Control no configurado                        | Ese control no aplica ninguna restricción. Aún pueden aplicarse otros controles pertinentes. |

El control de límite de ACU por grupo del portal acepta `cycle_acu_limit: 0` y elimina el límite del grupo. La operación `UpdateGroup` de la clave de servicio usa `set_cycle_acu_limit` y `clear_cycle_acu_limit`: el valor que se establezca debe ser finito y positivo, y se rechaza el cero en lugar de tratarlo como un límite de grupo que bloquea el uso. Un límite de usuario establecido en `0` sigue siendo un bloqueo explícito por usuario.

Un equipo con facturación por ACU puede no tener configurado ningún límite numérico. En ese caso, el límite del equipo no aplica ninguna restricción, a menos que se aplique un límite de grupo positivo o una anulación por usuario válida.

<div id="set-group-acu-caps">
  ## Establecer límites de ACU para grupos
</div>

Los límites de ACU para grupos se pueden configurar desde **Settings → Groups** cuando el equipo ya usa la facturación por ACU. La vista de detalles del grupo muestra el valor configurado por miembro o **Límite de ACU del equipo** cuando el grupo hereda la configuración del equipo.

Los límites de grupo no se pueden configurar hasta que el equipo tenga una configuración de facturación por ACU. El portal o la API pueden indicar:

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

El portal acepta límites de grupo finitos y no negativos; `0` elimina el límite. La API de gestión de grupos con clave de servicio requiere un `set_cycle_acu_limit` finito y positivo, y utiliza `clear_cycle_acu_limit` para eliminar la anulación.

<div id="set-user-overrides">
  ## Establecer anulaciones por usuario
</div>

Una anulación por usuario tiene prioridad sobre el límite del equipo y los límites de los grupos. Para que un usuario vuelva a la resolución normal de equipo/grupo, elimina la anulación. No establezcas un valor negativo: las anulaciones negativas por usuario se rechazan en cambios nuevos, y revertirlas implica eliminar la anulación.

Las configuraciones antiguas pueden contener valores heredados negativos. Estos valores se consideran una anulación por usuario no válida, por lo que se utilizan en su lugar los controles de equipo y grupo del usuario.

<div id="enforcement-and-reset-behavior">
  ## Aplicación y comportamiento de restablecimiento
</div>

El límite efectivo se verifica antes de realizar trabajo facturado en ACU. Cuando el uso del usuario en el ciclo actual alcanza o supera el límite efectivo, la solicitud se rechaza y el usuario ve:

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

Los límites se restablecen con el ciclo de facturación del equipo. La aplicación utiliza el período actual del ciclo de facturación configurado para el equipo, incluidas las fechas de inicio y finalización del ciclo actual.

Al deshabilitar o eliminar la configuración de facturación por ACU del equipo:

* Se eliminan la configuración de ACU del equipo y las anulaciones por usuario.
* Se eliminan los límites de ACU de los grupos.
* Se conservan los controles de modelos de los grupos.

Después de deshabilitar la facturación por ACU, las restricciones de modelos de los grupos siguen disponibles, aunque los límites de ACU de los grupos ya no se aplican.

<div id="viewing-acu-consumption-by-group">
  ## Consulta del consumo de ACU por grupo
</div>

Abre **Analytics → Uso del equipo** en el portal. Usa el selector de grupos para elegir un grupo y el selector de intervalo de fechas para elegir el período del informe. También puedes abrir una vista específica de un grupo con un parámetro de consulta `groupId` en la URL de Analytics.

Para los equipos con facturación por ACU, la página incluye:

* Una estadística resumida de **ACU utilizadas**.
* Una columna **ACU utilizadas** en la tabla por usuario.
* Nombre de usuario, correo electrónico, días activos, pestañas generadas, mensajes de Cascade, sesiones únicas de Cascade e IDE utilizados.

Analytics y la aplicación de límites usan conceptos temporales diferentes:

* Analytics informa de las ACU consumidas dentro del intervalo de fechas seleccionado, independientemente del ciclo de facturación.
* La aplicación de límites comprueba el uso con respecto al período actual del ciclo de facturación del equipo.

El consumo de ACU y los límites de ACU también se pueden consultar y gestionar mediante programación. Consulta la [API de consumo de ACU](/es/federal/api/acu-consumption) y la [API de límites de ACU de usuario](/es/federal/api/acu-caps).

<AccordionGroup>
  <Accordion title="¿Un límite de grupo crea un presupuesto compartido para el grupo?">
    No. Un límite de grupo se aplica por separado a cada miembro del grupo. Si tres usuarios comparten un límite de grupo de 100 ACU, cada usuario puede tener un límite de 100 ACU; no comparten un único pool de 100 ACU.
  </Accordion>

  <Accordion title="¿Qué límite prevalece cuando un usuario tiene varios controles?">
    Una anulación por usuario válida prevalece. Si no existe, el límite efectivo del usuario es el menor entre el límite del equipo y el límite de grupo positivo más bajo de sus grupos.
  </Accordion>

  <Accordion title="¿Cómo revierto una anulación por usuario?">
    Elimina la anulación por usuario. Los valores negativos no permiten heredar los controles del equipo y del grupo.
  </Accordion>

  <Accordion title="¿Por qué Analytics puede diferir del uso del ciclo actual?">
    Analytics sigue el intervalo de fechas seleccionado en el portal, mientras que la aplicación de límites usa el ciclo de facturación actual del equipo. Un intervalo de fechas puede incluir uso fuera del ciclo de aplicación actual.
  </Accordion>
</AccordionGroup>
