Saltar al contenido principal

Suites de Agentes

Suites de Agentes es la superficie de empaquetado y distribución dentro de Beak AI Studio. Se encuentra bajo el encabezado Studio · Build y permite a los creadores componer un grupo de agentes — junto con todas las habilidades, fuentes de datos y servidores MCP de los que dependen esos agentes — en un único artefacto versionado llamado suite. Una vez publicada, la suite se envía a Hub, donde los administradores de inquilinos pueden descubrirla, previsualizarla e instalarla en su espacio de trabajo.

La descripción de la página dice: "Empaquete agentes, habilidades, fuentes de datos y servidores MCP en paquetes versionados y publicables."

Lista de Suites​

La Lista de Suites es la vista de catálogo en /agent-suites. Muestra cada suite en borrador del espacio de trabajo como filas en una tabla de datos. Un botón New Suite en la esquina superior derecha del encabezado de la página abre el flujo de creación.

Un cuadro de búsqueda encima de la tabla filtra las filas visibles en tiempo real según el nombre, el slug y la descripción de la suite.

Columnas de la Tabla​

  • Name — Nombre de visualización de la suite, con la descripción mostrada como texto secundario debajo.
  • Slug — Identificador seguro para URL (customer-support-pack). Letras minúsculas, dígitos, guiones y guiones bajos; debe comenzar con una letra o un dígito.
  • Agents — Cantidad de agentes actualmente asignados al borrador.
  • Latest — La versión semántica publicada más alta (v1.2.0), o un distintivo Draft cuando aún no se ha publicado ninguna versión.
  • Installs — Número de veces que la suite ha sido instalada en todos los inquilinos, obtenido desde Hub.
  • Updated — Marca de tiempo relativa del último guardado del borrador.

Cada fila es cliqueable y abre el Editor de Suite para ese borrador. Un icono de eliminación al final de cada fila elimina el borrador. Eliminar un borrador no afecta las versiones ya publicadas en Hub.

Crear una Suite​

La página New Suite en /agent-suites/new recopila la información mínima necesaria para registrar un borrador.

Campos del Formulario de Nueva Suite​

  • Slug — Identificador legible por máquina utilizado en la URL de Hub y en las referencias del manifiesto. Debe coincidir con el patrón [a-z0-9][a-z0-9_-]*. Este valor no se puede cambiar después de la creación.
  • Name — Nombre de visualización legible por humanos que se muestra en Hub y en la lista de Studio.
  • Description — Resumen de texto libre opcional sobre el contenido de la suite, mostrado a los consumidores en Hub.

Cancel regresa a la Lista de Suites sin guardar. Create Suite guarda el borrador y navega directamente al Editor de Suite.

Editor de Suite​

El Editor de Suite en /agent-suites/:id es la superficie principal de creación. El encabezado de la página muestra el nombre y el slug de la suite. Cuatro botones de la barra de herramientas controlan la sesión de edición:

  • Back — Regresa a la Lista de Suites.
  • Preview Manifest — Genera y muestra una vista previa de solo lectura del manifiesto en un panel lateral sin publicarlo.
  • Save — Guarda los cambios no guardados en el borrador. Activo solo cuando hay cambios sin guardar.
  • Publish — Abre el diálogo Publicar Suite para lanzar una nueva versión en Hub.

Nota: Publish requiere derechos de administrador en el inquilino de BeakAI. El botón es visible para todos los editores, pero está deshabilitado para los no administradores. Se debe hacer clic en Save antes de Publish — el botón Publish permanece inactivo mientras haya cambios sin guardar.

Panel de Identidad​

El panel de Identidad en la columna izquierda contiene el nombre y la descripción editables para el borrador de la suite. Los cambios aquí se reflejan en el listado de Hub después de la siguiente publicación.

  • Name — Nombre de visualización de la suite.
  • Description — Resumen opcional que se muestra en la página del mercado de Hub.

Agentes en Esta Suite​

