Agentes¶
A tela de Agentes permite monitorar os processos automatizados que executam tarefas no sistema, como o processamento de recibos.
Como abrir¶
- Menu: Pessoas → Agentes
- Atalho de teclado:
Ctrl+Shift+G - Permissão necessária: Mestre (owner)
Layout da tela¶
A tela apresenta um layout mestre-detalhe:
- Painel esquerdo — lista de agentes dividida em ativos e inativos, com campo de pesquisa. Cada agente possui um interruptor de ativação diretamente na lista.
- Painel direito — informações do agente selecionado (somente leitura) e tabela de log de uso com filtro por intervalo de datas.
O que são agentes
Agentes são processos automatizados que executam tarefas em nome do sistema, como o processamento de recibos. Eles aparecem como usuários especiais e suas atividades são registradas para fins de auditoria e faturamento.
Referência de campos¶
Informações do agente¶
Os dados do agente (nome, nome de usuário, loja) são exibidos no cabeçalho do painel direito. Esses campos são somente leitura nesta tela.
Log de uso¶
A tabela de log de uso exibe as execuções do agente no período selecionado:
| Coluna | Descrição |
|---|---|
| Data | Data e hora da execução. |
| Tarefa | Tipo de tarefa executada. |
| Status | Resultado da execução, com código de cor: verde (sucesso), vermelho (falha), amarelo (escalado). |
| Tokens | Quantidade de tokens consumidos pela execução. |
| Custo | Custo monetário da execução (exibido com 6 casas decimais). |
Um resumo agregado é exibido abaixo da tabela, com os totais de tokens e custo no período.
Filtro de datas¶
| Filtro | Descrição |
|---|---|
| Data de / Data até | Intervalo de datas para o log de uso (padrão: últimos 30 dias). |
Tarefas comuns¶
Ativar ou desativar um agente¶
Clique no interruptor ao lado do nome do agente na lista. A alteração é gravada imediatamente e registrada no log de auditoria.
Consultar o uso de um agente¶
- Selecione o agente na lista.
- O log de uso é carregado automaticamente com os dados dos últimos 30 dias.
- Para alterar o período, ajuste os campos de data acima da tabela.
Identificar problemas¶
Verifique a coluna Status no log de uso. Execuções com status Falha ou Escalado indicam problemas que podem necessitar de investigação. O custo acumulado no resumo ajuda a monitorar o consumo de recursos.