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

# Limites de ACU

> Defina limites de ACU para equipes, grupos e usuários em implantações federais.

<Info>
  Esta documentação se aplica às implantações federais do Devin. [Voltar à documentação do Devin](/pt-BR/get-started/devin-intro)
</Info>

Os limites de ACU controlam quantas Unidades de Computação do Agente (ACUs) um usuário pode consumir durante o ciclo de faturamento da equipe. Os administradores federais podem gerenciar um limite padrão da equipe, um teto por grupo e uma substituição por usuário.

Para saber como criar grupos e atribuir membros, consulte [Grupos](/pt-BR/federal/groups). Para restrições de modelos que podem ser gerenciadas junto com os limites de ACU, consulte [Provisionamento de modelos](/pt-BR/federal/model-provisioning).

***

<div id="the-three-acu-controls">
  ## Os três controles de ACU
</div>

| Controle                     | Escopo                  | Comportamento                                                                                                         |
| ---------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Limite de ACU da equipe**  | Cada usuário da equipe  | O limite padrão de ACU por usuário da equipe.                                                                         |
| **Limite de ACU do grupo**   | Cada membro de um grupo | Um limite de ACU por membro desse grupo em cada ciclo de faturamento. Não se trata de um pool compartilhado do grupo. |
| **Limite de ACU do usuário** | Um usuário              | Um override por usuário que prevalece sobre o limite da equipe e os limites de ACU dos grupos.                        |

<div id="how-the-effective-limit-is-resolved">
  ### Como é determinado o limite efetivo
</div>

O limite efetivo de um usuário é:

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

Em outras palavras:

1. Se o usuário tiver um override de usuário válido, esse valor prevalece.
2. Caso contrário, comparam-se o limite da equipe e o menor limite positivo de ACU entre os grupos do usuário.
3. Aplica-se o menor desses limites.

Um override de usuário prevalece mesmo quando é maior que o limite da equipe ou os limites de ACU dos grupos do usuário. Os limites de ACU de grupo restringem apenas usuários que não têm um override de usuário válido.

Se o usuário pertencer a vários grupos com limites positivos de ACU, o menor limite positivo será o componente de grupo no cálculo. O limite efetivo ainda é comparado ao limite da equipe. Os limites de ACU de grupo são limites por membro, não uma quantidade compartilhada que os membros do grupo consomem em conjunto.

<div id="zero-and-unset-values">
  ## Valores zero e não definidos
</div>

| Estado do controle                                 | Significado                                                                                          |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Limite da equipe definido como `0`                 | O uso de ACU é bloqueado para usuários sujeitos ao limite da equipe.                                 |
| Override de usuário definido como `0`              | O uso de ACU é bloqueado para esse usuário.                                                          |
| Limite de ACU do grupo no portal definido como `0` | O limite de ACU do grupo é removido; não é tratado como um limite de grupo de zero ACU.              |
| Controle não definido                              | Esse controle não adiciona nenhuma aplicação. Outros controles aplicáveis ainda podem ser aplicados. |

O controle de limite de ACU do grupo no portal aceita `cycle_acu_limit: 0` e remove o limite de ACU do grupo. A operação `UpdateGroup` da chave de serviço usa `set_cycle_acu_limit` e `clear_cycle_acu_limit`: o valor definido deve ser finito e positivo, e zero é rejeitado em vez de ser tratado como um limite de ACU do grupo bloqueador. Um limite de ACU do usuário definido como `0` continua sendo um bloqueio explícito por usuário.

Uma equipe faturada por ACU pode não ter nenhum limite numérico configurado. Nesse caso, não há aplicação do limite da equipe, a menos que se aplique um limite de ACU do grupo positivo ou um override de usuário válido.

<div id="set-group-acu-caps">
  ## Definir limites de ACU para grupos
</div>

Os limites de ACU para grupos podem ser configurados em **Configurações → Grupos** quando a equipe já está no faturamento de ACU. A visualização dos detalhes do grupo mostra o valor configurado por membro ou **Limite de ACU da equipe** quando o grupo herda a configuração da equipe.

Os limites de grupo não podem ser configurados antes de a equipe ter uma configuração de faturamento de ACU. O portal ou a API pode informar:

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

