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

# Limiti ACU a livello di organizzazione

> Limita il consumo mensile di ACU per Local Agent e Devin di un'organizzazione

I limiti a livello di organizzazione stabiliscono un tetto all'utilizzo totale di ACU attribuito a un'organizzazione, per categoria di prodotto:

| Limite                          | Prodotti coperti                                           |
| ------------------------------- | ---------------------------------------------------------- |
| **Local Agent** (`local_agent`) | Devin Desktop, Windsurf JetBrains, Devin CLI               |
| **Devin** (`cloud_agent`)       | Sessioni cloud di Devin (web app, Slack, altre interfacce) |

Ogni organizzazione in un ambiente Enterprise può avere i propri limiti, consentendo agli amministratori di allocare budget tra team o progetti. Puoi anche gestire i limiti Devin a livello di organizzazione dalla web app; consulta [Fatturazione Enterprise](/it/admin/billing/enterprise#setting-organization-acu-limits).

I limiti a livello di organizzazione sono indipendenti dai [limiti a livello di utente](/it/admin/billing/user-acu-limits): una richiesta viene bloccata se viene raggiunto uno dei due limiti. Consulta [Limiti ACU](/it/admin/billing/acu-limits) per informazioni su autenticazione, autorizzazioni e semantica di `PATCH`, condivise da tutti gli endpoint di questa pagina.

<div id="billing-organization-attribution">
  ## Attribuzione all'organizzazione di fatturazione
</div>

L'utilizzo di Local Agent di ciascun utente viene conteggiato ai fini dell'**organizzazione di fatturazione**, che determina quale limite di Local Agent dell'organizzazione si applica. L'organizzazione di fatturazione viene determinata nel seguente ordine:

1. **Assegnazione esplicita:** un amministratore imposta `billing_org_id` nelle impostazioni ACU dell'utente tramite l'API.
2. **Determinazione automatica:** se non è presente un'assegnazione esplicita, viene utilizzata la prima organizzazione a cui l'utente può accedere tramite appartenenza diretta o assegnazione a un gruppo del provider di identità.

L'organizzazione di fatturazione principale di un utente determina anche quali [controlli di Local Agent](/it/enterprise/local/controls) si applicano.

Le assegnazioni esplicite dell'organizzazione di fatturazione vengono gestite tramite i [legacy user endpoints](/it/admin/billing/legacy-user-acu-limits#user-endpoints): il campo `billing_org_id` non è deprecato; lo è solo il campo del limite:

```bash theme={null}
curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/users/user_abc123/consumption/acu-limits" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"local_agent": {"billing_org_id": "org-xyz789"}}'
```

<div id="organization-endpoints">
  ## Endpoint dell'organizzazione
</div>

<div id="get-an-organizations-limits">
  ### Ottieni i limiti dell'organizzazione
</div>

```http theme={null}
GET /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits
```

**Corpo della risposta**

```json theme={null}
{
  "local_agent": {
    "cycle_acu_limit": 2000
  },
  "cloud_agent": {
    "cycle_acu_limit": 1000
  }
}
```

Un blocco agent viene omesso se non è impostato alcun limite per quella categoria di prodotti.

<div id="update-an-organizations-limits">
  ### Aggiorna i limiti di un'organizzazione
</div>

```http theme={null}
PATCH /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits
```

**Corpo della richiesta — imposta i limiti per Local Agent e Devin**

```json theme={null}
{
  "local_agent": {
    "cycle_acu_limit": 2000
  },
  "cloud_agent": {
    "cycle_acu_limit": 1000
  }
}
```

**Corpo della richiesta — azzera solo il limite del Local Agent**

Imposta `local_agent` su `null` senza modificare il limite di Devin:

```json theme={null}
{
  "local_agent": null
}
```

L'endpoint restituisce HTTP `204` in caso di successo.

<div id="delete-an-organizations-limits">
  ### Elimina i limiti di un'organizzazione
</div>

Questa operazione rimuove i limiti sia di Local Agent sia di Devin per l'organizzazione.

```http theme={null}
DELETE /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits
```

L'endpoint restituisce HTTP `204` in caso di successo.

<div id="example-workflows">
  ## Esempi di flussi di lavoro
</div>

<div id="set-up-organization-level-local-agent-limits">
  ### Configura i limiti di Local Agent a livello di organizzazione
</div>

Imposta un budget a livello di organizzazione per l'utilizzo complessivo di Devin Desktop, Windsurf JetBrains e Devin CLI:

```bash theme={null}
curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/organizations/org-xyz789/consumption/acu-limits" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"local_agent": {"cycle_acu_limit": 5000}}'
```

<div id="set-up-organization-level-devin-limits">
  ### Configura i limiti di Devin a livello di organizzazione
</div>

Imposta un budget per le sessioni cloud di Devin per un'organizzazione:

```bash theme={null}
curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/organizations/org-xyz789/consumption/acu-limits" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cloud_agent": {"cycle_acu_limit": 1000}}'
```

<div id="frequently-asked-questions">
  ## Domande frequenti
</div>

<AccordionGroup>
  <Accordion title="Che cos'è l'attribuzione all'organizzazione di fatturazione?">
    L'attribuzione all'organizzazione di fatturazione determina in quale organizzazione rientra, ai fini del limite di Local Agent, l'utilizzo di Devin Desktop, Windsurf JetBrains e Devin CLI da parte di un utente. Se non viene assegnata esplicitamente, viene attribuita automaticamente alla prima organizzazione a cui l'utente può accedere.
  </Accordion>

  <Accordion title="Cosa succede quando un'organizzazione raggiunge un limite?">
    I nuovi lavori vengono bloccati nei prodotti di quella categoria per gli utenti dell'organizzazione: prodotti Local Agent per il limite `local_agent` e sessioni cloud di Devin per il limite `cloud_agent`, finché il limite non viene modificato o l'utilizzo non si reimposta nella finestra mensile successiva.
  </Accordion>
</AccordionGroup>