# Usuários

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FhHqeDjfrCCOFhSZesO1q%2Fimage.png?alt=media&#x26;token=b7f75777-de1f-4e22-877d-0d52a9bf0fbd" 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:

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

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

<table data-header-hidden><thead><tr><th width="156"></th><th width="368"></th><th></th></tr></thead><tbody><tr><td><strong>Nível</strong></td><td><strong>Descrição de Acesso</strong></td><td><strong>Ideal para...</strong></td></tr><tr><td>Administrador</td><td>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.</td><td>Gestores de TI, proprietários da conta e diretores...</td></tr><tr><td>Colaborador</td><td>Gestão de Conteúdo. Pode criar e gerenciar agentes, workspaces e grupos. Tem liberdade para configurar automações (Conectores), mas não possui acesso ao faturamento ou gestão de licenças.</td><td>Líderes de projeto ou departamento, Analistas..</td></tr><tr><td>Usuário</td><td>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.</td><td>Equipes de atendimento, vendas ou colaboradores que apenas consomem a IA.</td></tr></tbody></table>

***

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

Para adicionar um novo membro à plataforma:

1. Clique no botão![](https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FAICew8nZt957qsnXMdNe%2Fimage.png?alt=media\&token=10ff836c-475f-4d28-be17-7d6b28b18870) (+ Criar).
2. Insira o E-mail (necessário para autenticação via Microsoft Entra ID).
3. Informe o Telefone (opcional) e selecione o Nível de Permissão.
4. Clique em Salvar. Após a criação, lembre-se de atribuir a licença na tabela principal.

#### Importar Usuários (Lote)

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FXvEwAyMzL3yPgVEdVT6g%2Fimage.png?alt=media&#x26;token=8e05bfe9-6ca3-4211-beba-6caf16071a3d" alt=""><figcaption></figcaption></figure>

1. Clique no botão "Importar".
2. O arquivo deve ser obrigatoriamente do tipo .CSV e conter uma coluna de e-mail.
3. Atenção: Não inclua cabeçalhos no arquivo. Outras informações como código do país e telefone são opcionais.
4. Selecione o arquivo e confirme a importação.

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

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FX1yfStnAUpYvetAfDczA%2Fimage.png?alt=media&#x26;token=eb99ac93-cf17-485d-b407-42acdd142ea0" alt=""><figcaption></figcaption></figure>

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.

***