Borradores y publicación

De forma predeterminada, cada cambio que guardas en un agente llega a todos sus canales a la vez. Activa el control de versiones para trabajar en un borrador: tus usuarios siguen hablando con la versión publicada hasta que publiques el borrador, y cada lanzamiento se conserva para que puedas volver a él.

El control de versiones se configura por agente. Los agentes que nunca lo activan se comportan exactamente igual que antes.

Activar el control de versiones

Abre el agente. Un panel en la parte superior del formulario muestra Changes go live immediately. Selecciona Turn on versioning.

La configuración que se está ejecutando en ese momento se convierte en la versión 1, por lo que siempre tienes un punto de partida al cual volver. A partir de entonces, Update Agent guarda en el borrador.

Necesitas el permiso agents.publish para activar o desactivar el control de versiones, publicar, aprobar y restablecer. Para editar el borrador, solo necesitas agents.edit. Consulta Usuarios y roles.

Qué contiene el borrador

El borrador abarca el comportamiento del agente:

Prompt del sistema
Configuración del modelo
Harness y memoria inicial
Bases de conocimiento, herramientas, herramientas predefinidas, servidores MCP, subagentes y habilidades
Modelo e idioma de voz

Todo lo demás, como el nombre, la descripción y las credenciales de los canales, se aplica en cuanto guardas, con o sin control de versiones. Revertir el prompt de la semana pasada nunca revierte un token de bot que rotaste ayer.

Hay una sola versión para todos los canales. No puedes publicar un cambio solo para el chat web.

Los cambios que hace el Agent Builder no pasan por el borrador: se aplican directamente al agente en producción, incluso con el control de versiones activado.

Publicar un borrador

Edita el agente y selecciona Update Agent. El panel cambia a Unpublished changes y enumera lo que difiere de la versión en producción.
Selecciona Review changes para ver una comparación línea por línea del borrador con lo que está en producción.
De manera opcional, evalúa el borrador. En Evaluate this draft against, elige un conjunto de datos y selecciona Run. El agente no se modifica. Consulta Evaluaciones.
De manera opcional, describe el cambio en What changed, in your words (optional). La nota se conserva en el historial de versiones.
Selecciona Publish. El borrador se publica en todos los canales como una nueva versión.

Para descartar el borrador, selecciona el ícono de papelera junto a Publish. El agente vuelve a lo que está en producción.

Qué abarca la evaluación de un borrador

La evaluación de un borrador prueba el prompt del sistema y la configuración del modelo del borrador. Las herramientas, el conocimiento y el harness provienen del agente en producción. Si tu borrador también los cambia, la confirmación indica los cambios que la ejecución no refleja.

Política de publicación

En la parte inferior del panel, hay dos reglas opcionales.

Configuración	Qué hace
Someone else has to approve a publish	Publish se convierte en Request review. El borrador se publica solo cuando otra persona con `agents.publish` lo aprueba.
Refuse to publish below … % on its last evaluation	Se rechaza la publicación cuando la evaluación más reciente del agente obtuvo una tasa de aprobación inferior a este valor. Déjalo vacío para no establecer un mínimo.

El panel siempre muestra el resultado de Last evaluation junto al botón de publicación, establezcas o no un mínimo.

Revisiones

Cuando se requiere aprobación, una solicitud muestra Waiting for review con su nota y la hora.

Un revisor selecciona Approve and publish o Reject. Rechazar deja el borrador intacto.
No puedes aprobar tu propia solicitud.
Aprobar publica exactamente lo que se revisó, incluso si el borrador cambió después de hacer la solicitud.
Una solicitud nueva reemplaza a la que está abierta. Selecciona Withdraw para cancelar una solicitud.

Historial y reversión

Selecciona History para ver cada versión publicada con su fecha, su puntuación de evaluación y su nota. La versión que reciben tus usuarios está marcada como live.

Para volver atrás, selecciona Restore en una versión anterior. Se publica de inmediato como una nueva versión en la parte superior del historial, por lo que el registro de lo que ocurrió nunca se reescribe.

Restablecer omite tanto el paso de aprobación como el mínimo de tasa de aprobación. Un lanzamiento defectuoso está en producción, y retirarlo no debería tener que esperar.

Desactivar el control de versiones

Selecciona Turn versioning off. Cualquier borrador pendiente se publica primero y, a partir de ese momento, los cambios guardados vuelven a publicarse de inmediato.