El panel de Agentes muestra tarjetas para cada agente actualmente asignado al borrador. El encabezado del panel informa el número de agentes seleccionados. Add Agents abre un diálogo de selección múltiple con búsqueda que lista todos los agentes activos en el espacio de trabajo.

Cada tarjeta de agente muestra el icono, el nombre, la versión y el tipo del agente (assistant u orchestrator). Dos acciones al pasar el cursor aparecen en cada tarjeta:

  • Open in Studio — navega al editor de agente activo en /agents/:id.
  • Remove from suite — elimina el agente de la selección del borrador.

Nota: La suite toma una instantánea de cada agente en el momento de la publicación. Los cambios realizados a un agente en Studio después de que se publique una versión no afectan esa versión publicada.

Parámetros​

El panel de Parámetros define los campos personalizables por el cliente que aparecen en el asistente de instalación cuando un consumidor instala la suite desde Hub. Los parámetros que no están listados quedan bloqueados a los valores incrustados en el manifiesto.

Dos botones completan la lista:

  • Suggest from manifest — Analiza el manifiesto actual y propone una lista inicial de parámetros derivados de las habilidades, fuentes de datos y campos de configuración de los agentes. Una superposición de confirmación lista las sugerencias; los creadores seleccionan cuáles fusionar en el esquema.
  • Add parameter — Crea una entrada de parámetro en blanco para su definición manual.

Cada fila de parámetro muestra el distintivo de tipo, la etiqueta y el ID. Expandir una fila expone los campos completos del parámetro:

  • Type — Tipo de dato que determina cómo el asistente de instalación renderiza el campo y cómo el Runtime almacena el valor. Opciones: String, URL, Secret, Model name, Virtual key ref, Datasource config, Webhook secret, Prompt variable.
  • ID — Clave en notación de puntos utilizada por el sustituto para localizar el parámetro en el momento de la instalación (p. ej., skill.itsm.url).
  • Label — Nombre de campo legible por humanos que se muestra en el asistente de instalación.
  • Required — Interruptor. Cuando está activado, el consumidor debe proporcionar un valor; cuando está desactivado, el valor de Default se usa como alternativa.
  • Description — Texto de sugerencia que se muestra debajo del campo en el asistente de instalación.
  • Default — Valor precargado en el asistente (no disponible para los tipos Secret y Webhook secret).
  • Placeholder token — (Solo para el tipo Prompt variable) El token {{slug}} que el sustituto reemplaza en los campos de texto vinculados.
  • Connector type — (Solo para el tipo Datasource config) Identificador del conector al que debe ajustarse la configuración de conexión del cliente (p. ej., postgres, sharepoint, web_crawl).
  • Bindings — Una expresión JSONPath por línea. Cada ruta le indica al sustituto exactamente dónde en el manifiesto debe ubicarse el valor del cliente. Los múltiples vínculos permiten que un único parámetro rellene varios campos simultáneamente.

Panel de Visibilidad​

El panel de Visibilidad en la columna derecha controla qué inquilinos pueden descubrir e instalar la suite desde Hub.

  • Visibility — Menú desplegable con dos opciones: Public (all tenants) hace que la suite sea visible para todos los inquilinos de Hub; Tenant allowlist restringe la visibilidad a un conjunto específico de inquilinos.
  • Visible tenant IDs — Se muestra solo cuando se selecciona Tenant allowlist. Acepta una lista separada por comas de IDs de inquilinos numéricos.
  • Suite preview — Interruptor. Cuando está habilitado, los consumidores en Hub pueden previsualizar el manifiesto de la suite antes de comprometerse con una instalación.

Panel de Versiones Publicadas​

El panel de Versiones Publicadas lista cada versión que ha sido lanzada a Hub, de la más reciente a la más antigua. Cada entrada muestra el número de versión semántica, la marca de tiempo de publicación y el texto del registro de cambios ingresado en el momento de la publicación. Hacer clic en una fila de versión abre la página de Vista de Versión para ese lanzamiento.

Panel Lateral de Vista Previa del Manifiesto​

