Le round-trip IA et humain dans Decktype : comment ça marche vraiment

Le round-trip de Decktype est conçu pour séparer les contenus remplis par un agent et les retouches manuelles dans un même fichier .deck.

Le problème visé

La plupart des générateurs de présentations IA fonctionnent de cette façon :

1. Vous donnez un brief.
2. L’IA génère tout le deck.
3. Vous voulez changer un titre, déplacer un bloc ou corriger un chiffre → vous devez soit redemander à l’IA, soit tout refaire à la main.

Résultat : soit vous perdez du temps, soit vous perdez le contrôle de la qualité.

Decktype résout ce problème grâce à une architecture en deux couches bien séparées.

Les deux couches du round-trip

1. La couche Slots (gérée par l’IA)

L’agent ne touche jamais au layout final. Il remplit uniquement des slots définis dans le template :

• Titre
• Liste de cartes
• Données d’un graphique
• Citation
• etc.

2. La couche Overrides (gérée par l’humain)

Quand vous ouvrez le deck dans l’application Decktype et que vous :

• déplacez un élément,
• changez un texte,
• modifiez une couleur,
• supprimez quelque chose,

Decktype enregistre ces modifications sous forme d’overrides liées à des clés stables.

Comment ça marche techniquement (étape par étape)

1. L’agent écrit dans template.slots (dans le fichier deck.json).
2. Vous ouvrez le .deck → Decktype matérialise les éléments à partir des slots + du template.
3. Vous faites des retouches dans l’éditeur → Decktype enregistre les overrides (template.overrides).
4. Vous demandez à l’agent de régénérer ou mettre à jour → deck regenerate.
5. Decktype réapplique les overrides après la nouvelle matérialisation.

Les overrides dont la clé stable existe encore sont réappliquées. Si une régénération supprime ou renomme une clé, l’ancienne override devient inactive au lieu d’être appliquée au mauvais élément.

Le rôle des clés stables (ElementId + template_key)

Chaque élément issu d’un template possède une clé stable. Même si l’IA régénère complètement la slide, Decktype sait exactement :

• Quel override correspond à quel slot.
• Quelles modifications humaines doivent être réappliquées.

C’est ce mécanisme qui rend le round-trip fiable.

Bonnes pratiques concrètes

• Ne touchez jamais directement aux elements d’une slide liée dans le JSON.
• Utilisez l’application pour toutes les retouches manuelles.
• Relancez deck regenerate mon-deck.deck après un patch par l’agent.
• Vérifiez avec deck render mon-deck.deck --out preview/, puis relisez les PNG avant livraison.
• Pour les données chiffrées : préférez les slots donnees plutôt que du texte brut.

Exemples concrets de round-trip

Exemple 1 : si la clé stable du titre ne change pas, vous pouvez le raccourcir puis faire réappliquer cette retouche après la mise à jour des autres slots.

Exemple 2 : si la structure et les clés des cartes restent compatibles, les retouches manuelles peuvent être réappliquées après régénération.

Exemple 3 : certaines propriétés prises en charge d’un graphique peuvent rester surchargées pendant que les données du slot changent. Vérifiez le rendu régénéré avant livraison.

Exemple de slide générée montrant un processus (idéal pour visualiser le workflow round-trip)

Ce que le round-trip rend possible

• Une frontière claire entre les entrées de l’agent et vos décisions manuelles.
• Des itérations répétables sans reconstruire chaque slide depuis zéro.
• Un fichier local et un aperçu rendu à relire avant livraison.
• La conservation de votre voix et de votre jugement dans les overrides compatibles.

C’est exactement pour ça que le format .deck a été conçu.

---

Testez le round-trip dès maintenant

Téléchargez Decktype et essayez le cycle complet : génération → retouche → régénération → rendu.

FAQ – Round-trip

Est-ce que les overrides survivent à un export .pptx ?
Les overrides sont dans le .deck. L’export .pptx est une représentation figée. Si vous réimportez le .pptx, vous repartez d’une version "libre" (sans template lié).

Que se passe-t-il si l’IA change complètement la structure du template ?
Les overrides dont les clés n’existent plus ne sont pas réappliquées. Le fichier reste exploitable, mais vérifiez le rendu : l’intention visuelle peut demander une nouvelle retouche.

Puis-je voir toutes mes overrides ?
Oui. Utilisez deck inspect mon-deck.deck --json ou ouvrez le fichier deck.json à l’intérieur du bundle.

Est-ce que ça marche aussi avec les graphiques ?
Les propriétés de graphique prises en charge peuvent être surchargées et réappliquées tant que leurs clés restent compatibles. Vérifiez le résultat avec deck render.

Est-ce que le round-trip fonctionne si je modifie le deck hors de l’application ?
Une modification directe du JSON demande de respecter le schéma et les clés du template, puis de lancer deck regenerate. Pour les retouches visuelles, l’application reste le chemin recommandé.