# Versiones y borradores

Guarda una instantánea del agente antes de un cambio, experimenta en un borrador y vuelve atrás con un clic

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Una **versión** es una instantánea del agente —prompt, configuración, modelo, herramientas, base de conocimiento y auditor— a la que puedes volver. Un **borrador** es una copia oculta del agente para experimentos: pruébalo y luego publícalo en la versión principal.

Ambos están en el panel **Versiones** de la barra superior del agente; **Abrir historial completo** muestra cada versión con su diff.

<VersionsPageDemo />

## Versiones [#versions]

**Guardar** solo mantiene en vivo el estado actual del agente; no crea una versión. Para registrar un punto al que puedas volver:

1. **Versiones** > **Crear versión**. El botón muestra el cambio pendiente (`+N −M`) y está desactivado si nada cambió desde la última versión.
2. Describe **Qué cambió** —p. ej., "Reescrita la sección de entrega del prompt"— y pulsa **Crear versión**.

Happ también registra versiones por sí mismo: al crear un agente o un borrador, antes de una restauración o una publicación (**guardado automático**) y cuando un agente de IA lo edita a través del [servidor MCP](/docs/settings/mcp) (**edición de IA**).

### Historial [#history]

**Abrir historial completo** lista las últimas 50 versiones con su origen —**guardada**, **guardado automático**, **reversión**, **publicada**, **edición de IA**—, el autor y la nota. Elige una para ver el diff respecto a la versión anterior, agrupado por sección: prompt, configuración, modelo y proveedor, herramientas, base de conocimiento, auditor. **Llamar a esta versión** hace una llamada de prueba con la voz de esa versión sin tocar el agente en vivo.

### Restaurar [#restore]

**Restaurar** en una versión sustituye la configuración del agente por ella. Primero se guarda automáticamente el estado actual y la restauración se añade encima como una nueva versión de **reversión**: el historial solo avanza, no se pierde nada. El agente de voz se resincroniza y los documentos de conocimiento modificados se reindexan solos.

## Borradores [#drafts]

Un borrador funciona en el playground y en las [pruebas](/docs/agents/tests), pero **no está conectado a canales ni teléfonos**: los clientes nunca llegan a él.

1. **Versiones** > menú de ramas > **Nuevo borrador desde aquí**, dale un nombre (por defecto "Dev").
2. Edita el borrador en las mismas pantallas que el agente. Los ajustes de voz son de solo lectura en un borrador; el modelo de texto se puede editar.
3. Pruébalo: **Prueba** en la barra superior, o **Pruebas** > **Ejecutar en** > el borrador.
4. **Poner este borrador en vivo** muestra el diff respecto a la versión principal y lo publica: el prompt, la configuración, las herramientas y el auditor del borrador sobrescriben la versión principal, se registra una versión **publicada** y el borrador se elimina.

Para crear un borrador a partir de una versión anterior, ábrela en el historial y elige &#x2A;*⋯** > **Borrador desde aquí**.

Límites: hasta **3 borradores** por agente, sin borradores de un borrador. La base de conocimiento se comparte con la versión principal y es de solo lectura en el borrador. Las herramientas que crean pedidos o leads en tu CRM no se copian a un borrador, así que los experimentos no pueden crear registros reales. Si la versión principal cambió después de crear el borrador, la publicación te avisa: esos cambios se sobrescribirán.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Siguiente [#next]

* [Pruebas](/docs/agents/tests): demuestra que el borrador es mejor antes de publicarlo
* [Agentes](/docs/agents): qué son los ajustes del agente
* [MCP](/docs/settings/mcp): deja que Claude o Cursor editen el agente, con cada edición versionada