Saltar al contenido principal

Suites

Los Conjuntos de Agentes son paquetes versionados y preconfigurados que aprovisionan un conjunto completo de recursos de runtime — agentes, habilidades, fuentes de datos y servidores MCP — en una única operación de instalación. La sección de Suites consta de dos vistas: el Catalogue (/suites/catalogue), donde se puede explorar lo disponible, e Installed Suites (/suites/installs), donde se administra lo que ya ha sido desplegado. Ambas vistas son exclusivas para administradores.

Nota: Los recursos materializados desde un suite se marcan como gestionados por el suite y muestran un distintivo de bloqueado en la cuadrícula de Agentes y en la página de Configuración. Los ajustes de orquestación (habilidades, conocimiento, MCP) de los agentes gestionados por el suite no pueden editarse directamente en el Runtime; los cambios deben provenir del propio suite.

Catálogo de Suites (/suites/catalogue)​

La página del catálogo lista todos los suites publicados en el Hub. Una barra de búsqueda filtra los resultados por nombre o slug en tiempo real. El encabezado de la página muestra el número total de suites disponibles junto a la barra de búsqueda. Un botón View Installs en la parte superior derecha navega a /suites/installs.

Cada suite se presenta como una tarjeta que muestra:

  • Ícono del suite e insignia de última versión (p. ej. v1.2.0)
  • Nombre — el nombre de visualización del suite
  • Descripción — hasta dos líneas; truncada con puntos suspensivos si es más larga
  • Conteo de recursos — cantidad de agentes, habilidades, fuentes de datos y servidores MCP mostrados como pares de ícono + número
  • Etiqueta de industria — una insignia de clasificación de industria opcional (p. ej. Finance, Healthcare)

Al hacer clic en una tarjeta de suite se navega a la página de versión del suite en /suites/:slug/versions/:version, que muestra el manifiesto completo y el asistente de instalación.

Asistente de Instalación​

El asistente de instalación se abre como un cuadro de diálogo modal y guía a través de hasta tres pasos:

Resumen — muestra el nombre del suite, la versión y un desglose de lo que será materializado: cantidad de agentes, habilidades, fuentes de datos y servidores MCP. Los nombres y slugs de los agentes se listan para que se sepa exactamente qué agentes se crearán.

Parámetros — se muestra únicamente cuando el suite define uno o más parámetros. Cada campo de parámetro se renderiza según su tipo declarado. Los parámetros de tipo secreto están enmascarados. Los parámetros requeridos deben completarse antes de avanzar. Los errores de validación se muestran en línea debajo del campo correspondiente.

Confirmación — muestra una tabla de revisión de todos los valores de parámetros no vacíos antes de la instalación. Los valores secretos se muestran como ••••••. Los suites sin parámetros omiten el paso de Parámetros y van directamente de Resumen a Confirmación.

Al hacer clic en Install en el paso final se envía la solicitud de instalación. El cuadro de diálogo se cierra y el registro de instalación aparece en la vista Installed Suites con el estado Installing.

Suites Instalados (/suites/installs)​

La página de suites instalados lista todos los registros de instalación de suites para el tenant actual. El encabezado muestra el conteo total de instalaciones. Un botón Browse catalogue navega a /suites/catalogue.

Cada suite instalado se muestra como una tarjeta que indica:

  • Pastilla de estado — Installed o Active (ambas en verde), Installing (color primario), Pendiente (atenuado), Failed (rojo), Uninstalling (atenuado) o Uninstalled (atenuado)
  • Nombre del suite e identificador slug · vX.Y.Z
  • Seguimiento automático — la política de seguimiento si está configurada (p. ej. minor, patch), mostrada junto a la versión
  • Conteo de recursos — conteos de agentes, habilidades, fuentes de datos y servidores MCP en el mismo formato de ícono que el catálogo
  • Fecha de instalación — con formato Month Day, Year
  • Mensaje de error — mostrado en rojo debajo de los conteos de recursos si la instalación falló

