Revue, finalisation et édition de documents

Revue, finalisation et édition de documents

Procédure complète pour inspecter, modifier, finaliser, dupliquer ou supprimer les documents générés

Gérez vos GenerationLogs : ouvrir le dialogue de document, vérifier le contenu et le prompt, marquer la revue, finaliser et appliquer des actions (édition légère, duplication, suppression, export et envoi).

Ce que couvre cette page

Ouvrir et revoir

Accéder au document généré depuis la liste, inspecter le titre, le contenu rendu, le statut, le Step ID et le Batch UUID.

Finaliser la revue

Sauvegarder les modifications et marquer un document comme revu via le bouton “Finalize Review” — met à jour le statut et l’information de relecteur.

Édition légère

Modifier rapidement le texte (éditeur WYSIWYG) : undo/redo, styles, listes, citations puis enregistrer.

Dupliquer & Supprimer

Créer une copie d’un document pour itération ou supprimer définitivement si non utile.

Voir le prompt utilisé

Afficher le prompt qui a servi à générer le document pour audit ou réutilisation.

Exporter et envoyer

Exporter en Markdown/JSON ou envoyer vers une destination externe (webhook / email), avec suivi d’état et messages d’erreur.

Astuce : Vérifiez les métadonnées

Avant de finaliser, regardez le Step ID, batch_uuid et l’agent associé : ces métadonnées permettent de retrouver le contexte (ex. trigger, hook, lot de génération).

Astuce : Sauvegarder avant de finaliser

Si vous avez modifié le titre ou le contenu, cliquez d’abord sur “Save” pour enregistrer le draft local, puis utilisez “Finalize Review” pour marquer la revue. Cela évite de perdre vos modifications.

Attention : permissions et coûts externes

La possibilité de voir le prompt complet et d’envoyer/exporter peut dépendre de vos permissions. Envoyer un document à des destinations externes ou déclencher une régénération via un service externe peut consommer des crédits ou appeler des services hors plateforme.

Introduction

Cette page décrit pas à pas comment examiner un GenerationLog depuis la liste de documents, ouvrir le dialogue de document, inspecter le contenu et le prompt, effectuer des modifications légères, finaliser la revue (marquage review), dupliquer ou supprimer le document, et comment exporter ou envoyer le document. Les sections ci‑dessous détaillent chaque workflow avec précautions, erreurs communes et bonnes pratiques.

Workflow principal : Ouvrir le dialogue et inspecter un document

1

1 — Naviguer vers la liste des documents

Ouvrez l’onglet “Generated documents” du projet. Vous verrez la table listant les documents générés avec date, agent, titre et actions.

2

2 — Ouvrir le document pour revue

Cliquez sur “Review” (ou “See” si déjà revu) dans la colonne Actions. Le DialogDocument s’ouvre : en-tête, métadonnées, éditeur et menu d’actions.

3

3 — Vérifier les métadonnées

Dans l’en-tête du dialogue, consultez :

  • Step ID / Commit ID (contexte de génération)
  • Batch UUID (si présent, lien pour filtrer la liste par lot)
  • Content type, statut, date de création
  • Information de review (utilisateur et date) si déjà revu.
4

4 — Lire et scanner le contenu généré

Parcourez l’éditeur WYSIWYG : texte, sections, listes, extraits de code. Utilisez undo/redo et la bulle d’outils pour vérifier la structure.

5

5 — Voir le prompt utilisé

Si vous avez la permission, cliquez sur “Voir le prompt” (ou “View prompt”). Une fenêtre s’ouvrira affichant le prompt d’entrée utilisé pour générer ce document.

6

6 — Décider de l'action

Choisissez : sauvegarder les modifications, finaliser la revue, dupliquer, supprimer, exporter ou envoyer à une destination externe.

Finaliser une revue (Save & Finalize) — procédure détaillée

1

1 — Préparer le document

Relisez le document et apportez les corrections légères nécessaires (titre, contenu). Vérifiez les métadonnées et le batch si pertinent.

2

2 — Sauvegarder les modifications (recommandé)

Si vous avez modifié le titre ou le contenu, cliquez sur “Save”. Le draft est enregistré et les indicateurs de modification sont réinitialisés.

3

3 — Finaliser la revue

Si le document n’est pas encore revu, cliquez sur “Finalize Review”. Cette action :

  • Enregistre l’état courant (si vous n’avez pas cliqué Save, elle peut sauvegarder automatiquement)
  • Marque le document comme revu et met à jour l’info “Reviewed by” et la date
  • Met à jour le statut affiché dans la liste.
4

4 — Vérifier le statut

Après finalisation, fermez le dialogue ou retournez à la liste pour confirmer le changement de statut et les métadonnées de review.

5

5 — Notification et actions automatiques

Notez que selon la configuration du projet, la finalisation peut déclencher des notifications, des envois ou d’autres workflows externes. Vérifiez si des appels externes sont attendus.

