Pular para o conteúdo principal
A aba Agents é uma superfície de auditoria somente leitura, abrangente a todo o sistema, sobre cada agent no EK. Ela permite que superadministradores inventariem agents, inspecionem sua configuração completa, os correlacionem com seu projeto e equipe, e exportem resultados para relatórios de conformidade ou governança — tudo sem navegar para projetos individuais.
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 retorna 403 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.
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
Os filtros dropdown se acumulam sobre a busca em ambos os modos, para que você possa combinar uma busca por texto com filtros de projeto, criador e recursos simultaneamente.

​
Filtros

Quatro filtros aparecem abaixo da barra de busca. Alterar qualquer filtro redefine a página para 1.
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.
Use o botão Clear search & filters para redefinir a caixa de busca e todos os dropdowns de uma vez. 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: Blocos JSON / texto — brutos, com rolagem, formatados:
  • 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
Valores vazios e nulos são renderizados como — 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.

​
Fluxos de Trabalho Comuns

​
Encontrar todos os agents em um projeto

  1. Abra Super Admin → Agents.
  2. Selecione o projeto no dropdown de filtro Project.
  3. Opcionalmente filtre por Memory ou Prompt Library.
  4. Clique em Export para salvar o resultado como um arquivo.

​
Auditar agents por criador

  1. Selecione um usuário no dropdown de filtro Creator.
  2. 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

  1. Busque o agent pelo nome, ou cole seu agent_id na caixa de busca.
  2. Clique no ícone de olho.
  3. 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

  1. Aplique filtros para definir o escopo.
  2. Clique em Export → XLSX (ou CSV).
  3. O arquivo corresponde exatamente à visualização na tela, com até 100.000 linhas.

​
Solução de Problemas

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.
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.
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.
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.
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.
Personality é intencionalmente truncada para 500 caracteres nas exportações. Abra o modal de Visualização de Detalhes para ver o prompt do sistema completo.
Sua conta não está marcada como superadmin (users.is_admin = true). Entre em contato com o administrador do sistema.