Parcourez la documentation
Haomai Technology AI Brain

Gérer les versions et la compatibilité

Suivez séparément la version du produit, la configuration du modèle, les définitions de données et les versions de contenu. Cela aide les équipes à anticiper l’effet d’une mise à niveau et à expliquer pourquoi une réponse a changé par la suite.

Guide technique · Novembre 20263 min de lecture

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é

EnregistrerObjectif
Versions de produits et de composantsIdentifiez le déploiement et ses dépendances.
Configuration du modèle et des clésComparez le comportement d’inférence et les besoins en ressources.
Versions du connecteur et de la source de donnéesIdentifiez les différences dans les schémas et les protocoles.
Ontologie et définitions des indicateursExpliquer les modifications apportées aux règles de calcul.
Versions de documents et de packages industrielsTracez les sources de connaissances et les modèles de tâches.
Version du contrat clientValidez 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.

Essayez « autorisations », « source de données », « fabrication » ou « API ».