Passer au contenu principal

​
Vue d’ensemble

Une fois votre workflow créé, il est temps de l’exécuter. Ce guide couvre tout, du test manuel à la surveillance des exécutions en production.

​
Exécuter un workflow

​
Exécution manuelle

La façon la plus rapide de tester votre workflow :
  1. Cliquez sur le bouton App en haut à droite
  2. Un panneau s’ouvre avec le formulaire d’entrée de votre workflow
  3. Renseignez les champs requis
  4. Cliquez sur Generate

​
Modes d’exécution

ModeDescriptionCas d’usage
Run onceExécution uniqueTests, tâches ponctuelles
Run with inputsSaisie d’entrées personnaliséesTraitement de données spécifiques
ScheduledExécution automatiqueRapports réguliers, surveillance

​
Suivi de l’exécution

​
Progression en temps réel

Pendant l’exécution de votre workflow, vous pouvez voir :
  • Current node : Quel node est en cours d’exécution
  • Progress : Nombre de nodes terminés
  • Duration : Temps écoulé
  • Status : En cours, terminé ou en échec

​
Indicateurs de statut des nodes

CouleurStatut
🔵 BleuEn cours d’exécution
🟢 VertTerminé avec succès
🔴 RougeÉchec avec erreur
⚪ GrisPas encore exécuté

​
Consulter les sorties

Cliquez sur un node terminé pour voir :
  • Output data : Le résultat réel
  • Execution time : Durée d’exécution
  • Logs : Journaux d’exécution détaillés

​
Débogage des workflows

​
Problèmes courants

Cause : Le node précédent n’a pas renvoyé les données attendues.Solution :
  1. Vérifiez la sortie du node précédent
  2. Vérifiez que le chemin de variable est correct
  3. Ajoutez un node Conditional pour gérer les données manquantes
Cause : Problème du service externe ou configuration invalide.Solution :
  1. Vérifiez vos identifiants API
  2. Vérifiez l’URL de l’endpoint
  3. Testez l’API directement avec curl ou Postman
  4. Vérifiez les limites de débit
Cause : Trop d’éléments ou condition de boucle infinie.Solution :
  1. Ajoutez une limite maximale d’itérations
  2. Vérifiez la condition de sortie de boucle
  3. Traitez les données par lots
Cause : Le traitement prend trop de temps.Solution :
  1. Augmentez le timeout dans les paramètres du workflow
  2. Optimisez les nodes lents
  3. Exécutez les opérations lourdes en parallèle

​
Utiliser l’historique des exécutions

Accédez à l’historique complet de toutes les exécutions du workflow :
  1. Ouvrez votre workflow
  2. Cliquez sur l’onglet Run History
  3. Consultez toutes les exécutions passées avec leur statut, durée et sorties
Onglet Run History affichant les exécutions passées du workflow
Le tableau de l’historique affiche :
  • ID : Identifiant unique de chaque exécution
  • Created At : Date et heure d’exécution
  • Status : Done, Failed ou Running
  • Duration : Temps d’exécution total
  • Workflow Version : Version Draft ou Published utilisée
  • Steps : Cliquez sur l’icône œil pour voir le détail des étapes
  • Main Output : Accès rapide au résultat final

​
Consulter le détail des étapes

Cliquez sur l’icône Steps (👁) d’une exécution pour voir le détail de l’exécution de chaque node :
Panneau des étapes du workflow avec le détail d'exécution
Le panneau de détail des étapes affiche :
  • Workflow steps : Liste de tous les nodes exécutés avec les indicateurs de statut
  • Execution time : Durée pour chaque node
  • Compact mode : Basculer pour afficher ou masquer les détails
  • Render/Code view : Choisir entre sortie formatée et données brutes
  • Copy/Download : Exporter les données de sortie
Utilisez le Compact mode pour parcourir rapidement toutes les étapes, puis cliquez sur une étape pour afficher ses détails.

​
Débogage pas à pas

Pour les problèmes complexes :
  1. Isolez le problème : Désactivez les nodes après celui qui échoue
  2. Vérifiez les entrées : Assurez-vous que le node en échec reçoit les bonnes données
  3. Testez manuellement : Exécutez l’opération en dehors de Draft & Goal
  4. Vérifiez les connexions : Assurez-vous que les données circulent correctement
  5. Comparez les exécutions : Utilisez l’historique pour comparer les exécutions réussies et en échec

​
Débogage des AI Agents

Les nodes AI Agent nécessitent un débogage particulier car ils prennent des décisions de façon autonome. Draft & Goal propose une fonction Agent Trace pour comprendre précisément ce que fait votre agent.

​
Accéder aux Agent Traces

Dans la vue des étapes du workflow, les nodes AI Agent affichent une icône horloge (🕐) à côté de leur temps d’exécution. Cliquez sur cette icône pour ouvrir la vue de trace :
Bouton Agent trace dans les étapes du workflow

