Saltar al contenido principal

​
¿Qué es el Historial de Versiones?

El Historial de Versiones proporciona control de versiones estilo Git para las configuraciones de tu agente. Te permite rastrear cambios, revisar versiones anteriores, revertir a configuraciones previas y gestionar múltiples ramas de desarrollo.
El Historial de Versiones asegura que nunca pierdas tu trabajo y siempre puedas volver a una configuración conocida y funcional.

​
Accediendo al Historial de Versiones

El Historial de Versiones está ubicado en el panel derecho del Editor Avanzado. Haz clic en la pestaña “Cambios” para acceder a las funciones de control de versiones. Panel de Cambios

​
Nuevo Panel de Cambios

El panel de cambios renovado proporciona una experiencia de control de versiones similar a Git, con tres vistas principales:

​
Vista de Cambios

Muestra todas las modificaciones pendientes que aún no se han confirmado. Vista de Cambios

​
Vista de Historial

Presenta un registro cronológico de todas las versiones guardadas. Vista de Historial

​
Vista de Ramas

Permite gestionar múltiples ramas de desarrollo (próximamente).

​
Conceptos Clave

​
Versiones

Cada configuración guardada es una versión. Las versiones están numeradas y con timestamp:
PropiedadDescripción
Número de VersiónIdentificador auto-incremental (v1, v2, v3…)
TimestampCuándo se creó la versión
Mensaje de CommitDescripción de los cambios
AutorQuién hizo los cambios

​
Estado de Git

El sistema indica el estado actual de tu configuración:
EstadoDescripciónIndicador
CleanSin cambios pendientes🟢 Verde
ModifiedTiene cambios sin confirmar🟡 Amarillo
SyncingSincronizando con servidor🔵 Azul

​
Versión de Producción

La versión marcada como “Production” es lo que está desplegado y activo para llamadas reales de clientes.

​
Seguimiento de Cambios en Tiempo Real

​
Detector de Cambios Automático

El sistema rastrea automáticamente cualquier modificación que hagas:
1

Editar Configuración

Haz cambios en cualquier sección del agente.
2

Detección Automática

Los cambios se detectan instantáneamente y se muestran en el indicador de estado.
3

Ver Detalles

Ve el panel de cambios para revisar qué se modificó exactamente.

​
Tipos de Cambios

El sistema categoriza los cambios por tipo:
  • Agregado - Contenido nuevo que no existía antes
  • Modificado - Contenido existente que fue editado
  • Eliminado - Contenido que fue removido

​
Viendo Cambios Detallados

​
Panel de Cambios Expandido

Cada cambio muestra información detallada: Detalles de Cambios
1

Navegar a Cambios

Haz clic en la pestaña “Cambios” en el panel derecho.
2

Revisar Lista

Ve todos los cambios organizados por sección.
3

Expandir Detalles

Haz clic en cualquier cambio para ver los valores anterior y nuevo.
4

Seleccionar para Confirmar

Marca los cambios que quieres incluir en el commit.

​
Organización por Secciones

Los cambios se agrupan automáticamente por sección:
  • Configuraciones Básicas - Nombre, idioma
  • Prompt - Prompt del sistema
  • Saludos - Mensajes de entrada y salida
  • Configuración de Voz - ID de voz y ajustes
  • Acciones y Herramientas - Transferencias, llamadas finales
  • Parámetros de Entrada - Variables de entrada
  • Configuración de Salida - Webhooks y parámetros de salida
  • Evaluaciones - Criterios de éxito

​
Confirmando Cambios

​
Proceso de Commit

1

Revisar Cambios

Verifica que todas las modificaciones son intencionales.
2

Seleccionar Cambios

Marca los cambios específicos que quieres confirmar.
3

Escribir Mensaje

Proporciona un mensaje descriptivo del commit.
4

Confirmar

Haz clic en “Commit Changes” para guardar la nueva versión.
Diálogo de Commit

​
Mensajes de Commit Inteligentes

Escribe tu propio mensaje descriptivo:
Actualizar prompt para mejorar manejo de objeciones

- Agregar ejemplos de respuestas a preocupaciones de precio
- Mejorar tono para ser más empático
- Incluir estrategias de seguimiento
Los mensajes de commit generados por IA analizan tus cambios específicos para crear descripciones precisas y útiles.

​
Explorando el Historial de Versiones

​
Vista de Historial

1

Abrir Historial

Haz clic en la pestaña “Historia” dentro del panel de cambios.
2

Explorar Versiones

Desplázate por la lista cronológica de versiones.
3

Ver Detalles

Haz clic en cualquier versión para ver información detallada.
Historial de Versiones

​
Información de Cada Versión

CampoDescripción
🔢 VersiónNúmero de versión (v1, v2, v3…)
📅 FechaTimestamp de creación
💬 MensajeMensaje de commit
👤 AutorUsuario que hizo los cambios
🏷️ EtiquetasProduction, Latest, etc.
📊 ResumenCantidad de cambios incluidos

​
Filtros y Búsqueda

Encuentra versiones específicas rápidamente:
  • Filtro por autor - Ver solo cambios de usuarios específicos
  • Filtro por fecha - Rangos de tiempo personalizados
  • Búsqueda de texto - Buscar en mensajes de commit
  • Filtro por etiquetas - Production, development, etc.

