Flux de génération, revue & publication
Ce que vous allez apprendre
Sur cette page vous apprendrez à : consulter les GenerationLogs d’un projet, ouvrir et relire un contenu généré, voir le prompt et les métadonnées (commit, agent, execution_frequency, input_prompt), exporter un document en Markdown ou JSON, dupliquer/supprimer un log, et publier un document vers une destination configurée (webhook, email, Notion, …). Page 5 sur 11.
Aperçu rapide
Lister & filtrer
Ouvrez l’onglet “Changelogs” pour lister les GenerationLogs par projet. Filtrez par agent, branche ou auteur.
Relire & finaliser
Ouvrez un log pour relire dans DialogDocument, marquez le document en “review” ou cliquez sur “Finalize review”.
Exporter & publier
Export Markdown / Export JSON, ou envoyez directement le document vers une Destination (webhook, email, Notion…).
Voir prompt & métadonnées
Accédez au prompt utilisé et aux champs stockés : input_prompt, execution_frequency, commit, agent et agent_hook_id.
Gérer destinations
Créez des destinations (endpoint, méthode, headers, auth, signing, retries) et associez-les à des AgentHooks.
Actions sur logs
Dupliquez un log pour nouveaux tests, ou supprimez un log (confirmation requise).
Parcours pas à pas : consulter, relire, exporter et publier
1 — Ouvrir la liste des changelogs
Dans le menu du projet, cliquez sur l’onglet “Changelogs”. Utilisez les filtres (Agent, Branche, Auteur) pour réduire la liste. Cliquez sur un log pour ouvrir le DialogDocument contenant le contenu généré.
2 — Vérifier le contenu et les métadonnées
Dans DialogDocument : lisez le contenu principal, puis ouvrez la section “Métadonnées” pour voir :
- Prompt utilisé (champ input_prompt).
- execution_frequency (ex. “daily”, “on_push”).
- Commit et agent qui ont déclenché la génération.
- agent_hook_id (si lié à un AgentHook) — lien cliquable vers le hook.
3 — Finaliser la revue
Si le contenu est prêt, cliquez sur “Finalize review”. Le statut du GenerationLog passe à finalisé et la version est marquée comme prête pour publication.
4 — Exporter le document
Dans DialogDocument, cliquez sur “Export Markdown” pour télécharger un .md ou sur “Export JSON” pour obtenir le fichier machine-readable. Le fichier contient le contenu principal et les métadonnées (commit, input_prompt, execution_frequency).
5 — Dupliquer ou supprimer
Utilisez “Duplicate” pour cloner le log (utile pour tests ou modifications sans perdre l’original). Pour supprimer, cliquez sur “Delete” — la suppression demande une confirmation pour éviter les pertes accidentelles.
6 — Publier (envoyer) vers une destination
Dans DialogDocument : cliquez sur “Send”, choisissez la Destination (webhook, email, Notion, etc.), puis “Send” à nouveau. Vous recevrez une notification de succès ou d’erreur. Les résultats d’envoi sont enregistrés dans les logs de destinations.
Astuce pratique
Avant d’envoyer à une destination externe, testez d’abord avec “Preview documents” ou envoyez à un webhook de test. Utilisez la fonction “Duplicate” pour créer une version de test sans modifier le log original.
Créer et associer une destination (webhook, email, Notion) — actions réelles
1 — Ouvrir le gestionnaire de Destinations
Allez dans “Destinations” > “Nouveau”. Renseignez l’URL, la méthode (POST/PUT), les headers et les options d’authentification.
2 — Configurer signature & retries
Activez la signature si besoin (HMAC) et configurez les tentatives (retries) et le backoff (ex. 3 tentatives, backoff exponentiel).
3 — Sauvegarder et associer
Sauvegardez la destination. Pour lier la destination à un AgentHook, éditez le hook et sélectionnez la destination dans la liste déroulante (ou associez-la lors de la création du hook).
4 — Envoi manuel depuis un GenerationLog
Depuis DialogDocument, cliquez “Send”, choisissez la destination créée, confirmez. Surveillez le statut dans les logs de destination pour vérifier succès ou échec.
Erreurs fréquentes à éviter
- Oublier d’indiquer les headers d’authentification (API keys / tokens) ; l’envoi échouera avec 401/403.
- Ne pas tester la destination avec un webhook de test : risque d’envoyer des données incomplètes.
- Supprimer un log sans sauvegarder une copie : la suppression est irréversible via l’UI.
- Pour Notion, vérifiez que le token a les permissions nécessaires (pages/databases).
Récapitulatif des actions rapides
- Ouvrir Changelogs → Filtrer → Cliquer sur un log
- Voir input_prompt et execution_frequency dans les métadonnées
- Finalize review → statut mis à jour
- Export Markdown / Export JSON → téléchargement
- Duplicate / Delete → cloner ou supprimer un log
- Send → Choisir Destination → vérifier logs de livraison
Champs importants (explication)
- input_prompt : texte exact du prompt utilisé pour générer le document.
- execution_frequency : fréquence ou déclencheur enregistré (ex. “manual”, “on_push”, “daily”).
- commit : identifiant du commit lié à la génération.
- agent : nom de l’agent qui a exécuté la génération.
- agent_hook_id : lien (nullable) vers l’AgentHook qui a déclenché l’exécution.
Exemples
- input_prompt: “Résume les changements du commit et propose un titre.”
- execution_frequency: “on_push”
- commit: “a1b2c3d”
- agent: “release-notes-agent”
- agent_hook_id: “hook_042” → cliquez pour ouvrir le hook associé.
Bonnes pratiques
- Conservez le input_prompt pour traçabilité : il vous permet de reproduire ou retravailler une génération.
- Activez retries & backoff pour webhooks externes instables.
- Utilisez des destinations distinctes pour tests et production.
Prêt à publier ?
Si vous n’avez pas encore configuré de destination, passez à la page suivante pour apprendre à créer des webhooks, configurer l’authentification et associer des destinations à vos hooks.
Questions fréquentes
Next steps
- Si vous n’avez pas encore configuré de destinations : allez à “Destinations, webhooks & intégrations” (page suivante).
- Si vous souhaitez automatiser les envois : consultez “Agents d’automatisation & Hooks” pour associer des destinations à des AgentHooks.
- Pour sécuriser vos envois : lisez la page “Diagnostics, tokens & dépannage” pour gérer clés, signatures et logs.