---
title: "Historique et reprise"
url: https://developers.dagio.ai/fr/history/
---

# Historique et reprise

   
                              
                                                                                  
               
             
          
   

## Examiner les modifications

Les révisions permettent de retrouver le contenu et le contexte d’une modification. Avant de restaurer, comparez la version choisie à la version courante. Restaurer un texte ne doit pas effacer silencieusement les modifications plus récentes d’un autre membre.

| Information | Valeur attendue | Utilité |
| --- | --- | --- |
| Objet | Identité de la Surface ou du travail | Vérifier le périmètre |
| Révision | Version précise | Comparer les contenus |
| Origine | Usager, AI ou opération identifiée | Comprendre la modification |
| Résultat | Réception, refus ou conflit | Décider de la prochaine action |

## Reprendre après une interruption

Le brouillon local, la version enregistrée et le texte AI en cours sont distincts. Après une interruption, retrouvez la dernière version confirmée et vérifiez l’état de l’opération. Quand la réponse d’une Action est incertaine, consultez son résultat avant de relancer.

Si la restauration est confirmée mais que la réouverture échoue, reprenez l’ouverture de la Surface
sans la restaurer une nouvelle fois. L’ouverture vérifie toujours vos accès courants. Si la réponse
à la restauration reste inconnue, reprenez la même demande en attente plutôt que de confirmer une
nouvelle restauration.

Les références historiques retenues indiquent les versions de sources utilisées, sans recopier leur contenu ni accorder de nouveaux accès. Consultez leurs détails et parcourez les sources par pages. Changer la langue ne change ni la sélection ni la page. L’export, lorsqu’il est proposé, conserve ces mêmes références; il ne déclenche aucune nouvelle exécution.

## Examiner les références d’origine d’un Work

Sélectionnez la révision historique exacte avant de consulter ses captures de références. Surface
découvre uniquement les familles de captures réellement conservées sur cette révision. Si aucune
n’est disponible, aucune capture n’est reconstruite à partir du Model ou de la Query actuels. Si
des captures ordinaires et Work coexistent, choisissez explicitement la famille, sans les fusionner
ni essayer l’une après l’autre.

Pour un client MCP, `surface_reference_capture_history_discover` retourne ces métadonnées de
famille sans lire les corps des sources, les politiques ou le manifeste d’une capture. La famille
Work utilise `surface_work_reference_capture_list` et `surface_work_reference_capture_get` ;
une capture ordinaire n’est pas réétiquetée comme capture Work. Ces lectures exigent
`surface:read` et les autorisations courantes, dont la divulgation à l’AI lorsqu’elle est demandée.

Le Work d’origine, son étape et le programme de sa politique restent distincts de l’application
courante. Lire une capture retenue vérifie les accès actuels à ses sources ; son certificat
historique ne donne aucun droit supplémentaire. Les [exports documentaires](https://developers.dagio.ai/fr/documents/)
gardent la même capture sélectionnée et ses références d’origine, sans réexécuter le Work ni les
remplacer par les versions courantes.

## Exemple

Vous avez complété les contraintes d’Atelier Nord pendant que l’AI préparait une reformulation. Votre texte reste présent. Examinez la proposition et les différences avant de l’appliquer à la section. Si le tarif de référence a changé entre-temps, le travail signale ce contexte à revoir.

L’historique explique les changements; il ne remplace ni les droits de modification ni la validation d’un résultat. Pour les mises à jour en temps réel, consultez [synchronisation et collaboration](https://developers.dagio.ai/fr/collaboration/).

<!-- surface-examples:start -->

## Exemples appliqués : Conserver la référence et revoir l’impact

Une soumission garde la référence retenue, puis signale les changements qui nécessitent une revue.

### Configuration

Fragment à placer dans `changePolicies[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-model-foundation/).

```json
{
  "key": "retained-pricing",
  "sourceDefinitionPaths": [
    "workspace/knowledge/surface/pricing"
  ],
  "linkTypePaths": [
    "application/based-on"
  ],
  "mode": "pin-revision",
  "actionKey": null,
  "queryKey": null,
  "maximumTargets": 50
}
```

### Variante et raccordement

Fragment à placer dans `changePolicies[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-model-foundation/).

```json
{
  "key": "pricing-review",
  "sourceDefinitionPaths": [
    "workspace/knowledge/surface/pricing"
  ],
  "linkTypePaths": [
    "application/based-on"
  ],
  "mode": "mark-needs-review",
  "actionKey": null,
  "queryKey": "affected-quotes",
  "maximumTargets": 50
}
```

### Exemple de disposition UI

La disposition illustrative ci-dessous situe cette configuration dans l’app Clients/Soumissions. Chaque fragment s’insère à l’emplacement indiqué; ses références aux Fields, Queries et Actions correspondent aux déclarations du Model.

1. Objet concerné
2. Changement proposé
3. Vérifications
4. Confirmer

<!-- surface-examples:end -->