Skip to main content
Esta página te ayudará a migrar tu instancia de Zylon a la versión v1.43.0
Seguir esta guía de migración es obligatorio cuando estás actualizando a versiones superiores a 1.43.0
La guía contiene los siguientes pasos:
  1. Preparación
  2. Actualización
  3. Configuración

​
1. Preparación

1

Localiza tu configuración actual

Encuentra tu configuración existente de Zylon en /etc/zylon/zylon-conf.yaml y ábrela.
2

Identifica tu patrón de configuración

Mira tu sección ai: actual y determina qué patrón coincide:
  • Solo tiene preset: → Escenario 1 (No se requiere acción)
  • Tiene config.embedding con configuraciones multilingües → Escenario 2
  • Tiene config.llm o configuraciones LLM personalizadas → Escenario 3a
  • Tiene config.embedding con configuraciones personalizadas → Escenario 3b
3

Aplica la migración correspondiente

Sigue el reemplazo exacto mostrado en tu escenario coincidente a continuación.
4

Guarda tus cambios

Actualiza tu archivo de configuración con el nuevo formato

​
Escenario 1: Solo preset base (no se requiere acción)

Cómo detectar: Tu configuración solo contiene una línea de preset sin ninguna sección config:. Configuración actual (no se requieren cambios): 
ai:
  preset: "baseline-48g"
Esta configuración permanece sin cambios y continuará funcionando como se espera.

​
Escenario 2: Configuración de embedding multilingüe

Cómo detectar: Tu configuración tiene config.embedding con configuraciones relacionadas con multilingüe. Configuración antigua: 
ai:
  preset: "baseline-48g"
  config:
    embedding:
      name: multilingual-e5-large
      contextWindow: 512
      vectorDim: 1024
      gpuMemoryUtilization: 0.10
      prefixQuery: "query:"
      prefixText: "passage:"
Configuración nueva: 
ai:
  preset: "baseline-48g,capabilities.multilingual"
El nuevo sistema de presets maneja automáticamente la configuración de embedding multilingüe con configuraciones predeterminadas óptimas, proporcionando la misma funcionalidad con una sintaxis mucho más simple.

​
Escenario 3: Configuración de modelo personalizado

Cómo detectar: Tu configuración tiene config.llm o config.embedding con configuraciones de modelo personalizadas.
Si tu configuración personalizada incluye configuraciones no relacionadas con modelos, esas configuraciones pueden permanecer iguales en el nuevo sistema. Solo las configuraciones específicas del modelo necesitan migrarse a la nueva estructura models.

​
Escenario 3a: Configuración LLM personalizada

Busca: config.llm o sección config con configuraciones específicas de LLM. Configuración antigua: Esta configuración está modificando la ventana de contexto predeterminada. 
ai:
  preset: "baseline-48g"
  config:
    llm:
      name: qwen-3-14b-awq
      contextWindow: 16384
      # ... other LLM settings
Configuración nueva: 
ai:
  preset: "baseline-48g"
  config:
    models:
      - id: llm
        contextWindow: 16384

​
Escenario 3b: Configuración de embedding personalizada

Busca: config.embedding con configuraciones personalizadas (no multilingües). Configuración antigua: Esta configuración está modificando la ventana de contexto predeterminada. 
ai:
  preset: "baseline-96g"
  config:
    embedding:
      name: mxbai-embed-large
      contextWindow: 512
Configuración nueva: 
ai:
  preset: "baseline-96g"
  config:
    models:
      - id: embed
        contextWindow: 512

​
Solución de problemas

Asegúrate de que la sintaxis YAML es correcta y todos los campos requeridos están correctamente indentados. El array models debe estar correctamente formateado con los valores id correctos.
El nuevo sistema debería garantizar el mismo rendimiento y configuración que antes. Por favor asegúrate de haber seguido correctamente la guía. Si sigues teniendo problemas, por favor contacta con el equipo de Zylon para comprobarlo.
Verifica que estás usando el formato de combinación de preset correcto: "baseline-48g,capabilities.multilingual".

​
2. Actualización

Ejecuta sudo zylon-cli update para actualizar Zylon

​
3. Configuración

Ahora vamos a habilitar Omnisearch para Agent Flows existentes.
1

Actualiza Zylon CLI a al menos la versión 1.16.0

Ejecuta sudo zylon-cli y comprueba la versión.Ejecuta sudo zylon-cli self-update si es necesario.
2

Rellenar contenido usando Zylon CLI

Ejecuta sudo zylon-cli backfill-agent-flow-content.Espera a que el script termine. Este comando se puede ejecutar múltiples veces y detenerse en cualquier momento.
Ya estás listo para empezar a buscar contenido dentro de Agent Flows con Omnisearch. No olvides habilitar tus idiomas preferidos (el predeterminado es inglés) para hacer Omnisearch lo más eficiente posible siguiendo la guía de configuración de búsqueda