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

# Limiti ACU

> Imposta limiti ACU per team, gruppi e utenti nelle distribuzioni federali.

<Info>
  Questa documentazione riguarda le distribuzioni federali di Devin. [Torna alla documentazione di Devin](/it/get-started/devin-intro)
</Info>

I limiti ACU regolano il numero di Agent Compute Unit (ACU) che un utente può consumare durante il ciclo di fatturazione del team. Gli amministratori federali possono gestire un limite predefinito per il team, un limite per gruppo e un override per utente.

Per informazioni sulla creazione di gruppi e l'assegnazione dei membri, consulta [Gruppi](/it/federal/groups). Per informazioni sulle restrizioni dei modelli gestibili insieme ai limiti ACU, consulta [Provisioning dei modelli](/it/federal/model-provisioning).

***

<div id="the-three-acu-controls">
  ## I tre controlli ACU
</div>

| Controllo                  | Ambito                   | Comportamento                                                                                                   |
| -------------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------- |
| **Limite ACU del team**    | Ogni utente del team     | Il limite ACU predefinito per ciascun utente del team.                                                          |
| **Limite ACU del gruppo**  | Ogni membro di un gruppo | Un limite per ciascun membro di quel gruppo per ogni ciclo di fatturazione. Non è un pool condiviso del gruppo. |
| **Limite ACU dell'utente** | Un utente                | Un override per utente che prevale sul limite del team e sui limiti del gruppo.                                 |

<div id="how-the-effective-limit-is-resolved">
  ### Come viene determinato il limite effettivo
</div>

Il limite effettivo per un utente è:

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

In parole semplici:

1. Se l'utente ha un override utente valido, prevale quel valore.
2. In caso contrario, vengono confrontati il limite del team e il limite ACU positivo più basso tra i gruppi dell'utente.
3. Si applica il più basso tra questi limiti.

Un override utente prevale anche se è superiore al limite del team o ai limiti dei gruppi dell'utente. I limiti dei gruppi si applicano solo agli utenti che non dispongono di un override utente valido.

Se l'utente appartiene a più gruppi con limiti ACU positivi, il limite positivo più basso costituisce la componente relativa ai gruppi del calcolo. Il limite effettivo viene comunque confrontato con il limite del team. I limiti dei gruppi sono limiti per membro, non un importo condiviso che i membri del gruppo consumano insieme.

<div id="zero-and-unset-values">
  ## Valori zero e non impostati
</div>

| Stato del controllo                            | Significato                                                                                             |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Limite del team impostato su `0`               | L'utilizzo di ACU è bloccato per gli utenti soggetti al limite del team.                                |
| Override utente impostato su `0`               | L'utilizzo di ACU è bloccato per quell'utente.                                                          |
| Limite del gruppo nel portale impostato su `0` | Il limite del gruppo viene rimosso; non viene considerato un limite di gruppo pari a zero ACU.          |
| Controllo non impostato                        | Questo controllo non impone alcuna limitazione. Possono comunque applicarsi altri controlli pertinenti. |

Il controllo del limite di ACU del gruppo nel portale accetta `cycle_acu_limit: 0` e rimuove il limite del gruppo. L'operazione `UpdateGroup` della chiave di servizio utilizza `set_cycle_acu_limit` e `clear_cycle_acu_limit`: il valore impostato deve essere finito e positivo; lo zero viene rifiutato anziché essere considerato un limite di gruppo bloccante. Un limite utente impostato su `0` rimane un blocco esplicito per utente.

Un team con fatturazione in ACU può non avere alcun limite numerico configurato. In tal caso, il limite del team non impone alcuna limitazione, a meno che non si applichi un limite di gruppo positivo o un override utente valido.

<div id="set-group-acu-caps">
  ## Impostare i limiti ACU per gruppo
</div>

I limiti ACU per gruppo possono essere configurati in **Settings → Gruppi** quando il team utilizza già la fatturazione ACU. La vista dei dettagli del gruppo mostra il valore configurato per membro oppure **Limite ACU del team** se il gruppo eredita l'impostazione del team.

I limiti per gruppo non possono essere configurati finché il team non dispone di una configurazione di fatturazione ACU. Il portale o l'API possono riportare:

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