Édition légère dans le dialogue (WYSIWYG) — étapes pratiques

1

1 — Utiliser les outils visibles

La bulle d’outil propose : paragraphes, blockquote, listes à puces et ordonnées, code block, titres H1–H6, gras/italique/strike. Utilisez undo/redo si besoin.

2

2 — Transformer le contenu

Appliquez formats et sections pour clarifier la structure (titres, sous-titres, listes). Préférez petites passes : structure → relecture → corrections lexicales.

3

3 — Prévisualiser avant sauvegarde

Relisez l’affichage final dans l’éditeur. Si vous exportez en Markdown, l’export convertira le rendu WYSIWYG en markdown pour téléchargement.

4

4 — Sauvegarder

Cliquez “Save” pour appliquer vos modifications sans finaliser la revue. Le statut reste inchangé (draft/review/published selon l’état).

5

5 — Éviter les pertes

Si vous fermez le dialogue avec des modifications non sauvegardées, la plateforme demandera une confirmation — répondez prudemment pour éviter de perdre votre travail.

Dupliquer et supprimer un document — actions sûres

1

1 — Dupliquer (créer une copie)

Dans le menu “Plus”, choisissez “Dupliquer”. Le système crée une copie du document (nouvel ID). Le dialogue se ferme généralement et la liste se recharge.

  • Utilisez la duplication pour tester variantes sans altérer l’original.
2

2 — Vérifier la copie

Recherchez la nouvelle entrée dans la liste (type / date / titre modifié si applicable) et ouvrez-la pour modifier indépendamment.

3

3 — Supprimer un document

Pour supprimer, utilisez “Supprimer” dans le menu. Confirmez l’action lorsque la plateforme le demande. La suppression est irréversible depuis l’interface normale.

4

4 — Conséquences de la suppression

Après suppression, la liste se met à jour et le dialogue se ferme. Assurez-vous qu’aucune action dépendante (webhook, publication automatique) ne nécessite ce document.

Voir le prompt, exporter et envoyer — actions complémentaires

1

1 — Voir le prompt

Cliquez “Voir le prompt”. Une fenêtre distincte affiche le prompt d’entrée. Si vous ne voyez pas le prompt, il se peut que vos permissions soient limitées.

2

2 — Exporter en Markdown ou JSON

Dans le menu, choisissez “Exporter en Markdown” ou “Exporter en JSON”. Le fichier est généré et un téléchargement démarre automatiquement.

  • Markdown : utile pour sites statiques, CMS, révisions.
  • JSON : contient les métadonnées complètes du document.
3

3 — Envoyer vers une destination

Sélectionnez une destination (webhook, email, etc.) dans la liste déroulante, puis cliquez “Send”. Confirmations et messages d’erreur s’affichent selon la réussite.

4

4 — Gérer les erreurs d'envoi

Si l’envoi échoue, le message retourné par la destination (ou la plateforme) s’affiche. Vérifiez la configuration de la destination (auth, URL, headers) et réessayez.

5

5 — Attention aux coûts

Envoyer un document ou demander une régénération via un service externe peut déclencher appels et consommation de crédits. Vérifiez vos quotas avant d’envoyer massivement.

  • Peut voir le prompt complet.
  • Peut modifier le contenu, sauvegarder, finaliser, dupliquer et supprimer.
  • Peut envoyer vers des destinations externes et exporter en Markdown/JSON.
  • Peut ouvrir et lire le document mais le bouton “Finalize Review” ou “Save” peut être désactivé.
  • Peut ne pas voir le prompt complet ni envoyer vers destinations externes.
  • Doit solliciter un relecteur (owner/editor) pour finaliser ou dupliquer.

Avant : Document en draft

  • Statut : draft
  • Peut être modifié librement
  • Pas d’information “Reviewed by”
  • Idéal pour itérations rapides

Après : Document finalisé / review

  • Statut : review (ou publié selon workflow)
  • Champs “Reviewed by” et date renseignés
  • Peut déclencher livraisons/notifications externes

Bonne pratique : travaillez par petites itérations

Corrigez par passes courtes (structure → contenu → style) et utilisez la duplication pour tester variations sans risquer l’original.

Attention : modifications concurrentes

Si plusieurs personnes ouvrent le même document en même temps, coordonnez-vous : la dernière sauvegarde écrase les précédentes. Prévenez sur qui finalise et quand.

Frequently Asked Questions

Conseil pour audits et traçabilité

Conservez le Batch UUID et le Step ID lors de vos finalisations : ils facilitent le traçage de pourquoi et comment un document a été généré (utile pour repro du contenu, audits et debugging).

Finissez toujours par une vérification rapide : la métadonnée review est renseignée, le contenu sauvegardé, et s’il faut publier ou envoyer, confirmez la destination et les implications (permissions / crédits). Si vous avez des questions sur des cas précis (ex. logique de publication automatique, destination particulière), contactez l’administrateur du projet.