> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/astro/admin/usuarios.md).

# Usuários

Em **Usuários**, você convida pessoas, organiza equipes e controla o acesso ao workspace.

Confira o passo a passo para adicionar usuários, consultar a lista e gerenciar convites e links de cadastro.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FMd9ooEQ53YNy1D0E4nod%2F9D6CD367-AAC1-4E2D-A627-2AB3D45A84CD.png?alt=media&amp;token=de84cd0a-ea06-457b-82ee-fec8b8d094e1" alt=""><figcaption></figcaption></figure>

### Adicionar usuários <a href="#adicionar-usuarios" id="adicionar-usuarios"></a>

Para convidar novos usuários por e-mail, siga os seguintes passos:

1. No topo da página, clique em **Adicionar usuários**.
2. Informe os dados dos usuários que deseja convidar.
3. Envie o convite.

O convite aparece em **Convites pendentes** até ser aceito.

{% hint style="info" %}
Cada pessoa recebe um convite por e-mail e cria a própria senha no cadastro.
{% endhint %}

### Importar usuários <a href="#importar-usuarios" id="importar-usuarios"></a>

Para convidar várias pessoas de uma vez por planilha, siga os seguintes passos:

1. No topo da página, clique em **Importar**.
2. Clique em **Baixar template (.xlsx)** e preencha a aba **Usuários** do modelo. A aba **Instruções** traz as regras e as equipes do seu workspace.
3. Arraste o arquivo para a janela ou clique em **escolha um arquivo**.
4. Clique em **Validar** e revise os dados na etapa **Revisão**.
5. Confirme a importação e confira o resultado na etapa **Resultado**.

{% hint style="info" %}
São aceitos arquivos .xlsx ou .csv (separado por ponto e vírgula ou vírgula), de até 2 MB e 500 linhas.
{% endhint %}

### Buscar um usuário <a href="#buscar-um-usuario" id="buscar-um-usuario"></a>

Para encontrar um usuário, siga os seguintes passos:

1. Digite o nome ou o e-mail no campo **Buscar por nome ou e-mail**.
2. Se necessário, clique em **Filtro** para refinar a lista.
3. Clique no usuário correspondente nos resultados.

{% hint style="info" %}
Ative a opção **Mostrar desativados** para incluir na lista os usuários desativados.
{% endhint %}

### Consultar a lista de usuários <a href="#consultar-a-lista-de-usuarios" id="consultar-a-lista-de-usuarios"></a>

A lista exibe as seguintes informações de cada usuário:

* **Nome / E-mail:** nome e e-mail do usuário. Clique no título da coluna para ordenar a lista.
* **Equipes:** equipes das quais o usuário participa, ou **Sem equipe**.
* **Status:** situação da conta (ex.: **Ativo**) e perfil do usuário, como **Owner** ou **Admin**.
* **Último acesso:** data ou tempo desde o último acesso.
* **Interações:** quantidade de interações do usuário.
* **Expira em:** data de expiração do acesso, ou **Sem validade**.
* **Saldo (R$):** saldo de créditos disponível para o usuário.
* **Acesso:** tipo de permissão, **Padrão** ou **Personalizado**.

Na parte inferior da lista, utilize a paginação para navegar entre as páginas e o seletor **25 / página** para definir quantos usuários exibir por vez.

### Gerenciar um usuário <a href="#gerenciar-um-usuario" id="gerenciar-um-usuario"></a>

Para acessar as ações de um usuário, clique no ícone de três pontos ao lado da linha correspondente.

{% hint style="info" %}
Para organizar os usuários por área, [leia Equipes](https://docs.skyone.cloud/astro/admin/equipes.md).
{% endhint %}

### Gerenciar convites pendentes <a href="#gerenciar-convites-pendentes" id="gerenciar-convites-pendentes"></a>

A seção **Convites pendentes** lista os convites por e-mail que ainda não foram aceitos, com a data de envio e a data de expiração de cada um.

* **Reenviar:** envia o convite novamente para o e-mail do usuário.
* **Cancelar convite:** cancela o convite. O link enviado deixa de funcionar.

### Links de cadastro <a href="#links-de-cadastro" id="links-de-cadastro"></a>

Os links de cadastro permitem que as pessoas criem a própria conta, sem convite por e-mail.

#### Gerar um link de cadastro <a href="#gerar-um-link-de-cadastro" id="gerar-um-link-de-cadastro"></a>

Para gerar um novo link, siga os seguintes passos:

1. Clique em **Gerar link**, no topo da página ou na seção **Links de cadastro**.
2. Defina as configurações do link, como o rótulo, o limite de usos, a validade e, se desejar, a equipe.
3. Confirme a criação do link.

{% hint style="warning" %}
**Importante:** qualquer pessoa com o link pode criar uma conta no workspace. Compartilhe o link apenas com as pessoas autorizadas e desative os links que não estiverem mais em uso.
{% endhint %}

#### Consultar os links <a href="#consultar-os-links" id="consultar-os-links"></a>

A lista exibe as seguintes informações de cada link:

* **Rótulo:** nome de identificação e endereço do link.
* **Criado em:** data de criação.
* **Usos:** quantidade de contas criadas e limite de usos (ex.: **3 / ilimitado**).
* **Validade:** data de expiração do link, ou **nunca**.
* **Equipe (opcional):** equipe à qual os novos usuários são adicionados, ou **Sem equipe**.
* **Status:** situação do link (ex.: **Ativo**).

#### Gerenciar um link <a href="#gerenciar-um-link" id="gerenciar-um-link"></a>

* **Copiar link:** copia o endereço para compartilhar.
* **Desativar:** impede novos cadastros pelo link.
* **Excluir:** remove o link da lista.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.skyone.cloud/astro/admin/usuarios.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
