A aba Agents não permite editar ou excluir agents. Qualquer alteração em um agent deve ser feita dentro do projeto proprietário por um usuário com a função de projeto apropriada.
Pré-requisitos
Apenas usuários marcados como superadmins podem acessar esta aba. Cada endpoint do backend verifica independentemente o status de administrador e retorna403 Unauthorized para todos os outros usuários — incluindo chamadas de API diretas feitas fora da interface.
Onde Encontrar
Vá para Super Admin → Users & Workspaces → Agents. A aba é renderizada ao lado de App Licenses, Projects, Teams, Teams Bots e Users na área de conteúdo principal do painel.Tabela de Agents
A tabela é ordenada por Última Atualização (decrescente) por padrão. Esta ordenação é estável entre paginações — avançar e retroceder páginas nunca embaralha as linhas durante uma sessão.| Coluna | Descrição |
|---|---|
| Agent | O nome do agent. Volta para “Untitled” se estiver em branco. |
| Agent ID | O identificador público do agent usado por rotas de chat e projeto. Exibido truncado em monoespaçado — passe o mouse para ver o valor completo. |
| Project | O nome do projeto proprietário, com seu ID do projeto em uma segunda linha. |
| Team | A equipe que possui o projeto. |
| Creator | O usuário que criou a primeira versão do agent. Volta para o proprietário do projeto para agents legados anteriores ao histórico de versões. Exibido como nome com e-mail abaixo. |
| Created | Hora de criação do agent, no seu fuso horário local. |
| Updated | Hora da última atualização. Coluna de ordenação padrão. |
| Memory | Badge Ligado/Desligado. NULL é tratado como Desligado. |
| Prompt Lib | Badge Ligado/Desligado para o recurso Prompt Library. NULL é tratado como Desligado. |
| Blocks | Contagem de building blocks anexados ao agent. |
| Actions | Ícone de olho — abre o modal de Visualização de Detalhes. |
Traços longos (
—) aparecem sempre que um valor é NULL ou vazio, incluindo carimbos de data/hora.Modo de Busca vs. Lista
A aba opera em dois modos, dependendo de se a caixa de busca está ativa.Modo Lista (padrão)
- Ativo quando a caixa de busca está vazia
- A tabela é paginada com 12 linhas por página
- O controle de paginação mostra
Page X of Y - Os filtros são aplicados normalmente; a página é redefinida para 1 quando qualquer filtro é alterado
Modo de Busca
- Ativado assim que você digita na caixa de busca (debounce de 400 ms)
- A paginação é ocultada; o backend retorna até 200 linhas correspondentes em uma única resposta
- Quando a contagem real de correspondências excede 200, uma linha de resumo exibe:
4815 match(es) (showing first 200 — narrow the search to see more)— refine sua consulta ou adicione filtros para ver mais - A busca é uma correspondência parcial insensível a maiúsculas/minúsculas no nome do agent, ID do agent, nome do projeto e nome/e-mail do criador simultaneamente
- Colar um UUID com caracteres
_ou%é seguro — esses caracteres não são tratados como curingas - Comprimento máximo da consulta: 100 caracteres
Filtros
Quatro filtros aparecem abaixo da barra de busca. Alterar qualquer filtro redefine a página para 1.| Filtro | Comportamento |
|---|---|
| Project | Dropdown de todos os projetos que possuem pelo menos um agent, ordenados por nome. |
| Creator | Dropdown de todos os criadores distintos (autor da primeira versão ou proprietário de um projeto com agents). Exibido como nome (e-mail). |
| Memory | Três estados: Qualquer / Habilitado / Desabilitado. Desabilitado inclui ambos FALSE e NULL. |
| Prompt Library | Mesma semântica de três estados que Memory. |
Os dropdowns de Project e Creator são limitados a 1.000 entradas. Se o limite for atingido, uma dica âmbar aparecerá abaixo do dropdown. Use a caixa de busca para encontrar projetos ou criadores não exibidos na lista — a busca é executada contra a tabela completa.
Modal de Visualização de Detalhes
Clicar no ícone de olho em qualquer linha abre a configuração completa daquele agent. O modal sempre busca dados atualizados ao ser aberto. Grade do cabeçalho — campos de configuração principais de relance:| Campo | Descrição |
|---|---|
| Agent Name / Agent ID | Identificadores |
| Project (nome + ID) | Projeto proprietário |
| Team (nome + ID) | Equipe proprietária |
| Creator (nome + e-mail + user ID) | Autor da primeira versão, com fallback para o proprietário do projeto |
| Temperature | Formatado com 2 casas decimais |
| Created / Last Updated | Carimbos de data/hora |
| Building Blocks | Contagem de blocos anexados |
| Memory Enabled / Prompt Library | Flags de recurso |
| Mask URLs / Enrich Sources / Inline Citations / Filter Links | Flags de comportamento de resposta |
| Use Google / Use KB | Flags de fonte |
- Personality — o prompt do sistema completo (não truncado, ao contrário das exportações)
- Attached Blocks — configuração dos building blocks
- Rules — regras do agent
- Document Keys — configuração de escopo de documentos
- Memory Settings — configuração de memória
- Prompt Settings — configuração da biblioteca de prompts
— em todo lugar.
Atualizando Dados
O botão de atualização (seta circular, à direita da caixa de busca) re-executa a consulta atual — mesma página, busca e filtros. Ele não aciona uma nova busca quando a caixa de busca tem entrada pendente; ele aguarda o debounce se estabilizar primeiro para evitar mostrar resultados desatualizados para uma consulta que está prestes a mudar. As consultas da tabela são armazenadas em cache por 30 segundos, então navegar entre páginas ou estados de filtro que você já visitou é instantâneo.Exportação
O dropdown Export (canto superior direito) transmite a visualização atual — incluindo todos os termos de busca e filtros ativos — para um arquivo para download.| Configuração | Detalhe |
|---|---|
| Formatos | CSV e XLSX |
| Nome do arquivo | agents-<timestamp>.csv ou agents-<timestamp>.xlsx |
| Limite de linhas | 100.000 linhas. Reduza os filtros ou a busca se exceder este limite. |
| Carimbos de data/hora | Formatados no fuso horário local do seu navegador |
| Coluna Personality | Truncada para 500 caracteres com ... no final — abra Visualização de Detalhes para o prompt completo |
| Ordem das colunas | Estável, começando com: name, agent_id, id, project_name, project_id, team_name, team_id, creator_name, creator_email, creator_user_id, … |
Fluxos de Trabalho Comuns
Encontrar todos os agents em um projeto
- Abra Super Admin → Agents.
- Selecione o projeto no dropdown de filtro Project.
- Opcionalmente filtre por Memory ou Prompt Library.
- Clique em Export para salvar o resultado como um arquivo.
Auditar agents por criador
- Selecione um usuário no dropdown de filtro Creator.
- Se o usuário não estiver no dropdown, digite seu nome ou e-mail na caixa de busca — a busca é executada contra a tabela completa.
Inspecionar a configuração completa de um agent específico
- Busque o agent pelo nome, ou cole seu
agent_idna caixa de busca. - Clique no ícone de olho.
- Revise a grade do cabeçalho para a configuração de alto nível e os blocos JSON para personality, regras, blocos anexados e configurações.
Gerar um relatório de conformidade
- Aplique filtros para definir o escopo.
- Clique em Export → XLSX (ou CSV).
- O arquivo corresponde exatamente à visualização na tela, com até 100.000 linhas.
Solução de Problemas
Falha ao carregar agents
Falha ao carregar agents
O backend retornou uma resposta diferente de 2xx. Abra as DevTools do navegador → Network para ver o código de status; o detalhe completo do erro está no log do backend sob
Error fetching agents.Projeto ou criador ausente no dropdown de filtro
Projeto ou criador ausente no dropdown de filtro
O dropdown está limitado a 1.000 entradas. Procure a dica âmbar “Showing first 1000…” abaixo do dropdown. Use a caixa de busca — ela consulta a tabela completa.
A busca mostra menos linhas do que o esperado
A busca mostra menos linhas do que o esperado
Os resultados da busca são limitados a 200 linhas por resposta. A linha de resumo mostra a contagem real de correspondências. Adicione filtros ou refine a consulta para reduzir o conjunto de resultados para menos de 200.
A coluna Creator mostra o proprietário do projeto, não o autor real
A coluna Creator mostra o proprietário do projeto, não o autor real
O agent foi criado antes da existência do histórico de versões. O proprietário do projeto é usado como alternativa deliberada para esses agents legados.
Memory ou Prompt Lib mostra Desligado, mas o recurso parece configurado
Memory ou Prompt Lib mostra Desligado, mas o recurso parece configurado
A coluna trata
NULL como Desligado, o que corresponde ao comportamento de execução. Se o valor deveria ser Ligado, verifique agents.memory_enabled ou agents.prompt_library_enabled diretamente no banco de dados.Arquivo de exportação não contém texto de personality além de ~500 caracteres
Arquivo de exportação não contém texto de personality além de ~500 caracteres
Personality é intencionalmente truncada para 500 caracteres nas exportações. Abra o modal de Visualização de Detalhes para ver o prompt do sistema completo.
403 Unauthorized em todas as requisições
403 Unauthorized em todas as requisições