​
Comprendre les Agent Traces

Le panneau Agent Trace affiche l’intégralité de la conversation entre l’IA et ses outils :
Détail de l'Agent trace avec l'historique de conversation
La trace contient :
Type de messageDescription
SystemLes instructions initiales données à l’agent
HumanLa tâche ou le prompt envoyé par votre workflow
AILe raisonnement de l’agent et ses appels aux outils
ToolRésultats renvoyés par les outils utilisés par l’agent
Basculez entre la vue Conversation pour un format lisible et Raw JSON pour les données techniques complètes.

​
Scénarios courants de débogage d’agents

À vérifier : Relisez le message System — les instructions sont-elles claires ?Solution : Affinez le prompt de l’agent pour préciser quand utiliser chaque outil.
À vérifier : Repérez les appels d’outils répétés avec les mêmes paramètres.Solution : Ajoutez des critères de succès plus clairs ou une limite d’itérations maximale dans votre prompt.
À vérifier : Examinez les réponses Tool — ont-elles renvoyé les données attendues ?Solution : Vérifiez la configuration des outils et testez-les indépendamment.

​
Gestion des erreurs

​
Gestion des erreurs intégrée

Configurez la façon dont votre node gère les échecs : Paramètres du workflow → Error Handling
OptionComportement
Stop on errorArrêter le workflow immédiatement
Continue on errorIgnorer le node en échec, continuer
RetryRéessayer le node en échec

​
Utiliser le node Fail

Gérez proprement les erreurs attendues :
  1. Ajoutez un node Conditional pour détecter les problèmes
  2. Redirigez vers un node Fail avec un message clair
  3. Le workflow s’arrête avec votre message d’erreur personnalisé
Si {{response.status}} != 200
  → Fail: "API returned error: {{response.error}}"

​
Optimisation des performances

​
Identifier les goulots d’étranglement

Après exécution, consultez les temps d’exécution :
  1. Regardez la durée de chaque node
  2. Repérez les nodes les plus lents
  3. Optimisez-les ou parallélisez-les

​
Exécution en parallèle

Exécutez les opérations indépendantes en même temps : 
        ┌→ Scrape Site A →┐
Input →│                   │→ Merge → Output
        └→ Scrape Site B →┘
Au lieu de : 
Input → Scrape Site A → Scrape Site B → Output

​
Stratégies de cache

Réduisez les appels API redondants :
  • Utilisez Google Sheets comme couche de cache
  • Vérifiez si les données existent avant de les récupérer
  • Définissez des TTL de cache adaptés

​
Traitement par lots

Traitez efficacement les grands volumes de données :
  1. Utilisez le node Loop avec les paramètres de lot
  2. Définissez des tailles de lot raisonnables (10 à 50 éléments)
  3. Ajoutez des délais entre les lots pour respecter les limites de débit

​
Historique d’exécution

​
Consulter les exécutions passées

Accédez à l’historique d’exécution :
  1. Allez dans Workflows dans le menu principal
  2. Cliquez sur votre workflow
  3. Sélectionnez l’onglet Runs
Vous voyez :
  • Date et heure d’exécution
  • Durée
  • Statut (succès/échec)
  • Valeurs d’entrée utilisées

​
Réexécuter des workflows

Pour répéter une exécution précédente :
  1. Trouvez l’exécution dans l’historique
  2. Cliquez sur Run again
  3. Modifiez éventuellement les entrées
  4. Lancez l’exécution

​
Exporter les résultats

Téléchargez les données d’exécution :
  1. Cliquez sur une exécution terminée
  2. Sélectionnez Export
  3. Choisissez le format (JSON, CSV)

​
Exécution planifiée

​
Configurer les planifications

Exécutez les workflows automatiquement :
  1. Ouvrez les paramètres du workflow
  2. Allez dans Schedule
  3. Choisissez la fréquence :
PlanificationExemple
HourlyToutes les heures à :00
DailyTous les jours à 9h00
WeeklyTous les lundis à 8h00
CustomExpression cron

​
Expressions cron

Pour une planification avancée : 
┌───────────── minute (0-59)
│ ┌───────────── heure (0-23)
│ │ ┌───────────── jour du mois (1-31)
│ │ │ ┌───────────── mois (1-12)
│ │ │ │ ┌───────────── jour de la semaine (0-6)
│ │ │ │ │
* * * * *
Exemples :
  • 0 9 * * 1 — Tous les lundis à 9h00
  • 0 */6 * * * — Toutes les 6 heures
  • 30 8 1 * * — Le 1er de chaque mois à 8h30

​
Suivi des exécutions planifiées

Vérifiez le statut des exécutions planifiées :
  1. Consultez les prochaines exécutions dans l’onglet Schedule
  2. Recevez des notifications en cas d’échec
  3. Consultez l’historique d’exécution

​
Étapes suivantes

Teams

Collaborez avec votre équipe

API Reference

Déclencher les workflows via l’API