Explorar la documentación
AI-Soda Brain

Administrar versiones y compatibilidad

Realice un seguimiento del lanzamiento del producto, la configuración del modelo, las definiciones de datos y las versiones del contenido por separado. Esto ayuda a los equipos a anticipar el efecto de una actualización y explicar por qué una respuesta cambió posteriormente.

Guía técnica · Noviembre 20263 min de lectura

Un resultado depende de varias versiones

Los resultados de la misma pregunta pueden cambiar porque se actualizaron los datos de negocio o porque cambiaron el modelo, las herramientas, el índice de conocimiento o las definiciones de métricas. Asocie esas versiones con la hora de la ejecución, así como con el número de versión del producto.

Esta guía analiza la gestión de versiones. Consulte las notas de la versión entregada para conocer las funciones disponibles, los entornos compatibles, las correcciones y las limitaciones conocidas.

Mantener un registro de compatibilidad

RegistroPropósito
Versiones de productos y componentesIdentificar la implementación y sus dependencias.
Configuración de modelo y claveCompare el comportamiento de inferencia y los requisitos de recursos.
Versiones de conector y fuente de datosIdentificar diferencias en esquemas y protocolos.
Ontología y definiciones de los indicadoresExplicar los cambios en las reglas de cálculo.
Versiones de documentos y paquetes industrialesRastree fuentes de conocimiento y plantillas de tareas.
Versión del contrato del clienteValide API y la compatibilidad de integración.

Cuatro preguntas sobre las notas de la versión

  • ¿El cambio afecta las preguntas existentes, los permisos de acceso o los archivos generados?
  • ¿Requiere una migración manual de datos o configuración?
  • ¿Se conservan los registros de la versión anterior y qué se necesita para volver a ella?
  • ¿Qué casos de éxito y fracaso deben volver a probarse?

Mantenga resultados de actualización comparables

Ejecute un conjunto de preguntas representativas con la misma instantánea e identidad. Compare respuestas, fuentes, estados de ejecución y tiempos transcurridos por separado. Si la nueva versión cambia una definición de negocio, explique la diferencia antes de decidir si se vuelven a calcular los resultados históricos.

Al actualizar la documentación del sitio, conserve el alcance aplicable y la fecha de revisión. Los enlaces más antiguos deberían llevar a los lectores a la guía relevante o a una ruta de migración explícita para que los equipos que mantienen integraciones existentes aún puedan encontrar el material adecuado.

Pruebe con "permisos", "fuente de datos", "fabricación" o "API".