​
Restaurando Versiones

​
Proceso de Restauración

Restaurar una versión creará una nueva versión con la configuración antigua. Tus cambios actuales se preservarán en el historial.
1

Localizar la Versión

Navega por el historial para encontrar la versión deseada.
2

Revisar Cambios

Verifica qué configuración tenía esa versión.
3

Iniciar Restauración

Haz clic en “Restore Version” en la versión seleccionada.
4

Confirmar Acción

Confirma que quieres restaurar esta configuración.
5

Probar Configuración

Usa el Playground para validar la configuración restaurada.

​
Opciones de Restauración

Cuando restauras una versión, puedes elegir:
  • Restauración completa - Revertir toda la configuración
  • Restauración selectiva - Solo ciertos campos o secciones
  • Crear rama - Restaurar en una nueva rama de desarrollo

​
Gestión de Producción

​
Marcar Versión como Producción

1

Seleccionar Versión

Elige la versión que quieres desplegar a producción.
2

Validar Configuración

Asegúrate de que la configuración ha sido probada.
3

Marcar como Producción

Haz clic en “Set as Production” en la versión.
4

Confirmar Despliegue

Confirma que quieres que esta versión maneje llamadas reales.
Despliegue a Producción

​
Indicadores de Estado de Producción

El sistema muestra claramente qué versión está en producción:
  • 🔴 Production - Versión actualmente desplegada
  • 📊 Latest - Versión más reciente (puede diferir de production)
  • 🚧 Development - Versiones de desarrollo y pruebas
Solo la versión marcada como “Production” maneja llamadas reales de clientes. Todas las demás versiones están en modo de desarrollo.

​
Colaboración y Sincronización

​
Estados de Colaboración

Cuando múltiples usuarios trabajan en el mismo agente:
EstadoDescripciónAcción Sugerida
🟢 CleanSin conflictosContinuar trabajando
🟡 ModifiedCambios localesConfirmar o sincronizar
🔴 ConflictsCambios conflictivosResolver conflictos
🔒 LockedUsuario trabajandoEsperar o contactar usuario

​
Resolución de Conflictos

Cuando hay conflictos entre versiones:
1

Detectar Conflictos

El sistema te alerta sobre cambios conflictivos.
2

Revisar Diferencias

Ve qué campos tienen conflictos específicos.
3

Elegir Resolución

Selecciona mantener tus cambios o aceptar los remotos.
4

Confirmar Resolución

Confirma los cambios resueltos como nueva versión.

​
Flujos de Trabajo Recomendados

  1. Hacer cambios pequeños e incrementales
  2. Confirmar frecuentemente con mensajes claros
  3. Probar cada versión en el Playground
  4. Desplegar a producción solo después de validación
  1. Identificar el problema en producción
  2. Hacer el cambio mínimo necesario
  3. Probar rápidamente en Playground
  4. Confirmar con mensaje descriptivo de hotfix
  5. Desplegar inmediatamente a producción
  1. Planificar cambios significativos
  2. Hacer múltiples commits con cambios relacionados
  3. Probar exhaustivamente cada componente
  4. Validar la integración completa
  5. Desplegar a producción en horario planificado
  1. Detectar problema en producción
  2. Localizar la última versión estable conocida
  3. Restaurar inmediatamente esa versión
  4. Marcar como producción
  5. Investigar el problema en paralelo

​
Mejores Prácticas

​
Para Mensajes de Commit

Actualizar estrategia de manejo de objeciones

Mejorar respuesta a preocupaciones de precio con ejemplos específicos

Corregir bug en validación de parámetros de entrada

Optimizar prompt para reducir latencia de respuesta

​
Para Gestión de Versiones

Siempre prueba las configuraciones en el Playground antes de desplegar a producción.
  • Confirma frecuentemente - Crea puntos de restauración regulares
  • Usa mensajes descriptivos - Facilita la navegación futura
  • Valida antes de producción - Evita problemas con clientes
  • Mantén historial limpio - No confirmes cambios experimentales

​
Atajos de Teclado

AcciónShortcutDescripción
Ver Cambios⌘GAbre el panel de cambios
Confirmar Rápido⌘⇧GAbre diálogo de commit
Seleccionar Todo⌘ASelecciona todos los cambios
Generar Mensaje⌘⇧MGenera mensaje con IA

​
Solución de Problemas

Causas posibles:
  • Cambios muy pequeños no detectados
  • Error de sincronización temporal
Solución:
  1. Refrescar la página
  2. Hacer un cambio más significativo
  3. Contactar soporte si persiste
Causas posibles:
  • Sin permisos de edición
  • Conflictos no resueltos
  • Problema de conectividad
Solución:
  1. Verificar permisos del agente
  2. Resolver conflictos pendientes
  3. Comprobar conexión a internet
Causas posibles:
  • Error en la configuración
  • Falta validación requerida
  • Problema temporal del servidor
Solución:
  1. Validar configuración en Playground
  2. Revisar campos obligatorios
  3. Intentar nuevamente en unos minutos

​
Siguientes Pasos

Playground

Prueba versiones antes de desplegar

Configuración Básica

Configura ajustes del agente

Pruebas Automatizadas

Configura pruebas de regresión

Monitoreo

Supervisa el rendimiento en producción