# Usuários

## Usuários

O módulo de Usuários é o centro administrativo onde você gerencia o acesso da sua equipe, define níveis de responsabilidade e controla a distribuição de licenças do Power ATA

<figure><img src="/files/b6hmoGo1mZak6AVuLlPC" alt=""><figcaption></figcaption></figure>

### Visão Geral

Na parte superior do painel, você encontra as métricas cruciais de licenciamento e administração:

* **Total de Usuários:** Quantidade total de contas cadastradas na plataforma.
* **Com Licença:** Número de usuários que possuem uma licença ativa e podem interagir com os Agentes de IA.
* **Sem Licença:** Usuários cadastrados, mas sem licença ativa. Eles não consomem o seu saldo de licenças e não possuem acesso às funcionalidades de IA.
* **Administradores:** Quantidade de usuários que possuem permissões totais de gestão no sistema.

### Gestão de Usuários

A tabela exibe todos os usuários, permitindo ações rápidas de gestão de acesso:

| Coluna            | Descrição                                                                                                              |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Email**         | Identificador principal da conta (utilizado para o login).                                                             |
| **Telefone**      | Número de contato do usuário (Campo opcional).                                                                         |
| **Licença**       | Ação **Desassociar Licença**. Clique aqui para remover imediatamente a licença de um usuário, liberando-a para outro.  |
| **Função**        | Identificador do nível de permissão (Administrador, Colaborador ou Usuário).                                           |
| **Orçamento/Uso** | Exibe o limite de crédito/uso habilitado para o usuário e o quanto já foi consumido.                                   |
| **Ações**         | Ícones para Editar (detalhes), Excluir (remover registro) e Relacionamentos (vincular a Agentes, Grupos e Workspaces). |

## Níveis de Permissão

O sistema utiliza permissões baseadas em funções para garantir a segurança e a governança dos dados.

| Nível             | Descrição de Acesso                                                                                                                                                       | Ideal para...                                                             |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| **Administrador** | **Acesso Total.** Possui controle completo sobre o sistema, incluindo faturamento, dados fiscais, compra e atribuição de licenças, além de todos os agentes e workspaces. | Gestores de TI, proprietários da conta e diretores.                       |
| **Usuário**       | **Acesso Restrito.** Só consegue visualizar e interagir com os Agentes de IA que foram explicitamente compartilhados com ele ou com o grupo/Workspace ao qual pertence.   | Equipes de atendimento, vendas ou colaboradores que apenas consomem a IA. |

***

## Segurança e Governança

* Hierarquia: Um Colaborador não pode promover a si mesmo ou a outros para Administrador. Essa ação é exclusiva de quem já possui o nível de Adm.
* Visibilidade de Agentes: Lembre-se que para o nível Usuário, não basta estar cadastrado; após o cadastro, você deve ir até as configurações do Agente desejado e dar a permissão de acesso para este usuário ou para o grupo/Workspace dele.

{% hint style="info" %}
Dica: Use a função de Colaborador para descentralizar a criação de Agentes entre seus departamentos sem o risco de alterações acidentais no faturamento ou no plano de licenças da empresa.
{% endhint %}

## Ações Principais na Tela de Usuários

### Cadastrar Novo Usuário (Individual)

{% stepper %}
{% step %}

### Clique no botão (+ Criar)

[![](/files/643f4809fbb7a17b02c90c6e2b8c8dbd00fdcca0)](https://docs.poweromni.ai/~gitbook/image?url=https%3A%2F%2F1296644906-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FLGvDlIVKG3lx8yU6pzIF%252Fuploads%252FAICew8nZt957qsnXMdNe%252Fimage.png%3Falt%3Dmedia%26token%3D10ff836c-475f-4d28-be17-7d6b28b18870\&width=300\&dpr=3\&quality=100\&sign=d456d469\&sv=2)
{% endstep %}

{% step %}

### Insira o E-mail

Necessário para autenticação via Microsoft Entra ID.
{% endstep %}

{% step %}

### Informe o Telefone e selecione o Nível de Permissão

Telefone é opcional.
{% endstep %}

{% step %}

### Clique em Salvar

Após a criação, lembre-se de atribuir a licença na tabela principal.
{% endstep %}
{% endstepper %}

### Importar Usuários (Lote)

[![](/files/e355e211ed8954070adf7e6615c3d0c766391eb1)](https://docs.poweromni.ai/~gitbook/image?url=https%3A%2F%2F1296644906-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FLGvDlIVKG3lx8yU6pzIF%252Fuploads%252FXvEwAyMzL3yPgVEdVT6g%252Fimage.png%3Falt%3Dmedia%26token%3D8e05bfe9-6ca3-4211-beba-6caf16071a3d\&width=768\&dpr=3\&quality=100\&sign=67b148d2\&sv=2)

{% stepper %}
{% step %}

### Clique no botão "Importar"

{% endstep %}

{% step %}

### O arquivo deve ser .CSV

O arquivo deve ser obrigatoriamente do tipo .CSV e conter uma coluna de e-mail.
{% endstep %}

{% step %}

### Atenção ao formato

Não inclua cabeçalhos no arquivo. Outras informações como código do país e telefone são opcionais.
{% endstep %}

{% step %}

### Selecione o arquivo

{% endstep %}

{% step %}

### Confirme a importação

{% endstep %}
{% endstepper %}

### Exportar

Para exportar a lista de usuários cadastrados:

* Clique no botão "Exportar" para gerar um arquivo .CSV com a lista completa de usuários, e-mails, permissões e status de licenciamento para fins de auditoria.

### Gerenciar Licenças

[![](/files/f3d7d5164e93ea783f359229a6eb40d25e46c742)](https://docs.poweromni.ai/~gitbook/image?url=https%3A%2F%2F1296644906-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FLGvDlIVKG3lx8yU6pzIF%252Fuploads%252FX1yfStnAUpYvetAfDczA%252Fimage.png%3Falt%3Dmedia%26token%3Deb99ac93-cf17-485d-b407-42acdd142ea0\&width=768\&dpr=3\&quality=100\&sign=efcd9961\&sv=2)

O controle de licenças é feito individualmente na listagem de usuários:

* Atribuir Licença: Para que um usuário consiga logar e utilizar a plataforma, ele precisa de uma licença ativa. Ative a chave de licença na linha correspondente ao usuário.
* Remover Licença: Ao desativar uma licença, ela retorna para o seu "pool" de licenças disponíveis, permitindo que seja atribuída a outra pessoa sem custo adicional.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://azbr.gitbook.io/power-ata/usuarios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
