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

# Limites de ACU

> Controle o consumo de ACU do Devin com limites mensais por organização e por usuário gerenciados pela API V3 e pelo app web.

Administradores do Enterprise podem definir limites de Agent Compute Unit (ACU) para controlar o consumo em todo o Enterprise. Há dois tipos de limite, com estruturas diferentes:

|                     | [Limites no nível da organização](/pt-BR/admin/billing/org-acu-limits)                                                                                     | [Limites no nível do usuário](/pt-BR/admin/billing/user-acu-limits)                                                                                                        |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Limites máximos** | Uso total atribuído a uma organização                                                                                                                      | Uso de um usuário individual                                                                                                                                               |
| **Estrutura**       | Dividido por categoria de produto: um limite de **Local Agent** (Devin Desktop, Windsurf JetBrains, Devin CLI) e um limite de **Devin** (sessões em nuvem) | Uso **local e em nuvem** combinado sujeito a um único limite no nível da conta                                                                                             |
| **Gerenciado por**  | Limites por organização                                                                                                                                    | **Níveis**: cada usuário herda o limite de um nível — por atribuição explícita, mapeamento de grupo do IdP ou pelo nível padrão — a menos que tenha um override individual |

Os dois tipos são aplicados de forma independente — uma requisição é bloqueada se o limite do usuário ou o limite da organização relevante tiver sido atingido. Todos os limites são redefinidos automaticamente no início de cada **período mensal**.

* Consulte [Limites de ACU no nível da organização](/pt-BR/admin/billing/org-acu-limits) para orçamentos por organização e categoria de produto.
* Consulte [Limites de ACU no nível do usuário](/pt-BR/admin/billing/user-acu-limits) para níveis, mapeamentos de grupos do IdP, overrides por usuário, requisições de aumento de limite e limites efetivos.
* Consulte [Endpoints legados de limite de ACU do usuário](/pt-BR/admin/billing/legacy-user-acu-limits) para os endpoints obsoletos de limite por usuário e de limite de usuário padrão.

<div id="manage-limits-with-the-v3-api">
  ## Gerenciar limites com a API V3
</div>

Todas as requisições são autenticadas com um **token de usuário de serviço** Enterprise. Para ler as configurações de limite, é necessária a permissão de conta **ViewAccountConsumption**; para atualizar ou excluir as configurações de limite, é necessária a permissão de conta **ManageBilling** (assim como para ler as [solicitações de aumento de limite](/pt-BR/admin/billing/user-acu-limits#limit-increase-request-endpoints)). Use `https://api.devin.ai` como URL base. Consulte a [visão geral da API V3](/pt-BR/api-reference/v3/overview) para obter orientações sobre autenticação e usuários de serviço.

<div id="patch-semantics">
  ### Semântica do PATCH
</div>

Para os endpoints `PATCH`:

* Um campo omitido permanece inalterado.
* Um campo definido como `null` é removido.
* Um campo definido com um valor é criado ou atualizado.

<div id="frequently-asked-questions">
  ## Perguntas frequentes
</div>

<AccordionGroup>
  <Accordion title="Qual é a diferença entre os limites no nível da organização e no nível do usuário?">
    Os limites no nível da organização restringem o uso total atribuído a uma organização e são divididos por categoria de produto (Local Agent vs. sessões em nuvem do Devin). Os limites no nível do usuário restringem o uso combinado local e em nuvem de um usuário, no nível da conta, e são gerenciados por níveis. Os dois são aplicados de forma independente.
  </Accordion>

  <Accordion title="E se eu não definir nenhum limite?">
    Se nenhum limite for configurado, o uso não será restringido por esses controles de limite, sujeito ao seu plano Enterprise e aos termos de faturamento.
  </Accordion>

  <Accordion title="Posso definir um limite igual a zero?">
    Sim. Definir `cycle_acu_limit` como `0` bloqueia o uso nesse escopo até que o limite seja aumentado ou removido.
  </Accordion>

  <Accordion title="Com que frequência os limites são redefinidos?">
    Todos os limites são redefinidos mensalmente, com base no seu ciclo de faturamento.
  </Accordion>

  <Accordion title="Como posso encontrar IDs de usuários e organizações?">
    Recupere os IDs de usuários com `GET /v3/enterprise/members/users` e os IDs de organizações com `GET /v3/enterprise/organizations`, ou encontre-os em Configurações Enterprise no app web do Devin.
  </Accordion>

  <Accordion title="Posso definir limites no app web?">
    Sim, para ambos os tipos. Os limites no nível do usuário são gerenciados em Configurações Enterprise, em [Políticas de uso](/pt-BR/enterprise/features/usage-policies), onde os administradores podem criar e editar níveis, atribuir usuários a níveis e definir overrides por usuário permanentes ou temporários, além de revisar requisições de aumento de limite em **Solicitações de ACU**. Os limites do Devin no nível da organização podem ser gerenciados em [Faturamento Enterprise](/pt-BR/admin/billing/enterprise#setting-organization-acu-limits). No momento, os limites do Local Agent no nível da organização são gerenciados pela API V3. Administradores do Enterprise também podem visualizar o uso de ACU no ciclo atual por produto ou por usuário em Configurações Enterprise, em **Consumption**.
  </Accordion>
</AccordionGroup>