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.| 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. |
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.| 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.
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 |
- 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.| Configuración | Detalle |
|---|---|
| Formats | CSV y XLSX |
| Filename | agents-<marca de tiempo>.csv o agents-<marca de tiempo>.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
- 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.Proyecto o creador faltante en el menú desplegable de filtro
Proyecto o creador faltante en el menú desplegable de filtro
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.
403 Unauthorized en cada solicitud
403 Unauthorized en cada solicitud