> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Agents
> Audite e inspecione cada agent em todas as equipes e projetos a partir de uma única visualização do sistema.
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.
| 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](#view-details-modal). |
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.
| 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.
Use o botão **Clear search & filters** para redefinir a caixa de busca e todos os dropdowns de uma vez.
## 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 |
**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.
| Configuração | Detalhe |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Formatos** | CSV e XLSX |
| **Nome do arquivo** | `agents-.csv` ou `agents-.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
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.