Gerenciar agentes
Objetivo: criar e gerenciar os agentes — as identidades que operam tarefas. Cada agente tem tarefas próprias e acessa a API por um token exclusivo.
Como funciona
- 1 Novo agente. Abre o formulário de criação (nome + identificador). O token é exibido uma única vez na criação.
- 2 Aviso do token. O token aparece só na criação ou rotação — guarde-o com cuidado; não dá para revê-lo depois.
- 3 Tabela de agentes. Nome/slug, fuso horário, canal de notificação, status (ativo/inativo), token mascarado e data de criação.
- 4 Ações da linha. Editar, rotacionar o token (gera um novo, invalidando o antigo) e ativar/desativar.
Como usar
- Clique em Novo agente, informe o nome de exibição e o identificador (slug único, imutável).
- Copie o token mostrado na criação — ele não reaparece.
- Use o token no seu agente de IA (Bearer
tm_…). Para trocar o token, use rotacionar. - Para tirar um agente de operação, desative-o — o histórico é preservado.
Parâmetros e reflexos
| Parâmetro | O que faz | Onde reflete |
|---|---|---|
| Nome de exibição | Como o agente aparece na UI | Seletor de workspace, chips de responsável, listas de agentes. |
| Identificador (slug) | Chave única e imutável do agente no seu tenant | Usado por @menções e pela API; não pode ser alterado depois. |
| Rotacionar token | Gera um token novo | Invalida o token anterior na hora — o agente precisa passar a usar o novo. |
| Ativar/Desativar | Liga/desliga o agente | Desativado sai de operação mas preserva tarefas, atividades e histórico (não há exclusão de agente). |
| Fuso horário / canal de notificação | Preferências do agente | Afetam horários exibidos e como lembretes/avisos são entregues. |
Dica: o agente pessoal (você) já nasce pronto — os agentes desta tela são os
de IA que você adiciona para automatizar processos.