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

# Grupos

> Gerencie a associação à equipe, a disponibilidade de modelos e os limites de ACU por grupo.

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

Os grupos permitem que administradores do Enterprise federal visualizem análises desagregadas e criem políticas direcionadas, como disponibilidade de modelos e limites de ACU, para membros selecionados de uma equipe. Os grupos têm escopo de equipe: não criam uma equipe separada nem alteram o acesso de um membro ao restante da equipe.

Os grupos estão disponíveis na implantação federal auto-hospedada e multilocatária. Um administrador do site pode acessá-los. Caso contrário, sua função precisa ter **Teams Update** e **Teams Read-Only** ou **Analytics Read** para que o portal exiba a lista de membros da equipe. Apenas **Teams Update** pode não ser suficiente, e sua função também precisa ter permissão para abrir as Configurações. Os grupos também podem ser gerenciados programaticamente com a [API de gerenciamento de grupos](/pt-BR/federal/api/group-management) ou o [SDK Python](/pt-BR/federal/api/python-sdk).

***

<div id="open-group-management">
  ## Abrir o gerenciamento de grupos
</div>

No [portal federal](https://windsurf.fedstart.com/settings), acesse **Configurações → Grupos**. A aba Grupos está disponível para funções que atendem aos requisitos de acesso descritos acima em implantações multilocatário.

A tabela de grupos inclui:

| Coluna            | Descrição                                                                                       |
| ----------------- | ----------------------------------------------------------------------------------------------- |
| **Nome**          | O nome do grupo.                                                                                |
| **Membros**       | O número de membros da equipe no grupo.                                                         |
| **Limite de ACU** | O limite de ACU por membro do grupo. Esta coluna é exibida para equipe com faturamento por ACU. |
| **Modelos**       | A disponibilidade dos modelos Cascade e Command configurada para o grupo.                       |

Selecione uma linha de grupo para abrir seus detalhes. A visualização de detalhes mostra o nome do grupo, o número de membros, o limite de ACU configurado, a disponibilidade dos modelos e os usuários.

<div id="create-a-group">
  ## Criar um grupo
</div>

Selecione **Criar grupo** para abrir o assistente, que orienta você pelas seguintes etapas:

1. **Nomeie o grupo** — Insira um nome como `Engineering`.
2. **Selecione modelos** — Escolha quais modelos Cascade e Command os membros poderão usar.
3. **Defina o limite de ACU** — Defina um limite por membro para cada ciclo de faturamento. Esta etapa é exibida apenas para equipes com faturamento por ACU.
4. **Adicione usuários** — Opcionalmente, adicione membros da equipe agora. Você poderá adicionar ou remover membros mais tarde.

Uma seleção de modelos vazia significa **nenhuma preferência** em relação ao acesso de um membro aos modelos. Ela não substitui a restrição de outro grupo. Uma política de modelos de grupo só se aplica quando pelo menos um dos grupos do usuário especifica uma seleção de modelos para uma superfície. Caso contrário, o usuário recebe os modelos disponíveis para a equipe. Para conhecer o comportamento completo dos modelos, consulte [Provisionamento de modelos](/pt-BR/federal/model-provisioning).

Para equipes com faturamento por ACU, os tetos de grupo só podem ser configurados após a equipe ter uma configuração de faturamento por ACU. O portal rejeita valores negativos ou não finitos e exibe **Insira um limite de ACU não negativo** quando a entrada é inválida.

Se uma etapa posterior falhar depois que o grupo for criado, o portal poderá exibir **Grupo criado com avisos**. O grupo continuará disponível, mas uma ou mais alterações solicitadas de modelos, ACU ou associação poderão não ter sido aplicadas. Selecione **Ir para o grupo** para revisar e concluir as alterações.

<div id="name-and-edit-a-group">
  ## Nomeie e edite um grupo
</div>

Os espaços em branco nos nomes dos grupos são removidos antes de serem salvos. É obrigatório informar um nome, e os nomes devem ser exclusivos na equipe. Os seguintes nomes são reservados e não podem ser usados:

* `All Users`
* `All Indexes`

Os nomes são verificados sem diferenciar maiúsculas de minúsculas; portanto, `all users` e `All Users` são tratados como o mesmo nome reservado.

Se o nome estiver em branco, o portal exibirá **O nome do grupo é obrigatório**. Se houver uma duplicata que difira apenas em maiúsculas e minúsculas, exibirá **Já existe um grupo com este nome**.

Abra o menu de ações do grupo e selecione **Editar grupo** para alterar o nome do grupo ou o limite de ACU. Na seção Modelos, selecione **Editar modelos** para alterar a disponibilidade do Cascade ou do Command.

<div id="manage-members">
  ## Gerenciar membros
</div>

Na visualização de detalhes do grupo, selecione **Adicionar usuário** para abrir a caixa de diálogo **Adicionar usuários**. Selecione os membros da equipe que devem fazer parte do grupo e, em seguida, selecione **Salvar**. Você também pode selecionar **Remover** ao lado de um membro e confirmar a remoção.

Somente membros da equipe do grupo podem ser adicionados. Remover alguém de um grupo não o remove da equipe. A pessoa mantém o acesso à equipe; apenas os controles atribuídos por esse grupo deixam de se aplicar. A administração de grupos tem escopo de equipe; portanto, uma permissão concedida apenas para um grupo não dá acesso para gerenciar esse grupo nem outros grupos.

Quando um usuário é removido da equipe, suas associações a grupos também são excluídas. Se ele voltar a fazer parte da equipe posteriormente, as políticas de modelo e de ACU do grupo anterior não serão reaplicadas automaticamente.

A associação é aditiva. Um usuário pode pertencer a vários grupos ao mesmo tempo. Isso é importante na resolução dos controles. Adicionar outro grupo pode ampliar o acesso efetivo do usuário a modelos. Para ACU, um override de usuário válido prevalece; caso contrário, o limite efetivo é o menor entre o limite da equipe e o menor teto positivo entre os grupos:

* As seleções de modelos não vazias de vários grupos são unificadas separadamente para Cascade e Command. Seleções vazias não têm efeito. Consulte [Provisionamento de modelos](/pt-BR/federal/model-provisioning).
* O limite efetivo de ACU é o menor entre o limite da equipe e o menor teto positivo entre os grupos, a menos que haja um override de usuário válido. Consulte [Limites de ACU](/pt-BR/federal/acu-limits).

<div id="delete-a-group">
  ## Excluir um grupo
</div>

Abra o menu de ações do grupo e selecione **Excluir grupo**. A mensagem de confirmação explica que os membros mantêm o acesso à equipe, mas a disponibilidade de modelos e o limite de ACU do grupo deixam de se aplicar.

A exclusão de um grupo não pode ser desfeita. A associação e os controles no nível do grupo são removidos, enquanto as contas de equipe dos membros permanecem intactas.

<AccordionGroup>
  <Accordion title="Um usuário pode pertencer a mais de um grupo?">
    Sim. A associação a grupos é aditiva. Quando um usuário pertence a vários grupos, as seleções de modelos não vazias são combinadas separadamente para Cascade e Command. Uma seleção vazia não tem efeito. Para ACU, um override válido do usuário prevalece; caso contrário, o limite efetivo é o menor entre o limite da equipe e o menor teto positivo entre os grupos.
  </Accordion>

  <Accordion title="O que acontece se uma alteração de grupo for salva apenas parcialmente?">
    O grupo pode ser criado antes que as alterações de modelo, ACU e associação sejam concluídas. Se uma operação subsequente falhar, o portal exibirá **Grupo criado com avisos** e identificará a alteração que não foi aplicada. Revise os detalhes do grupo e tente novamente a alteração incompleta.
  </Accordion>
</AccordionGroup>
