Gestion des versions de extension
Consultez l'état d'installation pour tous les types de contenu, analysez l'impact sur les workflows et mettez à jour les extensions depuis la page du catalogue Extensions.
La ligne d'une extension dans Paramètres → Plateforme → Extensions → Installées (et les onglets Inclus et Version & sécurité de sa fiche) est l'emplacement central pour suivre la version installée, 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 extension — règles semver, liste de contrôle de publication et fonctionnement des pins/politiques — voir Versionnement des extensions. Lorsqu'une intégration de extension dispose d'une mise à jour, sa ligne dans l'onglet Extensions → Installées l'affiche dans la colonne version — 1.3.0 → 1.4.0 — jamais sur la ligne d'état, afin qu'une mise à jour en attente ne masque jamais un identifiant défaillant. La mise à jour elle-même s'examine et s'applique dans l'onglet Version & sécurité de l'extension.
Comportement des mises à jour par type de contenu
Tous les types de contenu d'une extension ne se mettent pas à jour de la même manière — la plateforme applique le minimum d'automatisation qui reste sûr pour chaque type. Ce tableau est le modèle mental ; les sections ci-dessous détaillent chacun.
| Type de contenu | Mode de mise à jour | Pourquoi |
|---|---|---|
| Sources de données de référence statiques (données en ligne, sans appel externe) | Automatique à la synchronisation — installées dès qu'une mise à jour de extension atteint votre catalogue, sauf si la politique de l'extension est Manuelle. | Additives, ne font aucun appel externe et ne peuvent pas écraser vos données — le type le plus sûr. |
| Sources de données externes (polling) | Installer depuis Analytics → Marketplace — Mettre à jour vers vX réconcilie l'ensemble complet des sources de l'extension. | Une nouvelle source commence à appeler un système externe ; son installation relève donc de votre décision. |
| Ontologie et domaines KB | Les nouveaux éléments de schéma s'appliquent automatiquement à la synchronisation dans chaque environnement d'espace de travail existant où l'extension est déjà installée ; les changements d'éléments existants, et les nouveaux domaines KB, s'appliquent lorsque vous cliquez sur Mettre à jour l'extension. | Ajouter de nouveaux types d'objets/liens est sûr ; les modifier ou les supprimer peut affecter les tables liées, l'analytique et le graphe. |
| Flux de processus | Automatique — toujours la dernière version du catalogue. | Un modèle n'apparaît que dans la galerie ; il n'exécute rien tant qu'un espace de travail ne s'y abonne pas. |
| Intégrations | Par connexion : manual (par défaut), ou auto_patch / auto_minor en option ; les changements cassants sont toujours retenus. | Code fournisseur exécutable + identifiants + egress — le type le plus à risque. |
| Workflows | Déployés par environnement depuis la page Extensions agentic ; redéployez pour mettre à jour. | Vous choisissez quel environnement exécute quelle version. |
| Notebooks | Stockés à l'installation ; matérialisés / mis à jour par espace de travail dans Analytics. | Rien ne s'exécute tant que vous ne l'avez pas matérialisé. |
Garanties de sécurité, toujours : une application automatique ne fait qu'ajouter — elle ne supprime jamais vos données, n'écrase jamais une source ou un type que vous avez déjà, ne démarre jamais un nouvel appel externe, et n'exécute jamais de nouveau code sans vous. Un changement cassant d'intégration n'est jamais appliqué automatiquement — il est signalé et attend votre revue.
Chaque extension possède une politique de mise à jour (par défaut Automatique). Le contenu additif et sans egress — les sources de données de référence statiques et les nouveaux éléments de schéma d'ontologie — s'installe automatiquement dès qu'une mise à jour de extension atteint votre catalogue. Réglez la politique d'une extension sur Manuelle pour revoir chaque mise à jour vous-même ; tout ce qui appelle un système externe, exécute du code ou modifie un élément existant conserve toujours son étape de revue, quelle que soit la politique. Pour que vous ne manquiez jamais une mise à jour retenue, l'onglet Inclus de l'extension signale les sources de données déclarées mais non installées (« N disponibles, non installées ») et la carte affiche un état non provisionné lorsque la table sous-jacente d'une couche est manquante — au lieu d'un « (0) » silencieux.
Voir où une extension est utilisé
La colonne En cours d'utilisation du tableau du catalogue indique ce que chaque extension installé a réellement produit dans votre organisation :
- Workflows — workflows déployés depuis l'extension, 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 de l'extension. 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 l'extension. Cliquez pour ouvrir la page des sources de données dans Analytics.
Un tiret (—) signifie que l'extension est dans votre catalogue mais n'est actuellement utilisé nulle part — signal utile avant de retirer une extension.
En développant une ligne de extension, vous obtenez les mêmes informations en détail, ainsi que les Workflows utilisant les intégrations de cette extension : les workflows de votre organisation dont les blocs appellent une intégration installée par cette extension. 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 une extension.
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 une extension à 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 cette extension :
| É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 cette extension 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.
Pour le contenu d'ontologie, cet état à l'échelle de l'organisation est volontairement strict. Il n'est affiché qu'après lecture de tous les environnements d'espace de travail attendus et confirmation de la même version d'extension, de la même identité d'ontologie, de la même provenance de catalogue/source et du même manifeste normalisé dans chacun d'eux. Un environnement manquant ou divergent fait apparaître État indisponible dans le panneau d'ontologie au lieu de choisir une ligne et de la présenter comme vérité à l'échelle de l'organisation.
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 l'extension. 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 une version installée représentative de l'extension et la date de dernière application, mais uniquement lorsque tous les environnements d'espace de travail existants réussissent le contrôle de cohérence ci-dessus. Une installation ou mise à jour à l'échelle de l'organisation est diffusée vers chaque environnement existant ; une installation/mise à jour depuis Analytics → Marketplace ne cible que l'environnement actif.
La cohérence inclut la ligne du catalogue, l'identifiant de la source de l'extension et la référence de l'entrée, ainsi que l'instantané complet du manifeste normalisé. Les identifiants de révision et horodatages propres aux environnements peuvent légitimement différer et ne servent pas à comparer les versions. Les champs de source peuvent être vides pour les installations anciennes ou manuelles, mais les lectures fondées sur le kernel renvoient toujours l'instantané du manifeste et préservent toute provenance disponible.
Pour les consommateurs de l'API, InstalledExtensionRow reste compatible avec le code source existant : sourceId et sourceEntryRef sont des champs optionnels-nullables ajoutés, et les anciens fixtures TypeScript peuvent toujours omettre manifestSnapshot dans leurs entrées. Une ligne installée renvoyée par le kernel fournit toujours le manifestSnapshot normalisé complet et les deux champs de provenance (éventuellement null) ; un client ne doit pas remplacer l'instantané par un hash ni par un sous-ensemble reconstruit.
Workflows
Affiche une ligne par environnement d'espace de travail dans lequel les workflows de cette extension ont été déployés. Chaque ligne inclut :
- Le nom de l'environnement d'espace de travail.
- La version de l'extension 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 extension ne peut pas être comparée.
Le déploiement d'un workflow dans un espace de travail est une action distincte effectuée sur la page Extensions agentic. L'onglet Inclus de l'extension 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 cette extension est installée. L'installation et la mise à jour des sources de données se font dans Analytics → Marketplace : lorsqu'une version plus récente de l'extension est dans le catalogue, chaque source installée y affiche une action Mettre à jour vers vX qui réconcilie l'ensemble des sources de données de l'extension — les sources existantes sont actualisées, les sources ajoutées par la nouvelle version sont installées, et celles qu'elle a supprimées sont retirées. Voir Extensions.
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 cette extension.
Mise à jour d'une extension
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 l'extension 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 extensions 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 cette extension. Le bouton Mettre à jour l'extension reste désactivé jusqu'à la fin de cette analyse.
Si le chargement de l'analyse d'impact échoue, le bouton Mettre à jour l'extension 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 de l'extension.
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 cette extension. Le code de l'extension reste la propriété de l'organisation ; le contenu d'ontologie et de KB est diffusé vers chaque environnement d'espace de travail existant. Un toast de succès ne confirme la mise à jour qu'une fois toutes les cibles d'ontologie réussies. Si une cible échoue, les cibles réussies restent appliquées et une nouvelle tentative reprend l'opération sans risque.
Le contenu par environnement est mis à jour depuis sa propre interface : les sources de données depuis Analytics → Marketplace (où la mise à jour réconcilie l'ensemble des sources de l'extension — voir Sources de données ci-dessus), et les workflows en les redéployant depuis la page Extensions agentic.
Cliquer sur Mettre à jour l'extension déplace également le pin de version de votre organisation pour les intégrations de l'extension : 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 extension 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 l'extension 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 l'onglet Version & sécurité de l'extension. |
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 dans l'onglet Version & sécurité de l'extension. Les versions majeures nécessitent toujours une mise à jour manuelle.
Erreurs de compatibilité SDK
Les archives d'intégration sont compilés contre une version spécifique du SDK de création Scrydon. Si une archive 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 de l'extension échoue avec
extension_contract_incompatibleet un message indiquant les versions de contrat concernées. - Au moment de l'exécution : les outils de l'archive échouent avec
BUNDLE_CONTRACT_INCOMPATIBLEau lieu de s'exécuter.
Ces deux messages signifient la même chose : l'archive doit être republié avec une version actuelle de @scrydon/sdk-authoring. Si vous êtes l'auteur de l'extension, reconstruisez-le avec le dernier SDK et publiez une nouvelle version ; s'il provient d'un vendeur, demandez-lui une version mise à jour. Les archives 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 cette extension 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 installées
Lorsqu'une intégration de extension dispose d'une mise à jour, la ligne du fournisseur dans Paramètres → Plateforme → Extensions → Installées l'affiche dans la colonne version sous la forme 1.3.0 → 1.4.0. La ligne d'état reste réservée à ce qui requiert une intervention humaine. Ouvrir la ligne mène à son onglet Version & sécurité, où la carte de mise à jour indique ce qui change et ce qui est conservé, et où vous l'appliquez.
Le catalogue Ajouter une extension ne propose que ce qui n'est pas encore installé ; une intégration de extension installée y est la ligne du fournisseur lui-même, atténuée sur place, avec Gérer qui ouvre sa fiche.