O portal aceita limites por grupo finitos e não negativos; `0` remove o limite. A API de gerenciamento de grupos por chave de serviço exige que `set_cycle_acu_limit` seja finito e positivo e usa `clear_cycle_acu_limit` para remover o override.

<div id="set-user-overrides">
  ## Definir overrides de usuário
</div>

Um override de usuário tem precedência sobre o limite da equipe e os limites do grupo. Para retornar um usuário à resolução normal de equipe/grupo, remova o override. Não defina um valor negativo: overrides de usuário negativos são rejeitados em novas alterações, e reverter significa remover o override.

Configurações mais antigas podem conter valores legados negativos. Esses valores são tratados como ausência de override de usuário válido; portanto, são usados os controles de equipe e grupo do usuário.

<div id="enforcement-and-reset-behavior">
  ## Comportamento de aplicação e redefinição
</div>

O limite efetivo é verificado antes de qualquer trabalho cobrado em ACUs. Quando o uso do usuário no ciclo atual atinge ou excede o limite efetivo, a requisição é negada e o usuário vê:

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

Os limites são redefinidos conforme o ciclo de faturamento da equipe. A aplicação usa a janela atual do ciclo de faturamento configurada para a equipe, incluindo as datas de início e término do ciclo atual.

Ao desativar ou remover a configuração de faturamento de ACU da equipe:

* A configuração de ACU da equipe e os overrides de usuários são removidos.
* Os limites de ACU dos grupos são removidos.
* Os controles de modelo dos grupos são preservados.

Depois que o faturamento de ACU é desativado, as restrições de modelo dos grupos permanecem disponíveis, embora os limites de ACU dos grupos deixem de ser aplicados.

<div id="viewing-acu-consumption-by-group">
  ## Visualização do consumo de ACU por grupo
</div>

Abra **Análises → Uso da equipe** no portal. Use o seletor de grupos para escolher um grupo e o seletor de intervalo de datas para definir o período do relatório. Você também pode abrir uma visualização restrita a um grupo usando o parâmetro de consulta `groupId` no URL de Análises.

Para equipes faturadas por ACU, a página inclui:

* Uma estatística resumida de **ACUs usados**.
* Uma coluna **ACUs usados** na tabela por usuário.
* Nome do usuário, e-mail, dias ativos, abas geradas, mensagens do Cascade, sessões únicas do Cascade e IDEs usados.

Análises e aplicação usam conceitos de tempo diferentes:

* As análises informam os ACUs consumidos no intervalo de datas selecionado, independentemente do ciclo de faturamento.
* A aplicação verifica o uso em relação à janela atual do ciclo de faturamento da equipe.

O consumo de ACU e os limites de ACU também podem ser consultados e gerenciados de forma programática — consulte a [API de consumo de ACU](/pt-BR/federal/api/acu-consumption) e a [API de limites de ACU por usuário](/pt-BR/federal/api/acu-caps).

<AccordionGroup>
  <Accordion title="Um limite de grupo cria um orçamento compartilhado para o grupo?">
    Não. Um limite de grupo se aplica separadamente a cada membro do grupo. Se três usuários compartilham um limite de grupo de 100 ACUs, cada usuário pode ter um limite de 100 ACUs; eles não compartilham um único pool de 100 ACUs.
  </Accordion>

  <Accordion title="Qual limite prevalece quando um usuário tem vários controles?">
    Um override válido do usuário prevalece. Na ausência dele, o limite efetivo do usuário é o menor entre o limite da equipe e o menor limite positivo entre os grupos aos quais pertence.
  </Accordion>

  <Accordion title="Como reverter um override de usuário?">
    Remova o override do usuário. Valores negativos não são uma forma de herdar os controles da equipe e do grupo.
  </Accordion>

  <Accordion title="Por que as Análises podem diferir do uso no ciclo atual?">
    As Análises seguem o intervalo de datas selecionado no portal, enquanto a aplicação usa o ciclo de faturamento atual da equipe. Um intervalo de datas pode incluir uso fora do ciclo atual de aplicação.
  </Accordion>
</AccordionGroup>
