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 retorna403 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.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
Filtros
Cuatro filtros aparecen debajo de la barra de búsqueda. Cambiar cualquier filtro restablece la página a 1.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.
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:
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
— 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.Flujos de Trabajo Comunes
Encontrar todos los agentes en un proyecto
- Abra Super Admin → Agents.
- Seleccione el proyecto en el menú desplegable del filtro Project.
- Opcionalmente filtre por Memory o Prompt Library.
- Haga clic en Export para guardar el resultado como archivo.
Auditar agentes por creador
- Seleccione un usuario en el menú desplegable del filtro Creator.
- 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
- Busque el agente por nombre, o pegue su
agent_iden el cuadro de búsqueda. - Haga clic en el icono de ojo.
- 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
- Aplique filtros para definir el alcance.
- Haga clic en Export → XLSX (o CSV).
- El archivo coincide exactamente con la vista en pantalla, hasta 100,000 filas.
Solución de Problemas
Error al cargar agentes
Error al cargar agentes
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.La búsqueda muestra menos filas de lo esperado
La búsqueda muestra menos filas de lo esperado
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.
La columna Creator muestra el propietario del proyecto, no al autor real
La columna Creator muestra el propietario del proyecto, no al autor real
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.
Memory o Prompt Lib muestra Off pero la funcionalidad parece configurada
Memory o Prompt Lib muestra Off pero la funcionalidad parece configurada
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.El archivo exportado tiene el texto de personalidad truncado después de ~500 caracteres
El archivo exportado tiene el texto de personalidad truncado después de ~500 caracteres
La personalidad se trunca intencionalmente a 500 caracteres en las exportaciones. Abra el modal de Ver Detalles para ver el prompt de sistema completo.