Hacer clic en Preview Manifest en la barra de herramientas del editor abre un panel lateral que renderiza una instantánea de solo lectura del manifiesto que se enviaría a Hub si la suite se publicara ahora. La vista previa se genera a partir del último estado guardado del borrador y no crea una nueva versión.

Si el manifiesto tiene advertencias de configuración — como agentes con habilidades o fuentes de datos faltantes — el panel muestra una lista de advertencias antes del contenido del manifiesto.

El cuerpo del manifiesto está estructurado en cuatro secciones que reflejan lo que ven los consumidores de Hub:

  • Agents — Tarjetas para cada agente en el manifiesto, que muestran nombre, tipo, modelo, cantidad de habilidades, cantidad de fuentes de datos y cantidad de servidores MCP.
  • Skills — Tarjetas para cada habilidad resuelta a partir de los agentes, que muestran nombre de visualización, ID de herramienta, distintivo de tipo y categoría.
  • Datasources — Tarjetas para cada fuente de datos, que muestran nombre y tipo de fuente de datos.
  • MCP Servers — Tarjetas para cada servidor MCP, que muestran nombre, protocolo de transporte y la lista de nombres de herramientas disponibles.

Diálogo Publicar Suite​

Publish abre un diálogo que confirma el borrador actual como una nueva versión inmutable en Hub. El diálogo muestra un resumen de cierre de lo que incluirá la publicación — recuentos de agentes, habilidades, fuentes de datos y servidores MCP extraídos de la vista previa del manifiesto más reciente. También se muestran las advertencias del manifiesto.

Campos de Publicación​

  • Version (semver) — Cadena de versión semántica en formato major.minor.patch (p. ej., 1.0.0, 2.1.3-beta.1). El diálogo precarga un incremento de parche sugerido a partir de la última versión publicada, o 1.0.0 para una primera publicación. Cada versión debe ser única; reutilizar una versión existente está bloqueado.
  • Changelog — Notas de versión opcionales que describen los cambios en esta versión. El texto se almacena con la versión y se muestra en el panel de Versiones Publicadas y en Hub.

Cancel cierra el diálogo sin publicar. Publish envía la solicitud. Una vez publicada, una versión no puede modificarse ni eliminarse.

Vista de Versión​

La página de Vista de Versión en /agent-suites/:id/versions/:ver muestra el contenido del manifiesto para una versión publicada específica. El encabezado de la página muestra el nombre de la suite y el número de versión junto con la marca de tiempo de publicación. Si se ingresó un registro de cambios en el momento de la publicación, aparece en una tarjeta encima del manifiesto.

El cuerpo del manifiesto se renderiza utilizando el mismo diseño de cuatro secciones que el Panel Lateral de Vista Previa del Manifiesto — Agents, Skills, Datasources y MCP Servers — proporcionando un registro de solo lectura de lo que se incluyó en ese lanzamiento.

Mejores Prácticas​

  • Asigne todos los agentes al borrador antes de hacer clic en Suggest from manifest — el motor de sugerencias analiza el cierre completo del agente y omitirá las habilidades o fuentes de datos pertenecientes a agentes que aún no se hayan añadido.
  • Use Save con frecuencia durante la edición; Publish está deshabilitado mientras haya cambios sin guardar, por lo que siempre se requiere guardar antes de lanzar una versión.
  • Active Suite preview durante el ciclo de revisión para que las partes interesadas en Hub puedan inspeccionar el manifiesto antes de que se instale en un espacio de trabajo de producción.
  • Use el modo de visibilidad Tenant allowlist al probar una nueva suite con un cliente específico antes de ponerla a disposición de todos los inquilinos.
  • Escriba un registro de cambios significativo para cada publicación — es el único registro que tienen los consumidores y los equipos de soporte sobre lo que cambió entre versiones.
  • Previsualice el manifiesto antes de cada publicación para revisar los recuentos de cierre y detectar cualquier advertencia de configuración con anticipación.

Páginas Relacionadas​