> ## 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.
# Agentes
> Audite e inspeccione cada agente en todos los equipos y proyectos desde una única vista del sistema.
La pestaña Agents es una **superficie de auditoría de solo lectura a nivel del sistema** sobre cada agente en EKB. Permite a los super administradores inventariar agentes, inspeccionar su configuración completa, correlacionarlos con su proyecto y equipo, y exportar resultados para informes de cumplimiento o gobernanza — todo sin navegar a proyectos individuales.
La pestaña Agents no permite editar ni eliminar agentes. Cualquier cambio a un agente debe realizarse desde dentro de su proyecto propietario por un usuario con el rol de proyecto apropiado.
## Prerrequisitos
Solo los usuarios marcados como super administradores pueden acceder a esta pestaña. Cada endpoint de backend verifica independientemente el estado de administrador y retorna `403 Unauthorized` para todos los demás usuarios — incluyendo llamadas API directas realizadas fuera de la interfaz.
## Dónde Encontrarla
Vaya a **Super Admin → Users & Workspaces → Agents**.
La pestaña se muestra junto a **App Licenses**, **Projects**, **Teams**, **Teams Bots** y **Users** en el área de contenido principal del panel.
## Tabla de Agentes
La tabla se ordena por **Last Updated (descendente)** por defecto. Esta ordenación es estable entre cambios de página — paginar hacia adelante y hacia atrás nunca mezcla filas durante una sesión.
| Columna | Descripción |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Agent** | El nombre del agente. Se muestra "Untitled" si está en blanco. |
| **Agent ID** | El identificador público del agente utilizado por rutas de chat y proyectos. Se muestra truncado en monoespacio — pase el cursor para ver el valor completo. |
| **Project** | El nombre del proyecto propietario, con su ID de proyecto en una segunda línea. |
| **Team** | El equipo que posee el proyecto. |
| **Creator** | El usuario que creó la primera versión del agente. Se muestra el propietario del proyecto como respaldo para agentes heredados anteriores al historial de versiones. Se muestra el nombre con el correo electrónico debajo. |
| **Created** | Hora de creación del agente, en su zona horaria local. |
| **Updated** | Hora de la última actualización. Columna de ordenación predeterminada. |
| **Memory** | Distintivo On / Off. `NULL` se trata como Off. |
| **Prompt Lib** | Distintivo On / Off para la funcionalidad Prompt Library. `NULL` se trata como Off. |
| **Blocks** | Conteo de bloques de construcción adjuntos al agente. |
| **Actions** | Icono de ojo — abre el [modal de Ver Detalles](#modal-de-ver-detalles). |
Los guiones largos (`—`) aparecen donde un valor es `NULL` o está vacío, incluyendo marcas de tiempo.
## Modo de Búsqueda vs. Lista
La pestaña opera en dos modos dependiendo de si el cuadro de búsqueda está activo.
### Modo Lista (predeterminado)
* Activo cuando el cuadro de búsqueda está vacío
* La tabla se pagina a **12 filas por página**
* El control de paginación muestra `Página X de Y`
* Los filtros se aplican normalmente; la página se restablece a 1 cuando cambia cualquier filtro
### Modo de Búsqueda
* Se activa tan pronto como escribe en el cuadro de búsqueda (400 ms de debounce)
* La paginación se oculta; el backend retorna hasta **200 filas coincidentes** en una sola respuesta
* Cuando el conteo real de coincidencias supera las 200, una línea de resumen indica: `4815 coincidencia(s) (mostrando las primeras 200 — reduzca la búsqueda para ver más)` — refine su consulta o agregue filtros para ver el resto
* La búsqueda es **coincidencia parcial sin distinción de mayúsculas/minúsculas** en nombre del agente, ID del agente, nombre del proyecto y nombre/correo electrónico del creador simultáneamente
* Pegar un UUID con caracteres `_` o `%` es seguro — esos caracteres no se tratan como comodines
* Longitud máxima de la consulta: **100 caracteres**
Los filtros desplegables se apilan sobre la búsqueda en ambos modos, para que pueda combinar una búsqueda de texto con filtros de proyecto, creador y funcionalidad simultáneamente.
## Filtros
Cuatro filtros aparecen debajo de la barra de búsqueda. Cambiar cualquier filtro restablece la página a 1.
| Filtro | Comportamiento |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Project** | Menú desplegable de cada proyecto que tiene al menos un agente, ordenado por nombre. |
| **Creator** | Menú desplegable de cada creador distinto (autor de la primera versión o propietario de un proyecto con agentes). Se muestra como `nombre (correo electrónico)`. |
| **Memory** | Tres estados: **Any** / **Enabled** / **Disabled**. Disabled incluye tanto `FALSE` como `NULL`. |
| **Prompt Library** | Misma semántica de tres estados que Memory. |
Los menús desplegables de Project y Creator están limitados a **1,000 entradas**. Si se alcanza el límite, aparece una pista ámbar debajo del menú desplegable. Use el cuadro de búsqueda para encontrar proyectos o creadores no mostrados en la lista — la búsqueda se ejecuta contra la tabla completa.
Use el botón **Clear search & filters** para restablecer el cuadro de búsqueda y todos los menús desplegables a la vez.
## Modal de Ver Detalles
Hacer clic en el icono de ojo en cualquier fila abre la configuración completa de ese agente. El modal siempre recarga datos en vivo al abrirse.
**Cuadrícula de encabezado** — campos de configuración clave de un vistazo:
| Campo | Descripción |
| ------------------------------------------------------------ | ---------------------------------------------------------------------- |
| Agent Name / Agent ID | Identificadores |
| Project (nombre + ID) | Proyecto propietario |
| Team (nombre + ID) | Equipo propietario |
| Creator (nombre + correo electrónico + user ID) | Autor de la primera versión, con respaldo del propietario del proyecto |
| Temperature | Formateado a 2 decimales |
| Created / Last Updated | Marcas de tiempo |
| Building Blocks | Conteo de bloques adjuntos |
| Memory Enabled / Prompt Library | Indicadores de funcionalidad |
| Mask URLs / Enrich Sources / Inline Citations / Filter Links | Indicadores de comportamiento de respuesta |
| Use Google / Use KB | Indicadores de fuente |
**Bloques JSON / texto** — sin formato, desplazables, impresos de forma legible:
* **Personality** — el prompt de sistema completo (sin truncar, a diferencia de las exportaciones)
* **Attached Blocks** — configuración de bloques de construcción
* **Rules** — reglas del agente
* **Document Keys** — configuración de alcance de documentos
* **Memory Settings** — configuración de memoria
* **Prompt Settings** — configuración de la biblioteca de prompts
Los valores vacíos y nulos se renderizan como `—` en todo lugar.
## Actualización de Datos
El **botón de actualización** (flecha circular, a la derecha del cuadro de búsqueda) re-ejecuta la consulta actual — misma página, búsqueda y filtros. No activa una nueva búsqueda cuando el cuadro de búsqueda tiene entrada pendiente; espera a que el debounce se estabilice primero para evitar mostrar resultados desactualizados para una consulta que está a punto de cambiar.
Las consultas de la tabla se almacenan en caché por **30 segundos**, por lo que navegar entre páginas o estados de filtro que ya ha visitado es instantáneo.
## Exportación
El menú desplegable **Export** (esquina superior derecha) envía la vista actual — incluyendo todos los términos de búsqueda y filtros activos — a un archivo descargable.
| Configuración | Detalle |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Formats** | CSV y XLSX |
| **Filename** | `agents-.csv` o `agents-.xlsx` |
| **Row cap** | 100,000 filas. Reduzca filtros o búsqueda si excede este límite. |
| **Timestamps** | Formateados en la zona horaria local de su navegador |
| **Personality column** | Truncada a 500 caracteres con `...` al final — abra Ver Detalles para el prompt completo |
| **Column order** | Estable, comenzando con: `name`, `agent_id`, `id`, `project_name`, `project_id`, `team_name`, `team_id`, `creator_name`, `creator_email`, `creator_user_id`, … |
## Flujos de Trabajo Comunes
### Encontrar todos los agentes en un proyecto
1. Abra **Super Admin → Agents**.
2. Seleccione el proyecto en el menú desplegable del filtro **Project**.
3. Opcionalmente filtre por **Memory** o **Prompt Library**.
4. Haga clic en **Export** para guardar el resultado como archivo.
### Auditar agentes por creador
1. Seleccione un usuario en el menú desplegable del filtro **Creator**.
2. Si el usuario no está en el menú desplegable, escriba su nombre o correo electrónico en el cuadro de búsqueda — la búsqueda se ejecuta contra la tabla completa.
### Inspeccionar la configuración completa de un agente específico
1. Busque el agente por nombre, o pegue su `agent_id` en el cuadro de búsqueda.
2. Haga clic en el icono de ojo.
3. Revise la cuadrícula de encabezado para la configuración general y los bloques JSON para personalidad, reglas, bloques adjuntos y configuraciones.
### Generar un informe de cumplimiento
1. Aplique filtros para definir el alcance.
2. Haga clic en **Export → XLSX** (o CSV).
3. El archivo coincide exactamente con la vista en pantalla, hasta 100,000 filas.
## Solución de Problemas
El backend retornó una respuesta que no es 2xx. Abra DevTools del navegador → Network para ver el código de estado; el detalle completo del error está en el registro del backend bajo `Error fetching agents`.
El menú desplegable está limitado a 1,000 entradas. Busque la pista ámbar "Showing first 1000…" debajo del menú desplegable. Use el cuadro de búsqueda en su lugar — consulta la tabla completa.
Los resultados de búsqueda están limitados a 200 filas por respuesta. La línea de resumen muestra el conteo real de coincidencias. Agregue filtros o reduzca la consulta para llevar el conjunto de resultados por debajo de 200.
El agente fue creado antes de que existiera el historial de versiones. El propietario del proyecto se usa como respaldo deliberado para estos agentes heredados.
La columna trata `NULL` como Off, lo que coincide con el comportamiento en tiempo real. Si el valor debería ser On, verifique directamente `agents.memory_enabled` o `agents.prompt_library_enabled` en la base de datos.
La personalidad se trunca intencionalmente a 500 caracteres en las exportaciones. Abra el modal de Ver Detalles para ver el prompt de sistema completo.
Su cuenta no está marcada como super admin (`users.is_admin = true`). Contacte a su administrador del sistema.