Gestion des versions de pack
Consultez l'état d'installation pour tous les types de contenu, analysez l'impact sur les workflows et mettez à jour les packs depuis la page du catalogue Packs.
L'onglet Paramètres → Plateforme → Packs → Catalogue est l'emplacement central pour suivre la version installée de chaque pack, consulter l'état d'installation par type de contenu et appliquer les mises à jour. Pour le modèle de versionnement complet du point de vue d'un auteur de pack — règles semver, liste de contrôle de publication et fonctionnement des pins/politiques — voir Versionnement des packs. La marketplace Ajouter une intégration affiche un badge et un lien lorsqu'une intégration de pack dispose d'une mise à jour — les mises à jour s'effectuent toujours depuis la page Packs.
Voir où un pack est utilisé
La colonne En cours d'utilisation du tableau du catalogue indique ce que chaque pack installé a réellement produit dans votre organisation :
- Workflows — workflows déployés depuis le pack, par environnement d'espace de travail. Cliquez sur un workflow pour l'ouvrir dans Agentic.
- Flux de processus — instances de flux de processus actives créées à partir des modèles du pack. Le compteur représente le total réel ; le popover liste les 25 plus récents. Cliquez sur une instance pour l'ouvrir dans Agentic.
- Sources de données — sources de données installées depuis le pack. Cliquez pour ouvrir la page des sources de données dans Analytics.
Un tiret (—) signifie que le pack est dans votre catalogue mais n'est actuellement utilisé nulle part — signal utile avant de retirer un pack.
En développant une ligne de pack, vous obtenez les mêmes informations en détail, ainsi que les Workflows utilisant les intégrations de ce pack : les workflows de votre organisation dont les blocs appellent une intégration installée par ce pack. Il s'agit de la même analyse d'impact que celle effectuée lors d'une mise à jour — affichée en permanence pour vous permettre d'évaluer le rayon d'action avant de retirer ou de mettre à jour un pack.
Si un panneau affiche État indisponible, un service sous-jacent n'a pas pu être atteint ; les autres panneaux restent exacts.
Colonne État d'installation
Chaque ligne de l'onglet Catalogue affiche un pack à sa version la plus récente disponible. La colonne État d'installation indique l'état le plus important parmi tous les types de contenu de ce pack :
| État | Signification |
|---|---|
| Mise à jour disponible | Au moins un type de contenu dispose d'une version plus récente dans le catalogue que celle actuellement installée. |
| Installé | Tous les types de contenu installés sont à jour (aucune mise à jour nécessaire). |
| Non installé | Aucun contenu de ce pack n'a été installé dans votre organisation. |
Lorsqu'une mise à jour est disponible, la colonne version affiche la version installée aux côtés de la plus récente : par exemple v1.1.0 → v1.1.1.
Ligne développée — État par type de contenu
Cliquez sur une ligne pour la développer et voir l'état d'installation ventilé par type de contenu :
Intégrations
Une ligne par vendeur inclus dans le pack. Affiche la version installée et indique si une mise à jour est en attente. La vérification de mise à jour est basée sur le hash de l'artefact : si l'artefact publié diffère de celui installé, une mise à jour est disponible.
Ontologie et domaines KB
Affiche la version du pack installée et la date de dernière application. Ces types de contenu s'appliquent à toute l'organisation au moment de l'installation.
Workflows
Affiche une ligne par environnement d'espace de travail dans lequel les workflows de ce pack ont été déployés. Chaque ligne inclut :
- Le nom de l'environnement d'espace de travail.
- La version du pack installée, ou version inconnue si le workflow a été déployé avant l'introduction du suivi de version. « Version inconnue » est sans gravité — le workflow fonctionne, mais sa version de pack ne peut pas être comparée.
Le déploiement d'un workflow dans un espace de travail est une action distincte effectuée dans la Marketplace. La page Packs affiche les workflows déjà déployés ; les environnements « non déployés » sont omis de la liste.
Sources de données
Affiche une ligne par environnement d'espace de travail dans lequel une source de données de ce pack est installée. L'installation et la configuration des sources de données se font dans les paramètres des sources de données de l'application Analytics.
Flux de processus
Les flux de processus suivent toujours la version la plus récente du catalogue — ils n'ont pas de version installée fixe. La ligne développée affiche un badge le confirmant. Il n'y a pas d'action de mise à jour pour les flux de processus ; ils utilisent automatiquement le contenu de la dernière ligne de catalogue active pour ce pack.
Mise à jour d'un pack
Lorsqu'au moins un type de contenu dispose d'une mise à jour disponible, une barre de mise à jour apparaît en haut de la ligne développée.
Cliquez sur le pack dans l'onglet Catalogue pour ouvrir la vue développée. Si une mise à jour est disponible, la barre de mise à jour affiche la version cible (par exemple, Mettre à jour vers v1.1.1) et un résumé des intégrations qui seront affectées.
Pour les packs incluant du contenu d'intégration, la plateforme charge automatiquement une analyse d'impact sur les workflows — indiquant quels workflows référencent des outils des intégrations de ce pack. Le bouton Mettre à jour le pack reste désactivé jusqu'à la fin de cette analyse.
Si le chargement de l'analyse d'impact échoue, le bouton Mettre à jour le pack reste désactivé. Vérifiez votre connexion réseau ou contactez votre administrateur de plateforme.
La plateforme compare les manifestes d'intégration installé et cible, et liste les changements incompatibles détectés directement dans la barre de mise à jour : outils supprimés, nouvelles entrées obligatoires, types d'entrée/sortie modifiés ou changements de mode d'authentification — chacun annoté avec l'outil concerné.
Deux niveaux d'avertissement peuvent apparaître :
- Potentiellement incompatible (orange) — la mise à jour est une version majeure, ou le diff de manifeste a trouvé des changements incompatibles correctement déclarés par l'auteur.
- Changements incompatibles dans une mise à jour non majeure (rouge) — le diff de manifeste a trouvé des changements incompatibles mais la version n'est incrémentée qu'en mineur ou en patch. Traitez cela avec une vigilance accrue et contactez l'auteur du pack.
Examinez la liste des workflows affectés en lien avec ces constats avant de continuer.
La plateforme installe la dernière version du catalogue pour ce pack. Tous les types de contenu sont mis à jour ensemble — intégration, ontologie, workflows déployés dans chaque environnement et sources de données. Un toast de succès confirme la mise à jour.
Cliquer sur Mettre à jour le pack déplace également le pin de version de votre organisation pour les intégrations du pack : les exécutions de workflows en cours se terminent avec la version qu'elles ont démarrée, et les nouvelles exécutions utilisent la version mise à jour.
Épinglage de version et politiques de mise à jour
Les versions d'intégration installées sont épinglées par connexion. Une version plus récente arrivant dans votre catalogue (par exemple via une synchronisation de source pack Git) est mise en attente mais inactive — rien ne change dans ce qu'exécutent vos workflows tant que le pin ne bouge pas. Le pin se déplace de deux façons :
- Manuellement — vous cliquez sur Mettre à jour le pack après la revue d'impact (comportement par défaut pour chaque connexion).
- Automatiquement — une connexion peut s'inscrire aux mises à jour automatiques via sa politique de mise à jour :
| Politique | Comportement |
|---|---|
manual (défaut) | Les mises à jour sont uniquement mises en attente ; vous les appliquez depuis la page Packs. |
auto_patch | Les versions patch (1.1.0 → 1.1.1) s'appliquent automatiquement lorsque le diff de manifeste ne détecte aucun changement incompatible. |
auto_minor | Les versions patch et mineures s'appliquent automatiquement lorsque le diff de manifeste ne détecte aucun changement incompatible. |
Les mises à jour automatiques ne s'appliquent jamais lorsque le diff de manifeste détecte un changement incompatible — la connexion est signalée (mise à jour bloquée : breaking_diff) et la mise à jour attend votre révision manuelle sur la page Packs. Les versions majeures nécessitent toujours une mise à jour manuelle.
Erreurs de compatibilité SDK
Les bundles d'intégration sont compilés contre une version spécifique du SDK de création Scrydon. Si un bundle a été construit contre un contrat SDK que la plateforme ne supporte plus (ou pas encore), vous verrez :
- Au moment de l'installation : l'installation du pack échoue avec
integration_contract_incompatibleet un message indiquant les versions de contrat concernées. - Au moment de l'exécution : les outils du bundle échouent avec
BUNDLE_CONTRACT_INCOMPATIBLEau lieu de s'exécuter.
Ces deux messages signifient la même chose : le bundle doit être republié avec une version actuelle de @scrydon/sdk-authoring. Si vous êtes l'auteur du pack, reconstruisez-le avec le dernier SDK et publiez une nouvelle version ; s'il provient d'un vendeur, demandez-lui une version mise à jour. Les bundles construits contre le contrat SDK immédiatement précédent continuent de fonctionner — la plateforme effectue la traduction automatiquement.
Autres versions actives du catalogue
En bas de la ligne développée, Autres versions actives du catalogue liste les versions plus anciennes de ce pack encore présentes dans votre catalogue (par exemple, si une version précédente était installée et que le catalogue n'a pas été nettoyé). Ces entrées sont informatives — elles indiquent ce qui est disponible mais ne constituent pas la version installée active.
Trouver les mises à jour des intégrations dans la Marketplace
Lorsqu'une intégration de pack dispose d'une mise à jour, sa carte dans Paramètres → Plateforme → Intégrations → Ajouter une intégration affiche un badge Mise à jour au lieu du statut habituel. Cliquer sur la carte ou son action ouvre Paramètres → Plateforme → Packs avec le pack concerné présélectionné, afin que vous puissiez examiner l'impact et appliquer la mise à jour depuis cet emplacement.
Les intégrations déjà installées et à jour affichent un indicateur À jour dans le groupe Depuis votre catalogue de packs. Elles restent visibles pour vous permettre d'ouvrir la configuration du vendeur sans quitter la marketplace.