Saltar al contenido principal

Gestión del Ciclo de Vida de Agentes

Cada agente en Beak AI Studio avanza a través de un ciclo de vida consistente: borrador → publicado → activo → inactivo. Las versiones se rastrean automáticamente, y la misma barra de herramientas en el editor de agentes controla cada transición.

Estados​

  • Borrador — Creado pero aún no publicado. Visible únicamente en la lista de Agentes. No está expuesto al Playground ni al Runtime.
  • Publicado — Marcado como disponible. Aparece en el selector de agentes del Playground y queda registrado en el Runtime. Se activa mediante el interruptor Publicado en la barra de herramientas del editor.
  • Activo — Estado predeterminado de un agente publicado. Responderá al tráfico del runtime.
  • Inactivo — Publicado pero deshabilitado. El ícono de encendido en la lista de Agentes alterna entre Activo e Inactivo sin despublicar el agente.

La lista de Agentes muestra el estado de publicación (Publicado / Borrador) y el estado activo (Activo / Inactivo) como chips separados en cada tarjeta.

Versionado​

Cada guardado crea una nueva versión (v1, v2, …). La etiqueta de versión aparece junto al nombre del agente en el encabezado del editor. Utilice el ícono de Historial en la lista de Agentes (o en el editor al reabrir un agente existente) para ver versiones anteriores y revertir si es necesario.

Nota: Publicar una nueva versión reemplaza la versión anterior en el Runtime. Los borradores en progreso nunca se publican automáticamente — debe activar el interruptor de forma explícita.

Probar Antes de Publicar​

El botón Probar en el editor abre el agente en el Playground en un nuevo hilo. El Playground siempre utiliza la última versión guardada (borrador o publicada), por lo que puede validar los cambios antes de activar el interruptor de publicación.

Exportar e Importar​

  • Exportar — El botón Exportar en un agente guardado descarga la definición del agente como JSON, incluyendo su prompt de sistema, configuraciones, selección de modelo y referencias a skills, fuentes de datos, sub-agentes y servidores MCP adjuntos.
  • Importar — El botón Importar en la lista de Agentes toma un archivo JSON exportado previamente y crea un nuevo borrador. Las referencias que no existan en el espacio de trabajo de destino deben volver a adjuntarse manualmente antes de publicar.

Este par es la ruta recomendada para promover agentes entre entornos (dev → qa → prod).

Descartar y Eliminar​

  • Descartar — Elimina los cambios no guardados en el editor y revierte a la última versión guardada.
  • Desactivar — El ícono de encendido cambia un agente publicado a Inactivo. El agente deja de responder al tráfico del runtime pero se conserva.

Mejores Prácticas​

  • Guarde los borradores con frecuencia. El runtime solo ve las versiones publicadas, por lo que trabajar en borrador es un espacio de trabajo libre.
  • Active el interruptor de publicación solo después de haber probado en el Playground — los cambios publicados afectan a los usuarios de producción de inmediato.
  • Utilice Exportar/Importar para la promoción entre entornos; no edite el mismo agente en dos entornos de forma manual.
  • Conserve una copia de respaldo Inactivo de la versión publicada anteriormente al implementar un cambio de prompt importante.

Páginas Relacionadas​