> For the complete documentation index, see [llms.txt](https://edu.sittax.com.br/sittax-base-conhecimento/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edu.sittax.com.br/sittax-base-conhecimento/sittax-token/base-tecnica/controle/agentes.md).

# Agentes

#### O que é

Tela de gestão das pessoas físicas que utilizam certificados digitais por meio do Aplicativo Desktop do Sittax Token. O **Agente** representa um operador — funcionário, contador, representante — que assina documentos digitalmente na máquina dele.

> Agentes ≠ Usuários: o agente **usa** o certificado no Aplicativo Desktop, o usuário **administra** a plataforma web.

#### Acesso

Menu principal → **Controle** → **Agentes**

#### O que aparece na tela

Listagem de todos os agentes cadastrados, com as colunas:

* **Nome**
* **E-mail**
* **Quantidade de certificados vinculados**
* **Data de cadastro**
* **Último acesso ao aplicativo desktop**
* **Ações**

#### Campos do formulário de cadastro

| Campo       | Descrição                                                              | Obrigatório |
| ----------- | ---------------------------------------------------------------------- | ----------- |
| **Nome**    | Identificação clara do agente                                          | ✅           |
| **E-mail**  | Endereço usado nas comunicações do sistema                             | ✅           |
| **Senha**   | Senha de autenticação do agente no Aplicativo Desktop                  | ✅           |
| **Apelido** | Identificação interna para facilitar distinção entre múltiplos agentes | ❌           |

#### Ações disponíveis na listagem

* **Grupos** — exibe e gerencia os grupos de acesso aos quais o agente está vinculado (onde o vínculo entre Grupo e Agente é efetivamente criado)
* **Certificados** — lista os certificados digitais liberados para o agente utilizar
* **Procurações** — exibe as procurações ativas vinculadas aos certificados do agente; permite liberar ou bloquear procurações específicas via checkbox
* **Nova Senha** — altera a senha de acesso do agente ao Aplicativo Desktop
* **Editar** — altera nome e informações básicas do agente
* **Desativar / Ativar** — suspende ou reativa o agente sem excluí-lo
* **Excluir** — remove o agente do sistema, revogando todo acesso ao Aplicativo Desktop

#### Regras e comportamentos

* Ao cadastrar um novo agente, o sistema pode levar **até 5 minutos** para listar as procurações encontradas nos certificados atuais
* Um agente pode estar em **múltiplos grupos simultaneamente**, herdando os acessos de cada um
* Um agente sem grupo não recebe certificados compartilhados
* Agentes inativos **não se comunicam com a plataforma**: não recebem certificados novos e não enviam informações sobre certificados detectados na máquina
* Agentes inativos **não aparecem** nas opções de compartilhamento
* A exclusão do agente **não remove** os certificados vinculados — apenas desfaz o acesso

#### Conteúdos relacionados

* Como cadastrar um Agente
* Como validar o monitoramento do agente
* Como instalar o Aplicativo Sittax Token
* Cadastros → Grupos — onde o grupo é cadastrado (depois vinculado aqui)
* Controle → Monitoramento
* O que acontece ao inativar um agente?