> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/es/optimizacion-del-agente/agent-versions.md).

# Cómo gestionar las versiones del agente

Cada cambio en el prompt del agente debe registrarse como una versión. Las versiones te permiten probar nuevos prompts de forma segura y revertir instantáneamente si algo falla.

En el menú lateral, ve a Agente > General y haz clic en la pestaña Versiones.

## Cómo funcionan las versiones

Tu agente siempre tiene una versión Actual; la que está en producción. Cuando quieras hacer cambios, crea un Borrador. El Borrador te permite editar, probar en el Playground y activar solo cuando estés seguro de que funciona.

| Estado               | Qué significa                                                   |
| -------------------- | --------------------------------------------------------------- |
| Actual               | Activa en producción; los leads están hablando con esta versión |
| Borrador             | En progreso; aún no está activa                                 |
| Versiones anteriores | Instantáneas históricas en la lista de versiones                |

## Cómo crear una nueva versión

1. En la pestaña Versiones, haz clic en Crear Borrador.
2. Ve a la pestaña Objetivos y Tono y haz tus cambios.
3. Haz clic en Guardar.
4. Prueba en Agente > Playground; envía mensajes para confirmar que el nuevo comportamiento funciona.
5. Cuando estés listo, haz clic en Activar versión en el Borrador para convertirlo en la versión Actual.

{% hint style="warning" %}
Un Borrador no está activo hasta que lo actives. Tu agente continúa corriendo con la versión Actual mientras trabajas en el Borrador. No omitas las pruebas antes de activar; una vez activado, el Borrador reemplaza inmediatamente la versión Actual en producción.
{% endhint %}

## Cómo revertir a una versión anterior

1. Ve a Agente > General > Versiones.
2. Encuentra la versión que deseas restaurar en la lista de Historial de Versiones.
3. Pasa el cursor sobre la tarjeta de versión; aparece el botón Activar versión.
4. Haz clic en Activar versión. La versión seleccionada se convierte inmediatamente en la versión Actual y tu agente comienza a ejecutarla en producción.

### Cómo agregar una descripción a una versión

Cada versión tiene un botón + Agregar descripción. Úsalo para anotar qué cambió; por ejemplo: 'Ajusté el umbral de presupuesto a un mínimo de $10K' o 'Agregué ruta de descalificación para preguntas fuera del alcance'. Las descripciones facilitan encontrar la versión correcta cuando necesitas revertir.

## Buenas prácticas

* Siempre crea un Borrador antes de hacer cambios importantes en el prompt.
* Agrega una descripción a cada versión antes de activarla; te lo agradecerás cuando necesites revertir semanas después.
* Prueba en el Playground antes de activar.
* Cambia una cosa por versión; si cambias múltiples cosas en el mismo Borrador, no sabrás qué causó una caída en el rendimiento.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/es/optimizacion-del-agente/agent-versions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.