---
title: Versions
description: >-
  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.

![Le journal des versions, de la plus récente à la plus ancienne, avec les champs modifiés sur chaque entrée.](/media/test-and-improve/version-ledger.webp)

## 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.

<video src="/media/test-and-improve/version-diff.mp4" autoplay loop muted playsinline></video>

*Ouverture d'une version et comparaison avec la précédente.*

## 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é.

![Rollback to this version et Undo this change sur une version plus ancienne.](/media/test-and-improve/version-rollback.webp)

1. **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.

2. **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.

3. **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](/fr/test-and-improve/testing-in-the-browser).

## 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](/fr/test-and-improve/publishing).
- Les versions ne peuvent être ni supprimées ni renommées.

## Voir aussi

- [Publication](/fr/test-and-improve/publishing)
- [Checklist de lancement](/fr/test-and-improve/launch-checklist)
- [Anatomie d'un agent](/fr/build/anatomy-of-an-agent)
- [Concepts clés](/fr/get-started/core-concepts)