Al hacer clic en una tarjeta se navega a la página de detalle de la instalación en /suites/installs/:id.

Detalle de Instalación (/suites/installs/:id)​

La página de detalle muestra el estado completo de un único suite instalado. Un enlace Back to installs regresa a la lista.

El encabezado muestra el nombre del suite, la insignia de versión instalada, la pastilla de estado y — para suites que han sido actualizados — una insignia upgraded from vX que muestra la versión anterior. La marca de tiempo de instalación y el slug aparecen debajo del nombre.

Tres botones de acción aparecen en la esquina superior derecha cuando corresponde:

  • Actualizar — se muestra cuando existen otras versiones en el catálogo; abre el cuadro de diálogo del Asistente de Actualización
  • Revertir — se muestra cuando previous_version está configurado; abre un cuadro de diálogo de confirmación para restaurar la versión anterior
  • Desinstalar — siempre disponible; abre un cuadro de diálogo de confirmación que advierte que todos los recursos materializados serán eliminados y la acción no puede deshacerse

Debajo del encabezado, los recursos se agrupan en cuatro secciones:

  • Agentes — cada tarjeta de agente es clicable y enlaza directamente a /chat/:agentId para ese agente
  • Habilidades — lista de solo lectura de habilidades instaladas
  • Fuentes de Datos — lista de solo lectura de fuentes de datos instaladas
  • Servidores MCP — lista de solo lectura de servidores MCP instalados

Cada tarjeta de recurso muestra el nombre del recurso, el slug, la pastilla de estado y cualquier mensaje de error.

Asistente de Actualización​

El cuadro de diálogo del Asistente de Actualización es funcionalmente similar al Asistente de Instalación. Agrega un selector de versión en la parte superior que muestra todas las versiones disponibles en el catálogo distintas a la actualmente instalada. Al seleccionar una versión de destino se obtiene una diferencia de actualización que muestra qué recursos se agregarán, actualizarán o eliminarán. Los parámetros del esquema de la versión de destino se presentan en el paso de Parámetros. Al enviar el asistente se inicia la actualización; el estado de la página cambia a Installing.

Reversión​

El cuadro de diálogo de confirmación de reversión muestra la versión de destino (el valor previous_version) y advierte que los archivos cargados se conservan, pero las ediciones del tenant en las filas gestionadas por el suite se perderán. Al confirmar se activa la operación de reversión.

Mejores Prácticas​

  • Revise el paso de Resumen del Asistente de Instalación cuidadosamente antes de confirmar — los slugs de agentes y habilidades se utilizan como identificadores estables y no pueden renombrarse después de la instalación sin desinstalar el suite.
  • Proporcione todos los parámetros requeridos durante la instalación; los parámetros requeridos faltantes provocan que la instalación falle con un error de validación que debe corregirse desinstalando y reinstalando.
  • Para parámetros de tipo secreto como claves de API, utilice la clave con mínimos privilegios limitada solo a los permisos que necesitan los agentes del suite.
  • Después de una instalación exitosa, verifique que cada tarjeta de agente en la cuadrícula de Agentes muestre el estado Active antes de compartir los agentes con los usuarios finales — el estado Installing significa que el trabajo de aprovisionamiento en el backend aún está en ejecución.
  • Utilice Revertir en lugar de Desinstalar + Reinstalar al deshacer una actualización fallida; la reversión conserva los archivos cargados y el historial de conversaciones, mientras que la desinstalación elimina permanentemente todos los recursos materializados.

Páginas Relacionadas​

  • Descripción General — panel de runtime que muestra los conteos de agentes y recursos activos
  • Agentes — cuadrícula de agentes donde los agentes instalados mediante suites aparecen tras el aprovisionamiento
  • Configurar — configuración por agente; los agentes gestionados por el suite muestran un distintivo de bloqueado
  • Conexiones — credenciales almacenadas que pueden requerirse como parámetros del suite
  • Proveedores — credenciales de proveedor LLM referenciadas por los agentes instalados mediante suites