Un résultat dépend de plusieurs versions
Les résultats pour la même question peuvent changer parce que les données métier ont été actualisées ou parce que les définitions du modèle, des outils, de l’index de connaissances ou des métriques ont changé. Associez ces versions à l’heure de l’exécution ainsi qu’au numéro de version du produit.
Ce guide traite de la gestion des versions. Consultez les notes de version de la version livrée pour connaître les fonctionnalités disponibles, les environnements pris en charge, les correctifs et les limitations connues.
Tenir un registre de compatibilité
| Enregistrer | Objectif |
|---|---|
| Versions de produits et de composants | Identifiez le déploiement et ses dépendances. |
| Configuration du modèle et des clés | Comparez le comportement d’inférence et les besoins en ressources. |
| Versions du connecteur et de la source de données | Identifiez les différences dans les schémas et les protocoles. |
| Ontologie et définitions des indicateurs | Expliquer les modifications apportées aux règles de calcul. |
| Versions de documents et de packages industriels | Tracez les sources de connaissances et les modèles de tâches. |
| Version du contrat client | Validez API et la compatibilité d’intégration. |
Quatre questions à poser sur les notes de version
- Le changement affecte-t-il les questions existantes, les autorisations d’accès ou les fichiers générés ?
- Cela nécessite-t-il une migration manuelle des données ou de la configuration ?
- Peut-on conserver les enregistrements de la version précédente et que faut-il pour y revenir ?
- Quels cas de réussite et d’échec doivent être retestés ?
Conserver des résultats de mise à niveau comparables
Exécutez un ensemble de questions représentatives avec le même instantané et la même identité. Comparez séparément les réponses, les sources, les états d’exécution et les temps écoulés. Si la nouvelle version modifie une définition d’entreprise, expliquez la différence avant de décider de recalculer les résultats historiques.
Lors de la mise à jour de la documentation du site, conservez la portée et la date de révision applicables. Les liens plus anciens doivent diriger les lecteurs vers les conseils pertinents ou vers un chemin de migration explicite afin que les équipes qui maintiennent les intégrations existantes puissent toujours trouver le bon matériel.
