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
| Registro | Propósito |
|---|---|
| Versiones de productos y componentes | Identificar la implementación y sus dependencias. |
| Configuración de modelo y clave | Compare el comportamiento de inferencia y los requisitos de recursos. |
| Versiones de conector y fuente de datos | Identificar diferencias en esquemas y protocolos. |
| Ontología y definiciones de los indicadores | Explicar los cambios en las reglas de cálculo. |
| Versiones de documentos y paquetes industriales | Rastree fuentes de conocimiento y plantillas de tareas. |
| Versión del contrato del cliente | Valide 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.
