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

# Políticas de uso: limites de ACU por usuário

> Limite o consumo mensal de ACU de cada usuário com níveis de uso, mapeamentos de grupos do IdP, overrides por membro e solicitação de uso adicional.

As políticas de uso permitem que administradores do Enterprise limitem o consumo mensal de ACU de cada membro. O **uso local** (Devin Desktop, Devin CLI) e o **uso na nuvem** (sessões do Devin) de um membro são contabilizados em um único limite por usuário, e novos trabalhos são bloqueados em todas as interfaces quando o limite é atingido.

Gerencie as políticas de uso em [Configurações do Enterprise > Políticas de uso](https://app.devin.ai/settings/usage-policies).

<Note>
  Os limites de ACU por usuário estão em beta e precisam ser ativados para sua Enterprise. Entre em contato com a equipe responsável pela sua conta para ativá-los.
</Note>

Alguns pontos importantes:

* O gerenciamento de políticas de uso exige a permissão **Gerenciar limites de ACU** ou de administrador de faturamento.
* Os limites são redefinidos mensalmente, de acordo com o ciclo de faturamento do seu contrato (um contrato iniciado no dia 23 terá os limites redefinidos no dia 23).
* O uso do Devin Review não é contabilizado nos limites por usuário.
* Os limites por usuário são independentes dos [limites de ACU no nível da organização](/pt-BR/admin/billing/enterprise#setting-organization-acu-limits) — uma sessão é bloqueada se qualquer um dos limites for atingido.

<div id="usage-tiers">
  ## Níveis de uso
</div>

Um **nível de uso** é um grupo de membros com nome que compartilham a mesma alocação mensal de ACUs — por exemplo, uma equipe de engenharia, uma equipe de analistas de dados ou um grupo de administradores. Os níveis se aplicam a toda a Enterprise. A alocação é individual para cada membro; não se trata de um orçamento compartilhado pelo nível.

Você sempre tem um **nível padrão** — todos os membros são incluídos nele, a menos que sejam atribuídos a outro nível, inclusive aqueles que entrarem posteriormente. O primeiro nível criado se torna o padrão, e você pode alterar o nível padrão na lista de níveis.

<div id="guided-setup">
  ### Configuração guiada
</div>

Se você ainda não configurou os níveis ou está apenas começando, clique em **Configurar com recomendações** na página de níveis. Devin analisa o uso por membro nos seus últimos três ciclos de faturamento, sugere uma configuração completa com um nível para cada membro e permite editar tudo antes de aplicá-la. Uma simulação nativa mostra quem ultrapassaria o limite e o volume estimado de requisições, evitando surpresas.

<div id="creating-tiers-manually">
  ### Como criar níveis manualmente
</div>

1. Acesse **Configurações do Enterprise > Políticas de uso > Níveis de uso**.
2. Clique em **Adicionar nível**.
3. Dê um nome ao nível e defina uma **alocação mensal de uso** — o limite base de ACUs com o qual cada membro do nível começa em cada ciclo. Deixe em branco para não definir um limite.
4. Opcionalmente, configure o [uso adicional](#approval-policies) — como os membros deste nível podem receber mais ACUs.
5. Clique em **Criar nível**.

<div id="assign-members-to-a-tier">
  ### Atribuir membros a um nível
</div>

Abra um nível, vá até a aba **Membros** e clique em **Atribuir membro**. Ao mover um membro de outro nível, todas as configurações de override específicas desse membro são removidas, e ele passa a usar a alocação do nível de destino.

<div id="map-idp-groups-to-tiers">
  ### Mapear grupos do IdP a níveis
</div>

Em vez de atribuir membros individualmente, você pode mapear os grupos do seu provedor de identidade a níveis. Na página de níveis, clique em **Configurar mapeamentos de grupos**, depois em **Adicionar mapeamento** e selecione um grupo e um nível. Os membros herdam automaticamente o nível do grupo com base na associação ao grupo em tempo real da sua [integração com o IdP](/pt-BR/enterprise/security-access/idp-groups).

<div id="tier-priority">
  #### Prioridade dos níveis
</div>

Os grupos do IdP de um membro podem ser mapeados para vários níveis. Por isso, os níveis são ordenados por prioridade para resolver empates. Para classificá-los, clique em **Editar prioridade** na página de níveis e arraste-os para a ordem desejada — quanto mais próximo do topo, maior a prioridade. A prioridade determina apenas a precedência: um nível de maior prioridade pode ter uma alocação menor.

<div id="how-a-members-tier-is-resolved">
  ## Como o nível de um membro é definido
</div>

Um membro pode estar coberto por vários níveis ao mesmo tempo. O nível aplicável é definido nesta ordem:

1. **Nível atribuído explicitamente** — uma atribuição direta de nível prevalece sobre qualquer mapeamento de grupo.
2. **Nível de maior prioridade mapeado pelo IdP** — se os grupos de IdP do membro estiverem mapeados para vários níveis, prevalece o nível de maior prioridade.
3. **Nível padrão** — a alternativa para todos os demais.

Por exemplo, Ada faz parte de dois grupos de IdP: *Engineering*, mapeado para um nível de 500 ACUs, e *Platform*, mapeado para um nível de 1.000 ACUs que tem maior prioridade na lista de níveis. Ada fica no nível de 1.000 ACUs. Se um Admin a atribuir diretamente ao nível de 500 ACUs, essa atribuição prevalecerá e o limite dela passará a ser 500.

<div id="per-member-overrides">
  ## Overrides por membro
</div>

Os administradores podem aplicar um override ao limite de um membro sem alterar seu nível: na página **Membros**, clique no limite do membro e defina um novo valor.

* Um **override temporário** dura até o fim do ciclo de faturamento atual; depois, o membro retorna à base do seu nível. A data de expiração é exibida ao lado do override.
* Um **override permanente** permanece válido entre ciclos até que você o remova.

Um override altera apenas o valor do limite do membro — ele permanece em seu nível, que ainda define aspectos como sua [política de aprovação](#approval-policies) para uso adicional.

Antes de aplicar uma alteração que reduza limites, o Devin mostra uma prévia do impacto — quantos membros seriam bloqueados, teriam seus limites reduzidos ou não seriam afetados — para que você possa confirmar com todo o contexto.

<div id="additional-usage-requests">
  ## Requisições de uso adicionais
</div>

<div id="how-members-request-more-usage">
  ### Como os membros solicitam mais uso
</div>

Um membro que precisa de mais ACUs pode solicitar um aumento pelo botão **Solicitar mais** no gráfico de consumo de ACUs da página **My analytics** ou diretamente pelos avisos de limite exibidos quando se aproxima ou atinge o limite. Ele seleciona uma quantidade, pode adicionar um motivo e acompanhar ou cancelar a solicitação pendente. Os aumentos solicitados são sempre **temporários** — aplicam-se somente ao ciclo de faturamento atual.

<div id="approval-policies">
  ### Políticas de aprovação
</div>

A **política de aprovação** de cada nível controla o que acontece com as requisições dos membros:

| Política                           | Comportamento                                                                                                                                                                                                                                                                                                                                                                                             |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Aprovação manual**               | Todas as requisições aguardam a revisão de um administrador.                                                                                                                                                                                                                                                                                                                                              |
| **Sempre aprovar**                 | As requisições são aprovadas automaticamente até a **alocação máxima para aprovação automática** do nível.                                                                                                                                                                                                                                                                                                |
| **Aprovar com base na eficiência** | As requisições são aprovadas automaticamente até a alocação máxima para aprovação automática, mas somente enquanto a [pontuação de eficiência](#efficiency-scores) do membro for **Saudável** ou **Satisfatória**, e apenas em pequenos aumentos além do uso atual. Membros em boa situação, próximos do limite, também recebem aumentos automaticamente, sem precisar enviar uma requisição manualmente. |

A aprovação automática sempre beneficia o membro:

* As requisições nunca são negadas automaticamente — negar é sempre uma decisão do administrador. Uma requisição que não pode ser aprovada automaticamente simplesmente aguarda revisão.
* Uma requisição acima do limite de aprovação automática é concedida até esse limite para que o membro possa continuar trabalhando; o restante permanece pendente para um administrador.
* Um override permanente definido por um administrador nunca é substituído por uma aprovação automática.

<div id="efficiency-scores">
  ### Pontuações de eficiência
</div>

O Devin classifica o uso recente de sessões na nuvem de cada membro como **Saudável**, **Satisfatório** ou **Precisa melhorar**. Membros cujo uso recente é predominantemente local ou insuficiente para ser classificado aparecem como **Desconhecido** e não são elegíveis para aprovação automática com base na eficiência. Os membros podem ver sua própria pontuação — junto com dicas para melhorá-la — na página **My analytics**, e o [Devin Coach](/pt-BR/enterprise/features/devin-coach) ajuda a melhorá-la enquanto trabalham.

<div id="reviewing-requests">
  ### Revisão de requisições
</div>

Analise as requisições em **Políticas de uso > requisição de uso adicional**. As requisições pendentes são identificadas como **Bloqueada** (o solicitante atingiu seu limite) ou **Proativa** (solicitada antecipadamente), e você pode aprová-las ou negá-las individualmente ou em massa. Clique em uma requisição para ver o nível do membro, o limite atual, a mensagem e a pontuação de eficiência antes de decidir. Ao aprová-la, o aumento é concedido como um override temporário pelo restante do ciclo.

Admins com permissão para aprovar requisições são notificados por um aviso no app e por e-mail — imediatamente quando um solicitante está bloqueado ativamente e em um resumo diário para requisições proativas.

<div id="monitoring-members">
  ## Monitoramento de membros
</div>

A página **Políticas de uso > Membros** lista todos os membros com seu uso atual, limite, nível e origem do limite, ordenados por utilização para que os membros em risco apareçam primeiro. Os membros bloqueados são destacados, e você pode clicar em um membro para ver em detalhes seu uso e a eficiência da sessão no ciclo atual — um contexto útil antes de aprovar uma requisição ou ajustar um limite. Você também pode alterar diretamente o nível ou o override de um membro nesta página.

<div id="what-members-see-at-the-limit">
  ## O que os membros veem ao atingir o limite
</div>

Os membros recebem avisos cada vez mais enfáticos à medida que consomem sua alocação — uma notificação ao atingir cerca de dois terços do limite e, em seguida, banners persistentes à medida que se aproximam e atingem o limite. Quando bloqueados, veem uma mensagem explicando que o limite de ACUs por usuário foi excedido, com a ação **Solicitar mais ACUs**, que abre a caixa de diálogo de solicitação.

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

<AccordionGroup>
  <Accordion title="As políticas de uso substituem os limites de ACU no nível da organização?">
    Não. Os [limites no nível da organização](/pt-BR/admin/billing/enterprise#setting-organization-acu-limits) limitam o uso total de uma organização, enquanto as políticas de uso limitam cada membro individualmente. Ambos são aplicados de forma independente.
  </Accordion>

  <Accordion title="Um nível pode servir como orçamento compartilhado para uma equipe?">
    Não. A alocação de um nível se aplica individualmente a cada membro. Para ter um orçamento compartilhado, crie uma organização com um limite de ACU no nível da organização e atribua a equipe a ela.
  </Accordion>

  <Accordion title="Já definimos limites por usuário pela API. O que acontece com eles?">
    Os limites existentes definidos pela API aparecem na UI como overrides permanentes, e a API continua funcionando. Consulte a [referência da API de limites de ACU no nível do usuário](/pt-BR/admin/billing/user-acu-limits) para gerenciá-los programaticamente.
  </Accordion>

  <Accordion title="O Devin Review é contabilizado nos limites por usuário?">
    Não. O uso de ACU do Devin Review não é considerado nos limites por usuário.
  </Accordion>

  <Accordion title="Quando os limites são redefinidos?">
    No início de cada ciclo de faturamento mensal, que segue o ciclo do seu contrato. Overrides temporários e requisições aprovadas expiram nesse mesmo momento.
  </Accordion>
</AccordionGroup>