Il portale accetta limiti di gruppo finiti e non negativi; `0` azzera il limite. L'API di gestione dei gruppi con chiave di servizio richiede che `set_cycle_acu_limit` sia finito e positivo e usa `clear_cycle_acu_limit` per rimuovere l'override.

<div id="set-user-overrides">
  ## Impostare gli override utente
</div>

Un override utente ha la precedenza sia sul limite del team sia sui limiti del gruppo. Per ripristinare la normale risoluzione di team e gruppo per un utente, rimuovi l'override. Non impostare un valore negativo: gli override utente negativi vengono rifiutati per le nuove modifiche e il ripristino richiede la rimozione dell'override.

Le configurazioni meno recenti possono contenere valori legacy negativi. Tali valori non sono considerati override utente validi, pertanto vengono utilizzati i controlli del team e del gruppo dell'utente.

<div id="enforcement-and-reset-behavior">
  ## Comportamento di applicazione e reimpostazione
</div>

Il limite effettivo viene verificato prima di eseguire attività fatturate in ACU. Quando l'utilizzo dell'utente nel ciclo corrente è pari o superiore al limite effettivo, la richiesta viene rifiutata e l'utente visualizza:

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

I limiti si reimpostano a ogni ciclo di fatturazione del team. L'applicazione utilizza l'intervallo del ciclo di fatturazione corrente configurato per il team, incluse le date di inizio e fine del ciclo corrente.

La disabilitazione o la rimozione della configurazione di fatturazione ACU del team:

* Cancella la configurazione ACU del team e gli override a livello di utente.
* Cancella i limiti ACU dei gruppi.
* Mantiene i controlli sui modelli dei gruppi.

Dopo la disabilitazione della fatturazione ACU, le restrizioni sui modelli dei gruppi restano disponibili, anche se i limiti ACU dei gruppi non vengono più applicati.

<div id="viewing-acu-consumption-by-group">
  ## Visualizzazione del consumo di ACU per gruppo
</div>

Apri **Analytics → Utilizzo del team** nel portale. Usa il selettore dei gruppi per scegliere un gruppo e quello dell'intervallo di date per selezionare il periodo di riferimento. Puoi anche aprire una vista limitata a un gruppo usando il parametro di query `groupId` nell'URL di Analytics.

Per i team con fatturazione in ACU, la pagina include:

* Una statistica riepilogativa **ACU utilizzate**.
* Una colonna **ACU utilizzate** nella tabella per utente.
* Nome utente, email, giorni attivi, schede generate, messaggi Cascade, sessioni Cascade uniche e IDE utilizzati.

Analytics e l'applicazione utilizzano riferimenti temporali diversi:

* Analytics riporta le ACU consumate nell'intervallo di date selezionato, indipendentemente dal ciclo di fatturazione.
* L'applicazione confronta l'utilizzo con la finestra del ciclo di fatturazione corrente del team.

Il consumo di ACU e i limiti ACU possono essere recuperati e gestiti anche a livello di programmazione: consulta l'[API del consumo di ACU](/it/federal/api/acu-consumption) e l'[API dei limiti ACU per utente](/it/federal/api/acu-caps).

<AccordionGroup>
  <Accordion title="Un limite di gruppo crea un budget condiviso per il gruppo?">
    No. Un limite di gruppo si applica separatamente a ciascun membro del gruppo. Se tre utenti hanno un limite di gruppo di 100 ACU, ogni utente può avere un limite di 100 ACU; non condividono un unico pool di 100 ACU.
  </Accordion>

  <Accordion title="Quale limite prevale quando un utente ha più controlli?">
    Un override utente valido prevale sempre. In assenza di override, il limite effettivo dell'utente è il minore tra il limite del team e il limite di gruppo positivo più basso tra i gruppi di cui fa parte.
  </Accordion>

  <Accordion title="Come posso annullare un override utente?">
    Rimuovi l'override utente. I valori negativi non consentono di ereditare i controlli del team e del gruppo.
  </Accordion>

  <Accordion title="Perché Analytics può differire dall'utilizzo del ciclo corrente?">
    Analytics segue l'intervallo di date selezionato nel portale, mentre l'applicazione usa il ciclo di fatturazione corrente del team. Un intervallo di date può includere utilizzo esterno al ciclo di applicazione corrente.
  </Accordion>
</AccordionGroup>
