Versions
Chaque enregistrement d'un agent crée une version numérotée. Lisez le journal, comparez deux versions et revenez à une version antérieure.
Versions, sous Release dans la barre latérale du workspace, est l’historique de l’agent : chaque modification enregistrée, de la plus récente à la plus ancienne, avec un diff de ce qui a exactement changé et deux façons de revenir en arrière. Utilisez cette page pour savoir ce qu’un collègue a modifié, comparer le prompt avant et après une régression, et restaurer une version qui fonctionnait.
Le journal
Les versions sont numérotées v<major>.<revision> ; la révision augmente de 1 à chaque enregistrement.
Chaque publication démarre une nouvelle version majeure, et l’entrée correspondante porte la mention
Published (publiée). Un agent qui n’a jamais été publié peut afficher un simple numéro à la
place, par exemple v4.
La première entrée porte la mention Created (créée) accompagnée de la note
Initial configuration (configuration initiale) ; la plus récente porte la mention Latest
(la plus récente), et celle restaurée par un retour en arrière porte la mention Restored
(restaurée). Les entrées sont regroupées par jour, Today (aujourd’hui), Yesterday
(hier), puis la date, chacune avec son heure.
Chaque entrée nomme jusqu’à trois champs modifiés, sous forme d’étiquettes telles que System Prompt, Opening Message, Amd Timeout ou Post-Call Outcomes, avec +N lorsqu’il y en a davantage, ainsi que l’auteur de l’enregistrement. Le compteur en haut à droite indique le total ; Refresh recharge la liste après l’enregistrement d’une autre personne. Les historiques longs sont répartis sur plusieurs pages.
Lire un diff
Choisissez une entrée pour ouvrir son détail à droite. Le panneau a pour en-tête le numéro de version, Created ou Updated (mise à jour), Latest s’il s’agit de la plus récente, ainsi que l’auteur et l’heure. En dessous, deux sélecteurs, Previous version (version précédente) et Next version (version suivante), définissent la paire comparée ; par défaut il s’agit de l’entrée et de celle qui la précède, de sorte que le diff correspond à ce que cet enregistrement a modifié. Choisissez une autre paire pour comparer plusieurs enregistrements.
Chaque champ modifié constitue une ligne :
- + un champ qui a reçu une valeur, avec la valeur affichée, par exemple Amd Timeout 10.
- − un champ qui a perdu sa valeur.
- ~ un champ qui a été modifié, avec le nombre de lignes changées. Les champs de texte tels que System Prompt et Opening Message se déploient en un diff ligne à ligne : lignes supprimées barrées, lignes ajoutées surlignées.
Le system prompt est affiché comme un seul texte avec les marqueurs <<<CALLAB:IDENTITY>>>,
<<<CALLAB:TASKS>>> et <<<CALLAB:GUARDRAILS>>> entre les trois champs de l’éditeur ; c’est ainsi
que l’agent le reçoit.
Le bouton de fermeture en haut à droite du panneau ramène au journal.
Revenir à une version, ou annuler une modification
Sur toute version autre que la plus récente, le panneau de détail comporte deux boutons supplémentaires :
| Bouton | Ce qu’il fait |
|---|---|
| Rollback to this version | Rend l’agent identique à cette version : tous les champs, pas seulement ceux du diff. |
| Undo this change | Ramène l’agent à la version qui précède immédiatement celle-ci. Tous les champs reprennent la valeur de cette version : les modifications enregistrées après celle-ci sont donc elles aussi annulées. |
Chacun des deux boutons ouvre une confirmation, Rollback to Version N? (revenir à la version N ?), qui indique combien de champs vont changer, avec pour chacun sa valeur Current (actuelle) et sa valeur After restore (après restauration). Choisissez Rollback (revenir en arrière) pour confirmer. La restauration est un enregistrement ordinaire : elle ajoute une nouvelle entrée en haut du journal plutôt que de supprimer quoi que ce soit ; un retour en arrière peut donc lui-même être annulé, et le diff de la nouvelle entrée montre exactement ce qui a été restauré.
Trouvez la dernière version correcte
Ouvrez les entrées en partant du haut et lisez le diff jusqu’à atteindre l’enregistrement qui a introduit le problème.
Revenez en arrière
Sur l’enregistrement qui a introduit le problème, choisissez Undo this change, ou ouvrez la version qui le précède et choisissez Rollback to this version ; les deux restaurent cette version antérieure. Les modifications ultérieures que vous souhaitez conserver doivent être refaites.
Vérifiez
Le journal reçoit une nouvelle entrée Latest. Ouvrez-la et vérifiez que le diff affiche bien les champs attendus, puis lancez un test dans le navigateur.
Comportement et limites
- Les versions sont propres à chaque agent et couvrent tout ce qui se trouve sous Settings, Advanced, Tools, Outcomes et, pour les agents de type flow, Flow. Les modifications du widget peuvent apparaître sous Widget Config (configuration du widget). Les scénarios d’évaluation ne sont pas versionnés.
- La version Latest est celle qu’utilisent tous les canaux ; voir Publication.
- Les versions ne peuvent être ni supprimées ni renommées.